Skip to content

Update from code changes: editor agent reads open comments #7560

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ethanpalm merged 1 commit into from
Sep 30, 2026
Merged

Update from code changes: editor agent reads open comments #7560

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions editor/agent.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
Only editors and admins can open the agent.
</Info>

Click **Ask agent** in the editor toolbar, or press <kbd>Cmd</kbd> + <kbd>I</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>I</kbd> (Windows) when no text is selected. You can also open the agent on dashboard settings pages. Your chat session stays open as you move between the editor and settings.

Check warning on line 17 in editor/agent.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/agent.mdx#L17 

Avoid first-person pronouns such as ' I '.

Check warning on line 17 in editor/agent.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/agent.mdx#L17 

In general, use active voice instead of passive voice ('is selected').

Type <kbd>@</kbd> to mention a specific page in a prompt for the agent to focus on. Without a mention, the agent uses the page you currently have open as its initial context. On your dashboard, the agent knows which page you're viewing so you can ask about the current page without naming it.

Expand Down Expand Up @@ -60,6 +60,15 @@

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.
Expand Down
2 changes: 1 addition & 1 deletion editor/collaborate.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@
1. Click <Icon icon="ellipsis" /> **More options** in the top-right of the page.
2. Click **Comments**.

React to a comment to acknowledge it without replying. Hover over a comment, click the **Add reaction** button, and choose an emoji. Reacting to someone else's comment notifies the comment's author.

Check warning on line 36 in editor/collaborate.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/collaborate.mdx#L36 

Did you really mean 'else's'?

To edit or delete a comment you wrote, click **More actions** on the comment. You can only edit and delete your own comments. Deleting the first comment in a thread deletes the entire thread.

Expand Down Expand Up @@ -62,7 +62,7 @@
@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.

Expand Down
Loading