Skip to main content
When AI agents browse your documentation through Markdown pages, 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 agent feedback works

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 appears in the feedback dashboard with an Agent badge to distinguish it from human feedback. You can filter, manage, and resolve agent feedback the same way as other feedback types. Agent feedback is enabled by default for all documentation sites. No configuration required.

​
View agent feedback

  1. Navigate to the feedback dashboard 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.
Use the Show agent feedback checkbox in the filter menu to include or exclude agent feedback from your view.

​
Manage agent feedback

Agent feedback supports the same management features as other feedback types:
  • Change status: Mark feedback as Pending, In Progress, Resolved, or Dismissed.
  • Add internal notes: Click a piece of feedback to add notes for your team.
  • Bulk actions: Select multiple items to change status, flag, or delete in bulk.
For more information on managing feedback, see Feedback.

Related topics

Use casesAdd the agent to LinearComments