Automating Rovo agents

Admins can use agents in automation rules to save time on more complicated repetitive tasks. Using an agent within an automation rule allows you to generate and share content in any app integrated with Atlassian Automation. There are two ways to this: add a trigger to an agent’s configuration, or add the agent to an automation rule.

For agents to work autonomously, they must be managed through your existing Confluence space or Jira Project administrators via an automation rule. Without automations and setup from an admin, agents can’t work autonomously.

Add a trigger to an agent

If you are an agent’s manager or editor, you can add a trigger in the agent’s configuration.

  1. Use the App switcher () and navigate to Studio.

  2. Select Agents.

  3. Browse to locate the agent you want to automate.

    1. Select the agent to open it.

  4. Select Triggers from the left-hand navigation.

    1. Any existing rules that trigger this agent are listed, organized by app.

  5. Select Add automation trigger to configure an event that will trigger this agent.

  6. Select the appropriate app and space.

    1. You’ll be redirected to automation in Jira, Jira Service Management, or Confluence to finish building the flow.

  7. Save and enable your flow.

    1. Refresh your agent’s Triggers screen to see it listed

An agent's settings show a rule that can trigger it in Confluence

Add an agent to an automation flow

If you are a space or app administrator, you can create an automation rule that invokes an agent to perform a secondary action.

  1. Use the App switcher () and navigate to Studio.

  2. Select Automation.

  3. Select the app and space you want to create the automation flow in.

  4. Select Get started

    1. You’ll be redirected to Automation in the app and space you selected.

  5. Select Create flow, then Create from scratch.

  6. Add a trigger to your flow and configure it if needed.

  7. Select Next, then THEN: Add an action

  8. Find and select the action, Use Rovo agent

    1. Connect Rovo to automation to allow agents to act on your behalf

    2. Select an agent (required)

    3. Write a prompt (required)

  9. Add a second action to tell the agent what to do

    1. Configure it with {{agentResponse}}

More about how to configure the Use Rovo agent action

The automation action, Use Rovo agent, shows a field to select an agent to use and a second field to write a prompt.
When "work item assigned" Then prompt Slack Message agent to "DM ticket link and assignee" And Send Slack {{agentResponse}}.

Flow examples

See all available out-of-the-box agents

Scenario

Rule

Use the agent, Decision director

The automation flow is triggered when new Confluence pages are published with “DACI” in the title. The Decision director agent should review the page and leave a comment suggesting improvements.

 

WHEN: Page published


IF: Rovo condition

Content in the title relates to given text:

DACI (field text)


THEN: Use Rovo agent, Decision director

Review the content on this page and give recommendations (prompt)


THEN: Add comment to page

{{agentResponse}} (field text)

Use the agent, Jira work item organizer

The automation flow is triggered when a work item is created without a parent task or epic. The Jira work item organizer agent should find a relevant parent and leave the suggestion as a comment on the new work item.

 

WHEN: Work item created in Jira


IF: Work item field condition

Type is one of [all child work item types]


AND

IF: Related work item condition

Parent does not exist


THEN: Use Rovo agent, Jira work item organizer

Find a relevant parent (or epic) for this work item and explain why you recommend it (prompt)


THEN: Add comment to work item

{{agentResponse}} (field text)

Use the agent, Jira theme analyzer

The automation flow is triggered every 2 days at 8am. The Jira theme analyzer agent should analyze data from work items created in the past 2 days and send a summary in Slack, organized by theme.

 

When: Scheduled

Every 2 days at 8:00am


THEN: Use Rovo agent, Jira theme analyzer

Identify themes from work items created in the past 2 days (prompt)


THEN: Send Slack message

{{agentResponse}} (field text)

 

Still need help?

The Atlassian Community is here for you.