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

# AI agents

> Ask questions in plain language and get governed answers, charts, and dashboards from your metrics

<Info>
  AI agents are available as an add-on for all plans. [View pricing](https://www.lightdash.com/pricing)
</Info>

Lightdash AI agents let your team ask questions in natural language and get answers built from your semantic layer — the saved dashboards, metrics, dimensions, joins, and descriptions you've already defined. An agent picks the relevant models and metrics, builds and runs the query with the right filters and [parameters](/semantic-layer/parameters), and returns the result as the chart, table, or summary that fits the question. Because every answer runs through the semantic layer, it respects the same project permissions and user attributes as the rest of Lightdash.

You can run agents in the Lightdash app or in Slack, scope each one to a domain with tags, and improve them over time with verified answers, evaluations, and knowledge documents. The pages below cover setup, day-to-day use, governance, and the features that make agents more accurate.

<Note>
  Looking for [**Autopilot**](/agents/autopilot)? Autopilot is a separate, admin-only agent that runs on a schedule to keep your project clean — fixing broken charts, flagging stale content, and suggesting new ones. It does not build charts or dashboards from user questions like the conversational agents described here.
</Note>

<Frame>
  <iframe width="100%" height="420" src="https://www.loom.com/embed/fbc7071e2b2b46739657cd451062e4d9" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen />
</Frame>

## Choosing your AI surface

Lightdash exposes several AI surfaces, and the right one depends on **who is asking**, **what they're trying to do**, and **how much governance you need**. They share one foundation: the **Lightdash semantic layer** — governed metrics, joins, descriptions, permissions, project context, verified answers, and evaluations. Investing there pays off no matter which surface a user picks.

### Decision guide

Pick the first item that matches what you're trying to do:

* **Let business users ask governed questions in natural language** — use [AI agents in the app](/agents/use-ai-agents), or [in Slack](/integrations/slack) when the answer belongs in a team conversation.
* **Send an agent answer on a schedule** — [schedule a recurring delivery from a conversation](/agents/use-ai-agents#schedule-a-recurring-delivery-from-a-conversation) so Lightdash re-runs the agent on your chosen frequency and sends the refreshed chart plus an AI-written summary to Slack, email, or Microsoft Teams.
* **Query Lightdash from Claude, Cursor, Codex, ChatGPT, or a custom agent** — use the [Lightdash MCP server](/agents/lightdash-mcp).
* **Give your agents tools from Notion, Linear, Confluence, or other services** — connect [external MCP servers](/agents/connect-external-mcp-servers).
* **Teach your AI coding tool Lightdash concepts and YAML syntax** — add the [Docs MCP](/agents/lightdash-mcp#lightdash-docs-mcp) and install [agent skills](/workflow/install-agent-skills).
* **Build an interactive, shareable app from a prompt** — use [data apps](/data-apps).
* **Create or edit saved charts and dashboards conversationally** — use [content editing](/agents/enable-content-tools). *(Beta)*
* **Make bulk, reviewable dashboard changes** — use [dashboards as code](/workflow/content-as-code) with `lightdash download` and `lightdash upload`.
* **Change a metric, dimension, join, or description** — edit dbt or Lightdash YAML through Git, or use [AI writeback](/agents/ai-writeback).
* **Change code in another connected repository (not the dbt project)** — use the [AI coding agent](/agents/ai-coding-agent) to open a pull request on any repo your org can write to, with verification delegated to that repo's own CI. *(Beta)*
* **Fix something the agent got wrong** — improve descriptions, [AI hints](/semantic-layer/writing-descriptions#layer-ai-hints-on-top-of-descriptions), project context, [verified answers](/agents/verified-answers), [evaluations](/agents/create-evaluation-suites), or [Issues](/agents/issues) findings. *(Issues is Beta.)*

### Compare the surfaces

| Surface                                                                                               | Best for                                                                     | Typical user                   | Governance model                                                                        |
| ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------ | --------------------------------------------------------------------------------------- |
| [AI agents](/agents/use-ai-agents) (app & [Slack](/integrations/slack))                               | Governed self-serve questions and visualizations                             | Business user                  | Agent tag scope, project permissions, user attributes                                   |
| [Lightdash MCP server](/agents/lightdash-mcp)                                                         | Querying Lightdash from external AI clients                                  | Power user, developer, analyst | OAuth, project permissions, user attributes                                             |
| [External MCP servers](/agents/connect-external-mcp-servers)                                          | Giving your agents tools from outside services                               | Agent builder                  | Per-project config, per-user or shared OAuth                                            |
| [Docs MCP](/agents/lightdash-mcp#lightdash-docs-mcp) + [agent skills](/workflow/install-agent-skills) | Giving coding agents Lightdash concept and YAML context                      | Developer with an AI IDE       | Public docs, local to the developer                                                     |
| [Data apps](/data-apps)                                                                               | Interactive, shareable apps generated from a prompt                          | Analyst, app builder           | Project role and space access; queries run through Lightdash                            |
| [Content editing](/agents/enable-content-tools) *(Beta)*                                              | Conversational chart and dashboard creation and edits                        | Analyst, agent operator        | Enabled per agent, scoped by agent permissions                                          |
| [Dashboards as code](/workflow/content-as-code)                                                       | Bulk, reviewable, version-controlled dashboard changes                       | Developer, analytics engineer  | Git review, previews, validation                                                        |
| [AI writeback](/agents/ai-writeback)                                                                  | Agent-proposed changes to dbt / Lightdash YAML                               | Analytics engineer             | Git review, dbt / Lightdash validation                                                  |
| [AI coding agent](/agents/ai-coding-agent) *(Beta)*                                                   | Agent-proposed changes to any connected repository, not just the dbt project | Developer, analytics engineer  | Feature flag, org's Git App install + user access intersection, denied-path commit gate |

A few principles hold across all of them: keep agents **focused** — several domain-scoped agents beat one project-wide agent; treat **raw SQL as an escape hatch** and fix the semantic layer when routine questions need it; and never upload sensitive material as knowledge documents unless everyone who can use the agent is allowed to see it. For the full treatment, see [Effective analytics with agents](/agents/effective-analytics-with-agents).
