Skip to content

docs: AI agents prefer admin-verified content in search #645

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: AI agents prefer admin-verified content in search #645

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions guides/ai-agents/verified-answers.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
17 changes: 17 additions & 0 deletions guides/verified-content.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,23 @@ This makes it easy for teams to distinguish between exploratory or work-in-progr
<img src="/images/guides/verified-content/homepage-tab.png" alt="Homepage with a 'Verified' tab listing all verified charts and dashboards for quick access"/>
</Frame>

## 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.

<Info>
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.
</Info>

## 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.
Expand Down
Loading