Global Prompts

The Configuration screen contains tabs where administrators can define prompts that are automatically injected into Compass's automated workflows. This allows organizations to customize AI behavior across scans without modifying individual diagnostic or definition settings.

Accessing Configuration

Navigate to Configuration from the Compass sidebar. The link is visible to users with Architect-level access or higher. The screen has three tabs: Global Prompts, Scan Presentation Guidance, and Entities.

Scan Presentation Guidance

The Scan Presentation Guidance tab lets administrators create and manage named presentation prompts. When creating a scan, users select one of these prompts to control how the AI builds the scan's automatic presentation.

The tab displays a list of all prompts, showing each prompt's name and a preview of its text.

Creating a Prompt

Click New Scan Presentation Guidance to open the form. Provide:

• Name — A short label for this guidance (e.g., "Clinical Leadership Focus" or "Cost Trends Only").
• Prompt — The text that will be appended to the AI's starting prompt when building a presentation.

Editing a Prompt

Click any prompt in the list to open it for editing. Update the name or prompt text and click Save.

Deleting a Prompt

Open a prompt for editing and click Delete. Deleted prompts no longer appear in the scan creation dropdown. However, if a deleted prompt was already selected on a running or completed scan, it will still be used for that scan's presentation — deletion only prevents future selection.

How It Works

1. An administrator creates one or more guidance prompts on this screen.
2. When creating a scan, the user selects a guidance prompt from the Presentation Guidance dropdown (or leaves it as "None").
3. The selected prompt is saved on the scan.
4. When the scan finishes all diagnostics and begins building the presentation, the system looks up the saved prompt and appends it to the AI's starting instructions.

If no guidance is selected, the default scan presentation behavior is unchanged.

Example Uses

• Direct the AI to emphasize specific themes (e.g., "Focus on cost trends and utilization patterns").
• Request specific chart types or layouts (e.g., "Use bar charts for comparisons across entities").
• Set a preferred tone or audience (e.g., "Write for a clinical leadership audience").
• Exclude certain topics (e.g., "Do not include pharmacy analysis in the overview slides").

Final Session Guidance

The Final Session Guidance field on the Global Prompts tab accepts free-form text that is appended to the very end of the system prompt for every Compass session — after the starting request from the user. This provides a way to inject organization-wide instructions that apply to all AI investigation sessions.

Override Behavior

Final Session Guidance can be overridden at two levels:

• Scan scope: When creating a new scan, a "Final Session Guidance" textarea is available. The value defaults to the global setting but can be edited. Every session in that scan will use the scan-level value instead of the global default.
• Session scope: When starting an individual session (outside of a scan), a "Final Session Guidance" textarea appears below the main question field if a global value has been configured. The user can edit it before starting the session.

If an override is provided (at either scope), it replaces the global value for that session. If the override is cleared, the session will fall back to the global setting.

Example Uses

• Enforce response formatting (e.g., "Always include SQL queries in your findings").
• Set guardrails (e.g., "Do not make clinical recommendations").
• Require specific analysis steps (e.g., "Always compare against the benchmark population").

How It Works

1. An administrator enters guidance text on the Global Prompts screen and clicks Save.
2. The text is stored as a system setting (CompassFinalSessionGuidance).
3. When a session starts, the system checks for a per-request override (from the scan or from the session form). If none is provided, it reads the global setting.
4. If non-empty, the guidance is appended as the final section of the system prompt, after the user's starting request.

If the field is left empty and no override is provided, no additional guidance is appended.

Scan Followup Transition Guidance

The Scan Followup Transition Guidance field on the Global Prompts tab accepts free-form text that is injected when a user sends their first follow-up message to a completed scan session. This provides a way to give the AI transition context — for example, informing it that the investigation phase is over and it is now responding to interactive questions from the user.

How It Works

1. An administrator enters guidance text on the Global Prompts screen and clicks Save.
2. The text is stored as a system setting (CompassScanFollowupTransitionGuidance).
3. When a scan session has completed (status is COMPLETE) and a user sends a follow-up message, the system injects the guidance as a system message before the user's question.
4. The session status changes to FOLLOWUP_UNDERWAY, preventing the guidance from being injected again on subsequent messages.

If the field is left empty, no transition guidance is injected.

Example Uses

• Inform the AI that it is now in a follow-up conversation rather than an autonomous scan ("You are now responding to follow-up questions from the user about your earlier investigation.").
• Set expectations for response style ("Be concise and answer the user's specific question rather than re-running the full investigation.").
• Provide guardrails for follow-up interactions ("Do not re-promote findings unless the user explicitly asks you to.").

Access Control

• Authenticated users can view the global prompts and scan presentation guidance prompts.
• Architects (and above) can update the global prompts and create, edit, and delete scan presentation guidance prompts.