From f1a14234af43457ece7a073f9b70989085582206 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 29 Sep 2026 05:12:24 +0000
Subject: [PATCH] docs: document editor agent reading open comments and
 suggestions

---
 editor/agent.mdx       | 9 +++++++++
 editor/collaborate.mdx | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/editor/agent.mdx b/editor/agent.mdx
index 628630f6a..e4b347135 100644
--- a/editor/agent.mdx
+++ b/editor/agent.mdx
@@ -60,6 +60,15 @@ Example prompts:
 
 The agent uses the page you currently have open unless you name another page. It can annotate rendered page text, including prose inside components. It cannot annotate frontmatter, page metadata, configuration, or raw MDX component tags and attributes.
 
+### Work with existing feedback
+
+The agent can read the open comments and suggestions on a page, including replies. Ask it to summarize feedback or act on it. For example:
+
+- `what feedback has been left on this page?`
+- `apply the changes requested in the open comments`
+
+The agent only reads unresolved threads. It also notes when the commented text no longer exists on the page. Reading comments doesn't reply to or resolve them.
+
 ## Review what the agent changed
 
 A file changes list appears in the chat as the agent works. Expand it to see every file modified in the session, and click any file to compare the changes against the original in diff view.
diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx
index e9d3624ca..fa4572e38 100644
--- a/editor/collaborate.mdx
+++ b/editor/collaborate.mdx
@@ -62,7 +62,7 @@ Mention `@mintlify` in a comment, suggestion, or reply to ask the [editor agent]
 @mintlify are there any pages that contradict this?
 ```
 
-The agent runs read-only when replying to comments. It can search your docs, read pages, fetch web content, and load skills, but it cannot edit content, create suggestions, or publish. To make changes, open the [editor agent](/editor/agent) directly.
+The agent runs read-only when replying to comments. It can search your docs, read pages and their open comments, fetch web content, and load skills, but it cannot edit content, create suggestions, or publish. To make changes, open the [editor agent](/editor/agent) directly.
 
 Mentions work on private pages for members who already have access.