Skip to content

Update agent feedback docs to reflect manual prompting#5789

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/agent-feedback-markdown-1778696567
Open

Update agent feedback docs to reflect manual prompting#5789
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/agent-feedback-markdown-1778696567

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 13, 2026

Summary

The agent feedback feature no longer auto-injects an <AgentInstructions> block into Markdown exports. The dashboard toggle, the /feedback endpoint, and historical agent feedback in the analytics dashboard remain unchanged.

This PR updates the docs to:

  • Remove references to Mintlify automatically appending an <AgentInstructions> block to Markdown exports.
  • Explain that customers should prompt agents to submit feedback themselves by including the /feedback endpoint and JSON payload format in their own instructions or system prompts.
  • Add an example prompt showing the expected payload.

Updates applied to the English pages and to the zh, fr, and es translations:

  • optimize/feedback.mdx
  • ai/markdown-export.mdx

Source PR

Pairs with mintlify/mint#7701, which stops emitting the feedback instruction block in docs page .md responses.


Note

Low Risk
Low risk documentation-only change that updates guidance around how agent feedback is prompted/submitted; no product behavior or APIs are modified.

Overview
Updates agent feedback documentation to remove references to Mintlify auto-injecting an <AgentInstructions> block into Markdown exports, and instead instructs users to manually prompt agents to POST feedback to /feedback.

Adds a concrete example prompt/payload for submitting feedback in optimize/feedback.mdx, and mirrors the same guidance across ai/markdown-export.mdx and the es/fr/zh translations.

Reviewed by Cursor Bugbot for commit 82508c8. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify-development
Copy link
Copy Markdown
Contributor

mintlify-development Bot commented May 13, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟢 Ready View Preview May 13, 2026, 6:32 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant