---
title: "Configure the Agent Observability plugin | Grafana Cloud documentation"
description: "Configure plugin settings, RBAC roles, and data source connections in the Grafana Agent Observability plugin."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Configure the Agent Observability plugin

> Note
> 
> Agent Observability plugin configuration is currently in [public preview](/docs/release-life-cycle/). Grafana Labs offers limited support, and breaking changes might occur prior to the feature being made generally available.

The Grafana Agent Observability plugin provides the UI for browsing conversations, managing agents, configuring evaluation, and viewing dashboards. This article covers plugin configuration and access control.

## Plugin roles

Agent Observability defines five plugin roles that control access to features:

Expand table

| Role                  | Permissions                                                                                       |
|-----------------------|---------------------------------------------------------------------------------------------------|
| Sigil Viewer          | Landing page and tutorial.                                                                        |
| Sigil Data Reader     | Read access to dashboards, traces, model cards, and evaluation pages without conversation access. |
| Sigil Reader          | Dashboards, conversations, traces, model cards, and evaluation results.                           |
| Sigil Feedback Writer | Write conversation feedback (ratings and annotations).                                            |
| Sigil Admin           | Full access including feedback, evaluation configuration, alert rules, and data source settings.  |

## Assign roles

Assign Agent Observability roles to Grafana roles or teams using RBAC:

1. Navigate to **Administration** > **Users and access** > **Roles**.
2. Find or create the role you want to assign Agent Observability permissions to.
3. Add the appropriate `grafana-sigil-app.*` permissions.

## Connect data sources

The Agent Observability plugin queries Prometheus (metrics), Tempo (traces), and the Agent Observability API (generations). In **Configuration**, set:

- The Agent Observability API endpoint.
- The Prometheus data source for metrics dashboards.
- The Tempo data source for trace drilldown.

For Grafana Cloud deployments, data sources are configured automatically.

## Edit the Agent Observability API connection

In some Grafana Cloud stacks, Admin users can edit the Agent Observability API URL and authentication token from the plugin **Configuration** page. Use this when your stack must point the plugin at a different Agent Observability API endpoint or rotate the token used by the plugin proxy.

If editable connection settings aren’t enabled on your stack, the page shows the current connection values as read-only. For Grafana Cloud deployments, the managed defaults are usually sufficient.

## Plugin pages

Expand table

| Page          | Path                                   | Description                                           |
|---------------|----------------------------------------|-------------------------------------------------------|
| Analytics     | `/a/grafana-sigil-app/analytics`       | Activity, latency, error, token, and cost dashboards. |
| Conversations | `/a/grafana-sigil-app/conversations`   | Browse and search conversations.                      |
| Tools         | `/a/grafana-sigil-app/analytics/tools` | Tool usage analytics.                                 |
| Agents        | `/a/grafana-sigil-app/agents`          | Agent catalog with version history.                   |
| Evaluation    | `/a/grafana-sigil-app/evaluation`      | Evaluation rules, evaluators, and scores.             |
| Setup         | `/a/grafana-sigil-app/setup`           | Onboarding wizard and demo data seeding.              |
| Configuration | `/plugins/grafana-sigil-app`           | Plugin settings (Admin only).                         |

## Command palette

Agent Observability registers its pages in the Grafana command palette. Press `Cmd+K` (Mac) or `Ctrl+K` (Linux/Windows) and type “Agent Observability” to quickly navigate to any Agent Observability page.

## Next steps

- [Use built-in dashboards](/docs/grafana-cloud/machine-learning/agent-observability/guides/dashboards)
- [Browse conversations](/docs/grafana-cloud/machine-learning/agent-observability/guides/conversations)