From e7796bff1b0c16896def8fe95ce800cab3a3bbd3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 4 Jun 2026 13:21:02 +0000 Subject: [PATCH] docs: document @ mentions for charts and dashboards in AI agent chat --- guides/ai-agents/using-ai-agents.mdx | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/guides/ai-agents/using-ai-agents.mdx b/guides/ai-agents/using-ai-agents.mdx index 1ac4775a..dafb83fa 100644 --- a/guides/ai-agents/using-ai-agents.mdx +++ b/guides/ai-agents/using-ai-agents.mdx @@ -51,6 +51,27 @@ When you pin a saved chart, the agent can read its actual data (subject to your If your agent has data access disabled, pinning still works — the agent sees the chart's structure (name, dimensions, metrics) but no row values are sent to the underlying LLM. +## Mentioning charts and dashboards with `@` + +You can reference saved charts and dashboards directly from the chat input by typing `@`. This adds them as context for the agent's next message, similar to a pinned card, without leaving the conversation. + +Type `@` followed by part of a name to open the suggestion menu. Suggestions are grouped so the most relevant content appears first: + +- **Already mentioned** — content already referenced earlier in this thread. +- **Current page** — the chart or dashboard you're viewing when you open the chat. +- **Dashboard tiles** — charts on the dashboard you're currently viewing. +- **Search results** — any chart or dashboard you have access to, ranked by your search query. [Verified content](/guides/verified-content) is marked with a green check. + +Use the arrow keys to highlight a suggestion and press `Enter` or `Tab` to insert it. While the menu is open, `Enter` selects the suggestion instead of sending the message. + +Each mention becomes a chip in the input — for example, `@Weekly revenue` — and travels with the message as prompt context. The agent uses the same access rules as a pinned card: it can read the resource's structure and (when [data access](/guides/ai-agents/data-access) is enabled) its underlying data. + + + Mention multiple resources in a single message to ask comparative questions, such as *"How does @Weekly revenue compare to @Marketing dashboard's signups trend?"* + + +You can only mention content you have permission to view. Mentions are available in agent threads, in the AI Router, and in the launcher used to start new threads. + ## Read-only threads In some cases, the chat input on an existing thread is disabled and you can't send follow-up messages. The input shows a short message explaining why. You'll see this when: