> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Observatory

> Observe, govern, and prove the value of every AI agent running on FlowX from one platform.

Observatory · FlowX.AI

Run AI agents in production.
See it. Govern it. Prove it.

The operational layer for AI agents. Observatory turns raw LLM telemetry into the four things you need in production: visibility, control, regulatory evidence, and a credible ROI story.

[Get started](https://docs.flowx.ai/6.x/observatory/getting-started.md)
[Instrument your SDK](https://docs.flowx.ai/6.x/observatory/sdk/overview.md)

> [!NOTE]
>
> **Observatory availability.** In FlowX.AI 6.0, Observatory runs on environments operated by FlowX. It isn't included in client deployments in this release.

## What problem this solves

Generic LLM dashboards stop where the hard work starts. Observatory covers the full path: from the first trace your SDK emits to the EU AI Act control your auditor wants signed off, and the Net Present Value your CFO wants to see.

Reach for Observatory when you need to:

* See exactly what every agent, chain, and tool call did
* Enforce policies before unsafe behaviour reaches users
* Stay continuously aligned with EU AI Act, NIST AI RMF, or ISO 42001
* Quantify the financial impact of AI investments

## The four pillars

> [card] [Observability](https://docs.flowx.ai/6.x/observatory/observability/overview.md)
>
> Real-time tracing, cost and latency analytics, drift detection, and threshold alerts for every LLM call.

> [card] [Governance](https://docs.flowx.ai/6.x/observatory/governance/overview.md)
>
> Policy engine, risk scoring, evidence collection, and assessments to keep agents accountable.

> [card] [Compliance](https://docs.flowx.ai/6.x/observatory/compliance/overview.md)
>
> EU AI Act, NIST AI RMF, and ISO 42001 controls mapped to your runtime with automated evaluation.

> [card] [ROI & value](https://docs.flowx.ai/6.x/observatory/roi/overview.md)
>
> Risk-adjusted financial ROI, payback, NPV, and Monte Carlo sensitivity per agent and per project.

***

## How the pieces fit together

```mermaid theme={"dark"}
flowchart LR
    subgraph apps [Your apps]
        SDK[Observatory SDK]
    end

    subgraph platform [Observatory platform]
        API[Observatory API]
        DB[("PostgreSQL")]
        Guards[Observatory Guards]
    end

    subgraph ui [Observatory UI]
        Obs[Observability]
        Gov[Governance]
        Comp[Compliance]
        ROI[ROI & value]
    end

    SDK -->|/api/report| API
    API --> DB
    API -.->|safety checks| Guards
    DB --> Obs
    DB --> Gov
    DB --> Comp
    DB --> ROI
```

The SDK decorates your agents, chains, and tools and streams events to the Observatory API. The API stores telemetry in PostgreSQL and optionally forwards content through Observatory Guards for safety checks. Every pillar of the UI reads from the same data — what you observe is what you govern, certify, and report on.

***

## Concept glossary

| Term | What it means in Observatory |
| - | - |
| **Org** | The top-level tenant. Owns apps, datasets, prompts, and experiments. |
| **App** | A single AI app. Owns runs and API keys. |
| **Run** | One execution trace of an agent, chain, or tool. |
| **Event** | A log entry inside a run — for example `chain_start`, `tool_end`, `chat`. |
| **Dataset** | A test set of inputs used for evaluations. |
| **Prompt** | A versioned prompt template. |
| **Experiment** | An evaluation run that scores a prompt or model against a dataset. |
| **Policy** | A governance rule evaluated against runs. |
| **Evidence** | An artefact that proves a control is met. |
| **Risk score** | A six-dimensional score per app. |

***

## Where to go next

> [card] [Getting started](https://docs.flowx.ai/6.x/observatory/getting-started.md)
>
> Connect your first project and emit your first trace in 15 minutes.

> [card] [SDK reference](https://docs.flowx.ai/6.x/observatory/sdk/overview.md)
>
> Install the SDK and learn the `@agent`, `@chain`, and `@tool` decorators.

> [card] [Self-hosted setup](https://docs.flowx.ai/6.x/observatory/setup/self-hosted.md)
>
> Stand up Observatory with Docker Compose for development or self-hosted deployments.

> [card] [AI Platform](https://docs.flowx.ai/6.x/ai-platform/ai-in-flowx.md)
>
> Build the agents that Observatory observes.


## Related topics

- [Environment variables](https://docs.flowx.ai/6.x/observatory/setup/environment-variables.md)
- [Web Crawler setup](https://docs.flowx.ai/6.x/setup-guides/web-crawler-setup.md)
- [AI Platform setup](https://docs.flowx.ai/6.x/setup-guides/ai-platform-setup.md)
- [SDK overview](https://docs.flowx.ai/6.x/observatory/sdk/overview.md)
- [Self-hosted setup](https://docs.flowx.ai/6.x/observatory/setup/self-hosted.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.