What this helps you do
Comments keep feedback connected to the part of an artifact being discussed. Use them to review work with colleagues, give revision instructions to an agent, or ask an agent to review an artifact and flag issues that need attention. People who can see the artifact can participate in its comment threads. Their agents can also read and work with those comments when the artifact is available in the agent’s context. A common review cycle is:Agent drafts → a person comments → Resolve with AI → the agent revises → a person reviews → the thread is marked complete
Before you start
You need access to the artifact. Viewers can participate in comments, while changing the underlying content depends on their edit permissions. Comments are shared with other people who can access the artifact. Do not use them for private notes or information that other permitted viewers should not see.Point to what you are commenting on
Comment placement changes to suit the artifact, allowing reviewers to point at the exact text, value, element, or region they mean.
Anchored comments preserve useful context even when the discussion continues over several replies.
Leave feedback on an artifact
Text documents
- Open the document.
- Select the text you want to discuss.
- Select Comment from the selection controls.
- Enter the feedback and send it.
Office files, PDFs, and visual content
For PDFs and Office files such as Word documents and PowerPoint presentations, choose the anchor that matches the feedback:- Text selection — use when the feedback is about specific words, figures, or a sentence.
- Rectangular selection — use when the feedback is about a page or slide region, such as a chart, table, screenshot, or layout area.
- Pin — use when you want to point at a location without selecting text or drawing a region.
- Select Add comment or Add comment pin.
- Place the pin on the relevant image region, whiteboard element, page, or slide location.
- Enter the feedback and send it.
Spreadsheets and grids
Select the relevant cell or range before creating the comment. The thread records the sheet and cell selection so collaborators and agents can locate the value being discussed.Discuss and organize feedback
- Select a comment to reply in its thread.
- Type
@in the comment box to reference a teammate or another available project item. Mentioning a teammate notifies them, as long as they can reach the artifact. - Use the comment menu to edit or delete a comment when your permissions allow it.
- Filter the comments panel to show your threads, completed threads, or matching text.
- Mark a thread complete after its feedback has been addressed and reviewed.
Resolve feedback with AI
Resolve with AI sends a comment thread to the chat as referenced context so an agent can help implement the feedback.- Open the comment thread you want to address.
- Select Resolve with AI in the reply area.
- Review the comment reference added to the chat input.
- Add any constraints or clarification the agent needs.
- Send the request.
- Review the resulting changes in the artifact.
- Mark the thread complete when the feedback has been addressed satisfactorily.
Resolve several comments together
Use the checkboxes in the comments panel to select multiple visible threads, then select Resolve with AI. Collivo adds references for all selected threads to the chat input so the agent can consider the feedback together. This is useful when several comments describe related changes, such as revising multiple sections of a proposal while keeping its terminology consistent.Resolve with AI asks an agent to work on the feedback. Mark complete records that the discussion has been addressed. Always review the result before completing the thread.
Ask an agent to review your work
Where supported, agents can also participate as reviewers. Ask an agent to inspect an artifact and leave comments instead of immediately changing anything when you want to evaluate its findings first. For example, an agent can:- Flag unsupported claims or missing evidence in a report.
- Identify inconsistent figures or assumptions in a spreadsheet.
- Point out unclear visual hierarchy or missing content in a presentation.
- Review a whiteboard and comment on unresolved decisions or gaps.
- Highlight issues that require a person’s judgment rather than silently choosing an answer.
Review this report against Q3 figures.xlsx and comment on any claim the data does not support. Leave comments only — do not edit the report.
Where supported, the agent can attach its comment to highlighted text, an artifact element, or another available anchor. Its comments appear in the same shared discussion so people can reply, make changes themselves, or send the feedback to another agent.
A useful pattern is:
A person requests review → the agent leaves comments → the team evaluates the findings → a person or agent addresses them → the threads are completed
Expected result
Feedback stays attached to the content it concerns, people and agents can participate in the same review process, and completed threads provide a clear record of what has been addressed.Troubleshooting
- You cannot find a comment: open the comments panel, clear its filters, and search for text from the thread.
- A text-linked comment no longer jumps to the right place: the document may have changed. Use the quoted text in the comment to locate the updated section.
- A visual pin points to an older version: open the version where the comment was created or place a new comment on the current content.
- Resolve with AI is unavailable: confirm that you can participate in the thread and that chat is available in the project.
- The agent misunderstood the feedback: reopen the thread, add the missing constraint to the prepared chat message, and ask the agent to explain its intended change before applying it.
- A mention does not find someone: confirm that the person belongs to the organization, is a member of the project, and can access the artifact.