diff --git a/guides/ai-agents/verified-answers.mdx b/guides/ai-agents/verified-answers.mdx index aed3132f..8e3667a5 100644 --- a/guides/ai-agents/verified-answers.mdx +++ b/guides/ai-agents/verified-answers.mdx @@ -80,6 +80,12 @@ If an answer is no longer a good example: Only users with the **Admin** and **Developer** roles can verify answers. +## Admin-verified charts and dashboards + +Verified answers are one of two trust signals your agent uses. The other is [admin-verified charts and dashboards](/guides/verified-content) — content that organization or project admins have signed off on as canonical. + +When an agent searches your project for existing content to reference, it ranks admin-verified charts and dashboards first and surfaces them to the user along with who verified them and when. You don't need to configure anything: any chart or dashboard verified in project settings is automatically preferred by every agent in that project. + ## How this improves your agent Verified answers help your agent: diff --git a/guides/verified-content.mdx b/guides/verified-content.mdx index ccebfd27..31380720 100644 --- a/guides/verified-content.mdx +++ b/guides/verified-content.mdx @@ -44,6 +44,23 @@ This makes it easy for teams to distinguish between exploratory or work-in-progr Homepage with a 'Verified' tab listing all verified charts and dashboards for quick access +## AI agents prefer verified content + +When an [AI agent](/guides/ai-agents) searches your project for existing charts and dashboards to reference, admin-verified content is ranked first. If a verified chart or dashboard matches the user's question, the agent surfaces it ahead of unverified results and tells the user it's verified, including who verified it and when. + +This applies to: + +- The agent's content search, used when a question can be answered by an existing chart or dashboard +- The agent's dashboard chart previews, where verified charts inside a dashboard are shown first + +Verification stays atomic per item: a chart inside a verified dashboard is only treated as verified by the agent if that chart itself has been verified. Verifying a dashboard does not cascade to its charts. + +You don't need to configure anything for this — any chart or dashboard you've verified is automatically preferred by every AI agent in the project. To benefit, verify the canonical charts and dashboards you want your team (and your agents) to start from. + + +This is separate from [verified answers](/guides/ai-agents/verified-answers), where users mark answers an AI agent produced as good examples. Both signals are used by the agent today and will be unified in a single trusted-content stream in a future release. + + ## Verification is automatically removed when content changes Verification is tied to the exact state of the content at the time it was verified. If anyone edits a verified chart or dashboard, the verification badge is automatically removed. An admin will need to review the updated version and re-verify it.