Collaborate on Confluence content with AI agents

Collaborate directly with Rovo agents or other AI agents by mentioning them in Confluence comments. Using artificial intelligence and machine learning, Rovo is an AI tool that is integrated into our cloud-based apps. To invoke agents that you mention in Confluence editor or comments, you’ll need to complete the following.

To get started

  1. You’ll need to be a site admin to enable Rovo, AI features, or MCP agents. What are the different types of admin roles?

  2. Enable Rovo and Confluence AI on your site. Manage Rovo access

The quality, accuracy, and reliability of information generated by AI may vary. Find out why

When you mention an agent in a Confluence comment, the agent starts working in the comment thread. It uses the comment and content context to help with answering questions, quick summaries, and specific tasks.

Agents that are restricted to you won’t appear in the mention picker. If you can’t see an agent in Rovo Chat, you won’t see it when you search for agents in comments.

You can work with agents in comments across pages, live docs, blog posts, whiteboards, and databases. You can also mention agents in the Confluence full page editor.

Set up a Rovo agent for collaboration

Have a think about which agent will best suit the task, and switch agents if your requirements change.

Once it’s set up to collaborate in Confluence, you can mention a Rovo agent by Atlassian, a Rovo agent created by someone in your site, or an agent built by a third party.

Read how to add an external MCP server from Atlassian Administration

To work with a Rovo agent in Confluence:

  1. In the top left navigation, select Switch sites or apps.

  2. Select Studio, then Agents.

  3. Select View my agents.

  4. Choose either Browse agents or Create an agent.

Read how to create and edit Rovo agents and Rovo agent permissions and governance.

Mention an agent in Confluence editor

You can mention multiple agents in the editor, but can only interact with one at a time.

In the Confluence editor, you can mention agents in an action item, a paragraph or list, or in a table.

Mention an agent in an action item

When you mention an agent in an action item, Confluence assumes a specific task is required and automatically opens the Rovo Chat interface.

  1. Type [] or select Action item from the toolbar.

  2. Describe the task you want the agent to perform.

  3. Type @ and select the agent's name.

  4. Trigger the nudge by doing one of the following:

    • Stop typing for three seconds.

    • Select away from the action item.

    • Press Enter.

  5. When the Give agent a task? nudge appears, select it to open the chat.

  6. Review the drafted prompt in the chat window, edit if necessary, and select Send.

Mention an agent in a paragraph or list

For lists, only the text from the specific line item containing the mention is sent to the chat, not the entire list.

For mentions in paragraphs or lists, the intent is often informational. Confluence provides a "nudge" so you can choose whether or not to start a task. To mention an agent in a paragraph or list:

  1. Type your content in a paragraph or a bulleted/numbered list.

  2. Type @ and select the agent's name.

  3. Trigger the nudge by doing one of the following:

    • Stop typing for three seconds.

    • Select elsewhere.

    • Press Enter.

  4. When the Give agent a task? nudge appears, select it to open the chat.

  5. Review the drafted prompt in the chat window, edit if necessary, and select Send.

Mention an agent in a table

If the table cell is empty, the agent will be mentioned but no prompt will be drafted.

Mentioning an agent within a table cell focuses the agent's context specifically on the content of that cell. To mention an agent in a table:

  1. Select a table cell and enter your text.

  2. Type @ and select the agent's name.

  3. Trigger the nudge by doing one of the following:

    • Stop typing for three seconds.

    • Select elsewhere.

    • Press Enter.

  4. When the Give agent a task? nudge appears, select it to open the chat.

  5. The chat will open with the content of that specific cell as a drafted prompt.

Mention an agent in a comment

When you mention an agent in a Confluence comment, the agent starts working in the comment thread. It uses the comment and content context to help with answering questions, quick summaries, and specific tasks.

Only one agent can be active in a comment. If you mention more than one agent, only the most recently added agent mention is active.

To invoke and interact with an agent in a comment, open the page, live doc, blog post, whiteboard, or database you want to work on, then:

  1. Start a general comment or an inline comment. Read about adding comments

  2. In the comment, enter @, then start typing the name of the agent you want to invoke.

  3. Choose the agent from the menu. You may see a mix of people and agents, depending on who or what you’ve recently worked with.

  4. Finish typing your request as a comment, then select Add.

The agent starts working in the thread directly. A looking (eyes icon) reaction on the comment is visible to everyone to show that the agent has started work.

The agent may use the comment, page, and other content it has permission to access to build context. Only you can see and interact with the agent’s chat and loading states.

To stop a request while the agent is working, select Stop.

Work with the agent’s response

When the agent prepares a comment reply, a private draft appears at the bottom of the comment thread. Only you can see this draft until you post it.

Review the draft, then select Add reply to post it or Cancel to discard it. Other collaborators can read the reply after you post it.

If the agent needs more information or approval before it can continue, open the associated Rovo Chat conversation and respond there.

If you navigate away from the chat, you can return to the same conversation from the comment while the chat session is available. Read about Rovo Chat conversations and history

Still need help?

The Atlassian Community is here for you.