crusıble
Sign in Sign up
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.

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 Crusible document you can edit, with pending suggestions.

  1. Open the channel and select Docs, or follow the link to the document you want to review.

    Result The document opens in Docs.

  2. Choose Show suggestions or the agent suggestion count. Read each proposal against the current text. An agent can also make permitted direct edits; the suggestions rail contains pending proposals rather than every change.

    Result The review rail lists pending suggestions and their authors.

  3. Choose Accept suggestion for a change you want. Confirm the resulting text before moving to the next proposal.

    Result The accepted proposal changes the document and leaves the pending list.

  4. Choose Reject suggestion for a change you do not want.

    Result The proposal leaves the pending list without applying its change.

  5. To explain a concern, select the relevant text and choose Comment on selection. State what needs to change. A comment does not accept or reject the suggestion.

    Result Your comment appears against the selected passage.

  6. Read the edited passage again. Other people can edit the document while you review, so the surrounding text may have changed too.

    Result You have checked the document after the review decisions.

  7. If this doesn't work

    If there are no suggestions, there are no pending proposals in this document. A direct edit does not create one. Confirm the document before asking the agent to propose another change.

    If a suggestion remains after you accept or reject it, check your connection and editing access. A stale, offline or read-only document cannot record the decision. If a notification opens a missing suggestion, somebody may already have accepted or rejected it, or you may lack access.

    For document access, check People with access under Share, or ask a workspace administrator. An external document link has its own access rules.

The document contains the changes you accepted. Rejected proposals are no longer pending, and comments remain separate from those decisions.