Prompt Management

The Prompt Management UI lets you view, edit, version, and deploy the system prompts used by AEGIS AI agents. You can find it under Configuration > Prompts in the sidebar.

Navigating Prompts

Namespace List

The main Prompts page shows all prompt namespaces you have access to. Each namespace groups related prompt templates:

Click a namespace to see its templates, settings, budget tiers, and access control.

Namespace Detail

The namespace detail page has four tabs:

• Templates — List of prompt templates in this namespace. Click to open a template.
• Settings — Auto-approve toggle, approver list, data classification, render timeout.
• Budget Tiers — Token limits for different prompt categories (e.g., system prompts = 4,000 tokens max).
• Access Control — Who can view, author, approve, or admin this namespace.

Working with Templates

Template Detail

Each template shows:

• Active Version Preview — The currently deployed prompt in a read-only monospace view.
• Draft Banner — If you have an in-progress draft, a banner appears with Edit and Discard buttons.
• Version Sidebar — A list of all versions (your draft, pre-prod, active, and archived) with quick actions.

Creating a Draft

Click New Draft to start editing. If the template has an active version, your draft is pre-populated with its content.

The Version Editor

The editor is a split-pane view:

• Left (70%) — Full-height monospace text area for your Jinja2 template. Press Cmd+S (Mac) or Ctrl+S (Windows) to save.
• Right (30%) — Live validation panel that updates on each save:
  • Syntax — Checks Jinja2 template syntax
  • Restricted Subset — Ensures you only use allowed Jinja2 constructs (no macros, imports, or set statements)
  • Injection Scan — Detects patterns that could indicate prompt injection
  • Token Estimate — Shows estimated token count vs. budget tier limit with a color-coded progress bar
  • Variables — Lists all variables detected in your template

The Promote to Pre-prod button is disabled until validation passes.

Version Lifecycle

Promoting to Pre-production

When your draft is valid, click Promote to Pre-prod. You can optionally specify target users who will see this version instead of the active version during testing.

If another user already has a pre-production version, you will see a conflict resolution dialog with three options:

1. Override — Archives the other user’s pre-prod and promotes yours
2. Merge & Promote — Edit a merged version in the center pane, then promote the result
3. Cancel — Keep your draft unchanged

Promoting to Active

Pre-production versions can be promoted to active:

• If the namespace has auto-approve enabled, activation is immediate.
• If not, an approver must review and approve the version first.

Approvals

Navigate to Configuration > Approvals to see pending prompt version approvals across all namespaces you can approve.

For each pending version, you can:

• Review — View the full prompt body
• Approve — Activate the version
• Reject — Reject with a reason (the version stays in pre-production for the author to revise)

Restoring Archived Versions

In the template detail’s version sidebar, archived versions have a Restore button. Restoring follows the same approval flow as a new promotion.

Version History & Comparison

History

Click Version History on any template to see all versions in chronological order. You can:

• Filter by status (draft, pre-prod, active, archived)
• Select 2-3 versions with checkboxes
• Click Compare to view them side-by-side

Comparison

The comparison view shows versions in columns with:

• Version number, status badge, author, date, token count
• Side-by-side prompt bodies with diff highlighting (green = new lines)

Share the URL — version selections are preserved in the ?v= parameter.