Compass

Compass is an AI-powered data investigation tool within Ursa Studio. Users create diagnostics that define AI behavior and toolset, then run interactive sessions where the AI queries the client database, retrieves metadata, and presents findings. Sessions produce findings (query outputs with titles, descriptions, and optional charts) and can optionally conclude with a structured disposition — a formal determination of what was learned.

Getting Started

Compass is available to users with Architect-level access (or higher) on Ursa Studio instances where the infrastructure for LLM use is properly enabled.

Navigate to Compass from the main Ursa Studio application. The default landing page is Explorer, a streamlined way to start an AI conversation immediately. The Compass interface has a collapsible sidebar for navigating between Explorer, the opportunity scan, diagnostics, diagnostic definitions, entities, presentations, and global prompts, with main content areas for diagnostic details, session workspaces, and presentation views.

Explorer — Start an AI conversation immediately without creating a diagnostic first.
Opportunity Scan — Visual progress tracker and automated scan execution for cost-of-care investigations.
Diagnostics — Define the AI's behavior, tools, and sharing settings for investigation sessions.
Diagnostic Definitions — Reusable blueprints that capture diagnostic configuration and session structure.
Diagnostic Suites — Named collections of definitions that group related diagnostics for use in opportunity scans.
Sessions — Run interactive AI conversations within a diagnostic.
Findings — Query outputs with titles, descriptions, and optional chart visualizations.
Presentations — Curated collections of findings from across sessions and diagnostics.
Entities — Organizations or partners that scope diagnostic investigations via automatic query filtering.
Dispositions — Structured, machine-readable session conclusions with schema validation.
Dependencies — Multi-stage workflows where downstream sessions build on upstream findings.
Global Prompts — Organization-wide prompt customizations for automated workflows.
Tools Reference — Capabilities available to the AI during sessions.

Access Control

User Roles

Authenticated users can view diagnostic lists, diagnostic details, session details, and available tools (for diagnostics and presentations shared with them).
Architects (and above) can create diagnostics and presentations, and run AI conversations.

Sharing

Diagnostics and presentations support two levels of shared access:

Editors have the same rights as the owner: they can edit the diagnostic or presentation, manage sessions, run AI conversations, and add or remove other editors and viewers. Only Architect-level users (or higher) can be added as editors.
Viewers have read-only access to the diagnostic or presentation and all of its content.

See Diagnostics — Sharing and Presentations — Sharing for details.

Setup and User Agreement

For installation and configuration, see the Compass Installation Instructions.