Skip to content

Commit 52661cd

Browse files
committed
docs: add agent feedback documentation
Document the agent feedback feature that allows AI agents reading markdown pages to submit feedback about documentation issues.
1 parent 35d6fe0 commit 52661cd

2 files changed

Lines changed: 34 additions & 0 deletions

File tree

agent/feedback.mdx

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: "Agent feedback"
3+
description: "Collect feedback from AI agents that read your documentation to identify incorrect, outdated, or confusing content."
4+
keywords: ["agent feedback", "AI feedback", "LLM feedback", "markdown pages", "documentation quality"]
5+
---
6+
7+
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.
8+
9+
## How it works
10+
11+
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.
12+
13+
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.
14+
15+
Agent feedback is enabled by default for all documentation sites. Your markdown page responses automatically include feedback instructions for AI agents.
16+
17+
## View agent feedback
18+
19+
1. Navigate to the [feedback dashboard](https://dashboard.mintlify.com/products/analytics/v2/feedback) in your dashboard.
20+
2. Select **Ratings by page** to see an overview, or **Detailed feedback** for individual submissions.
21+
3. Look for the **Agent** badge to identify feedback submitted by AI agents.
22+
23+
Use the **Show agent feedback** checkbox in the filter menu to include or exclude agent feedback from your view.
24+
25+
## Manage agent feedback
26+
27+
Agent feedback supports the same management features as other feedback types:
28+
29+
- **Change status**: Mark feedback as Pending, In Progress, Resolved, or Dismissed.
30+
- **Add internal notes**: Click a piece of feedback to add notes for your team.
31+
- **Bulk actions**: Select multiple items to change status, flag, or delete in bulk.
32+
33+
For more information on managing feedback, see [Feedback](/optimize/feedback).

docs.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,7 @@
107107
"agent/linear",
108108
"agent/notion",
109109
"agent/workflows",
110+
"agent/feedback",
110111
"agent/customize",
111112
"agent/effective-prompts",
112113
"agent/use-cases"

0 commit comments

Comments
 (0)