docs-mintlify/docs/explore-analyze/dashboards/dashboard-agent.mdx
The Dashboard Agent is a conversational assistant docked as a panel on a published or embedded dashboard. Ask it questions in plain language about what's on the dashboard — and it answers using live queries against your semantic model, not just the numbers already rendered on screen.
Because it queries the model directly, the agent can go beyond what a chart shows. It can drill into a single chart, re-aggregate a metric, break a number down by a dimension, pull a longer time range than the chart displays, and summarize trends across the dashboard.
<Frame> </Frame> <Note> There are **two different agent surfaces** with different capabilities:Most of this page describes the read-only Dashboard Agent. Keep the distinction in mind — the published agent intentionally cannot author or change anything. </Note>
Open a published dashboard and toggle the agent panel from the dashboard header to start a conversation. Use New Chat to start a fresh thread.
The panel is docked to the right side of the dashboard and is resizable — drag its edge to give the conversation more or less room. On narrow screens it switches to a compact mode so it stays usable next to the dashboard.
To ask about one chart in particular, open that chart tile's menu (⋮) and
choose Ask a follow up question. This opens the agent with that chart
attached as context, so your question is scoped to that chart's data.
Attached charts appear as removable chips in the chat input. To drop a chart's focus, remove its chip. You can attach more than one chart to ask about them together.
When a chart is attached, the agent receives a read-only snapshot of it — the underlying SQL, the data, and the chart spec — along with the dashboard's current filter and time-grain state. It uses this as context; it does not modify any of it.
The published Dashboard Agent is read-only by design.
It can:
It can't:
If you need any of those, use the Workbook Agent instead.
You can attach uploaded files to the conversation, and the agent can read their contents — text, PDF, ZIP, and image files are supported.
<Note> Pasting an image directly from your clipboard into the chat may also be supported. Confirm this in your deployment before relying on it. </Note>