docs: add agent feedback documentation#5337
Merged
skeptrunedev merged 2 commits intomainfrom Apr 13, 2026
Merged
Conversation
Document the agent feedback feature that allows AI agents reading markdown pages to submit feedback about documentation issues.
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
ethanpalm
approved these changes
Apr 13, 2026
Collaborator
ethanpalm
left a comment
ethanpalm
left a comment
There was a problem hiding this comment.
just a few style nits. lgtm!
agent/feedback.mdx
Outdated
| keywords: ["agent feedback", "AI feedback", "LLM feedback", "markdown pages", "documentation quality"] | ||
| --- | ||
|
|
||
| When AI agents browse your documentation through [markdown pages](/ai-native), they can submit feedback about issues they encounter. This feedback appears in your dashboard alongside user feedback so you can track and resolve documentation problems reported by both humans and AI agents. |
Collaborator
There was a problem hiding this comment.
Suggested change
| When AI agents browse your documentation through [markdown pages](/ai-native), they can submit feedback about issues they encounter. This feedback appears in your dashboard alongside user feedback so you can track and resolve documentation problems reported by both humans and AI agents. | |
| When AI agents browse your documentation through [Markdown pages](/ai-native#discovering), they can submit feedback about issues they encounter. This feedback appears in your dashboard alongside user feedback so you can track and resolve documentation problems reported by both humans and AI agents. |
agent/feedback.mdx
Outdated
|
|
||
| When AI agents browse your documentation through [markdown pages](/ai-native), they can submit feedback about issues they encounter. This feedback appears in your dashboard alongside user feedback so you can track and resolve documentation problems reported by both humans and AI agents. | ||
|
|
||
| ## How it works |
Collaborator
There was a problem hiding this comment.
Suggested change
| ## How it works | |
| ## How agent feedback works |
A little SEO/AEO
agent/feedback.mdx
Outdated
|
|
||
| ## How it works | ||
|
|
||
| Your markdown pages include instructions that tell AI agents how to report issues. Agents submit feedback through a POST request with the page path and a description of the problem. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Your markdown pages include instructions that tell AI agents how to report issues. Agents submit feedback through a POST request with the page path and a description of the problem. | |
| Your Markdown pages include instructions that tell agents how to report issues. Agents submit feedback through a POST request with the page path and a description of the problem. |
agent/feedback.mdx
Outdated
|
|
||
| Your markdown pages include instructions that tell AI agents how to report issues. Agents submit feedback through a POST request with the page path and a description of the problem. | ||
|
|
||
| Agent feedback appears in the [feedback dashboard](https://dashboard.mintlify.com/products/analytics/v2/feedback) with an **Agent** badge to distinguish it from human feedback. You can filter, manage, and resolve agent feedback using the same workflow as other feedback types. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Agent feedback appears in the [feedback dashboard](https://dashboard.mintlify.com/products/analytics/v2/feedback) with an **Agent** badge to distinguish it from human feedback. You can filter, manage, and resolve agent feedback using the same workflow as other feedback types. | |
| Agent feedback appears in the [feedback dashboard](https://dashboard.mintlify.com/products/analytics/v2/feedback) with an <Badge color="blue">Agent</Badge> badge to distinguish it from human feedback. You can filter, manage, and resolve agent feedback the same way as other feedback types. |
agent/feedback.mdx
Outdated
|
|
||
| Agent feedback appears in the [feedback dashboard](https://dashboard.mintlify.com/products/analytics/v2/feedback) with an **Agent** badge to distinguish it from human feedback. You can filter, manage, and resolve agent feedback using the same workflow as other feedback types. | ||
|
|
||
| Agent feedback is enabled by default for all documentation sites. Your markdown page responses automatically include feedback instructions for AI agents. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Agent feedback is enabled by default for all documentation sites. Your markdown page responses automatically include feedback instructions for AI agents. | |
| Agent feedback is enabled by default for all documentation sites. No configuration required. |
agent/feedback.mdx
Outdated
|
|
||
| 1. Navigate to the [feedback dashboard](https://dashboard.mintlify.com/products/analytics/v2/feedback) in your dashboard. | ||
| 2. Select **Ratings by page** to see an overview, or **Detailed feedback** for individual submissions. | ||
| 3. Look for the **Agent** badge to identify feedback submitted by AI agents. |
Collaborator
There was a problem hiding this comment.
Suggested change
| 3. Look for the **Agent** badge to identify feedback submitted by AI agents. | |
| 3. Look for the <Badge color="blue">Agent</Badge> badge to identify feedback submitted by AI agents. |
- Capitalize "Markdown" and link to #discovering anchor - Use more descriptive heading for SEO/AEO - Use Badge component instead of bold for Agent badge - Simplify enabled-by-default wording - Remove redundant "AI" before "agents"
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
agent/feedback.mdxpage documenting the agent feedback featuredocs.jsonWhat is agent feedback
AI agents reading markdown versions of documentation pages can submit feedback about incorrect, outdated, or confusing content via a POST endpoint. This feedback appears in the dashboard with an "Agent" badge and can be managed alongside human feedback.
Test plan
/ai-native,/optimize/feedback)Note
Low Risk
Low risk documentation-only change that adds a new MDX page and a navigation entry; the main risk is broken/incorrect links or missing components (e.g.,
Badge) affecting page rendering.Overview
Adds a new
agent/feedback.mdxpage documenting how AI agents submit feedback on Markdown pages, how it appears in the dashboard (with anAgentbadge), and how to filter/manage it.Updates
docs.jsonto includeagent/feedbackin the Agent navigation group so the new page is discoverable from the sidebar.Reviewed by Cursor Bugbot for commit bf23a08. Bugbot is set up for automated code reviews on this repo. Configure here.