Before you start

Prompt Library

The Prompt Library is where you author and manage reusable prompt templates for your platform. Each template is tied to a role, can include fill-in-the-blank placeholders, and is marked as either a system prompt or a user prompt. From here you create, edit, preview, and delete templates, and jump straight to a prompt’s effectiveness analytics.

Grengin prompt library

This page is the central catalog of role prompts. Assigning prompts to specific departments happens elsewhere (see Related).

Before you start

To open and use the Prompt Library, you need the View Roles permission. With it, you can view the catalog and create, edit, and delete prompts.

Find it in Control Hub under Configure → Prompt Library. If you don’t have the permission, the page and its sidebar entry are hidden.

There’s no separate edit-only or delete-only permission in the interface: anyone who can open the page sees all the controls. Behind the scenes, the platform still checks your authorization when you actually save or delete, so some actions may be declined even if the buttons are visible.

This catalog is organization-wide. There’s no department picker on this page.

Finding a prompt

When you open the page you’ll see a table of every role prompt, with columns for Name (and a short preview of the text), the Role it’s tied to, its Type, its Variables, a clickable Usage count, and the last Updated date.

Use the filters bar above the table to narrow things down:

  • Search — type to match by prompt name or prompt text (case-insensitive).
  • Role — show prompts for a single role, or choose All roles to clear it.
  • Type — show All, only System prompts, or only User prompts.

When any filter is active, a Clear filters button appears to reset everything at once.

If no prompts match your filters, you’ll see a “no matches” message. If there are no prompts at all yet, you’ll see an empty state with a button to create your first one. A result count sits at the bottom of the table.

Creating a prompt

Grengin add new prompt
  1. Click Create Prompt in the top right.
  2. In the form, enter a Name. This is required.
  3. Choose a Role to bind the prompt to. This is required and defaults to the first role in the list.
  4. Write the template body in Prompt text. This is required. As you type, any {{placeholder}} tokens are detected automatically and shown as chips beneath the field.
  5. Optionally declare your Variables: type a name and press Enter or click Add. Each chip can be removed individually. Duplicate names are rejected with an inline error.
  6. Turn on System prompt if this should be treated as a system prompt. Leave it off for a regular user prompt.
  7. Click Create to save. The button shows Creating… while it works, then the prompt appears in the table.

You can close the form at any time with Cancel.

Editing a prompt

Grengin edit prompt
  1. Find the prompt in the table and click its Edit action.
  2. The form opens prefilled with the current values.
  3. Make your changes and click Save (it shows Saving… while in progress).

Previewing a prompt

Preview lets you see exactly how a template renders with real values filled in.

Grengin preview prompt
  1. Click the Preview (eye) action on a prompt’s row.
  2. The read-only preview shows the prompt’s Name and Type.
  3. If the prompt has declared variables, a Sample values section gives you a text box for each one. Type sample values and watch them substitute into the Rendered output panel. Any placeholder you leave blank stays as its {{token}} in the output.
  4. Click Copy to copy the rendered text to your clipboard. The button briefly confirms with Copied!

Deleting a prompt

  1. Click the Delete (trash) action on the prompt’s row.
  2. A confirmation dialog appears showing the prompt name and a warning.
  3. Click Delete to confirm (it shows Deleting… while in progress), or Cancel to keep the prompt.

Viewing a prompt’s effectiveness

Each row’s Usage count is a link. Click it to jump straight to that prompt’s analytics on the Prompt Effectiveness page.

Grengin prompt effectiveness

Note that Prompt Effectiveness may not appear in your sidebar unless you also have the View Analytics permission, but you can still reach a specific prompt’s analytics through this usage link.

Good to know

  • Placeholders aren’t declared automatically. Detected {{placeholder}} chips under the prompt text are for your reference only. To make a variable available for sample values in Preview, add it explicitly in the Variables list. You can save a template that uses {{x}} without declaring x.
  • Preview only fills in declared variables. A placeholder that appears in the text but isn’t in the Variables list won’t get a sample input and will stay literal in the rendered output. Declare every placeholder you want to test.
  • Filtering is instant. All prompts load at once and filtering happens immediately as you type or choose, so there’s no waiting between filter changes.
  • Loading and empty states. You’ll see a brief spinner while prompts load, a “no prompts yet” state with a create button when the catalog is empty, and a “no matches” message when filters exclude everything.
  • Errors surface as notifications. If a load, save, or delete fails, you’ll see an error notification rather than a silent failure.
  • This is the catalog only. Assigning prompts to particular departments is a separate task handled outside this page.