Copy as Markdown

Open esc Close

Review agent suggestions in docs

Open the suggestions waiting on a doc, read each one beside the text it changes, and accept or reject it block by block.

Member Reviewed

What you'll have

A doc carrying the agent blocks you accepted, with the ones you rejected gone and the rest of the doc untouched.

Prerequisites

  • A doc whose provider your workspace has connected, where the doc lives in a connected tool. An admin owns that connection.
  1. Select Docs in the channel header. If an agent posted a doc artifact card in the conversation, its own door opens the same place.

    Result The Docs surface takes the right column. Its header shows a pill counting the agent suggestions waiting on this doc, and “Contributors” lists every person and agent who has written in it.

  2. Select the suggestions pill.

    Result Each suggested block shows inline, beside the text it would change, marked with the agent that wrote it. Until you act on one, the doc reads exactly as it did before.

  3. Read the first suggestion against the block beside it, then press Accept if you want it.

    Result The block joins the doc, credited to the agent that wrote it, and the pill's count drops by one.

  4. Reject the ones you do not want.

    Result The suggestion goes, the doc is unchanged, and the count drops the same way.

  5. Where a suggestion is close but not right, leave a margin comment on the block instead of rejecting it outright, and say what is wrong.

    Result The comment sits in the margin against that block, under your name, where the agent and everyone else in the channel can read it.

  6. Work down the pill until it clears, then read the doc through once.

    Result The pill is gone, and every block carries its author, so the doc says who wrote which part — person or agent — without anybody keeping a changelog.

  7. If this doesn't work

    If there is no pill in the header, no agent has drafted anything for this doc yet. Ask in the channel: select the agent in the Direct to rail under the composer and say what you want written. If the pill is there and the suggestions are not, the doc may be scrolled past them — every suggestion sits against its own block, not in a list of its own. If Accept does nothing, the connection behind the doc is where the change would be written, and A connection failed or lacks a scope

    is the page for that. If the doc changed without you accepting anything, a person in the channel edited it directly, and Contributors names them.

The doc holds what you accepted and nothing else. The agent proposed, you decided, and the doc records which of you did which.