• Documentation

Rovo agents in automations

Space, app, and org 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 directly, or add the agent to an automation rule.

How to trigger an agent

  1. Use the app switcher to navigate to the Studio app

  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 rule

  7. Save and enable your rule

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

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

How to add an agent to an automation rule

  1. Use the app switcher to navigate to the Studio app

  2. Select Automation

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

  4. Select Get started

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

  5. Select Create rule > Create from scratch

  6. Add a trigger to your rule

    1. Configure it if needed

  7. Select Next > THEN: Add an action

  8. Find and select the action, Use Rovo agent

    1. Give the agent a prompt to follow when triggered (For example, read and review the quality of the description field for {{issue.url}}). The agent will respond to this prompt in the background each time the rule is triggered. Use Smart Values in your prompt to reference objects like Jira work items or Confluence pages.
      More about Smart Values in Jira
      More about Smart Values in Confluence

  9. Choose what to do with the agent’s response using the {{agentResponse}} smart value. You can do this by adding additional actions or components that require free text and putting {{agentResponse}} in the free text field. When you add this additional action or component, you can also choose the author of the content (For example, you could add a comment to a work item and choose for it to appear as the rule creator, or as the agent). Whatever you configure will happen automatically whenever the rule is triggered and won’t require additional confirmation from users.

  10. Finish configuring the rule.
    More on creating and editing automation rules in Jira

When the rule is run, the agent will use the permissions of the user who added the agent to the rule. When an agent is triggered in an automation rule, it cannot perform skills — it provides a text response that can be passed via the {{agentResponse}} smart value in subsequent actions of the rule.

For now, only a few actions in the rule builder allow you to use the agent response. We’ll continue to add more and more actions that integrate with agents.

Even if you choose to appear as the author of the agent's response in an automation rule, the app will show a note to indicate this content was created by an agent through automation.

Examples of agents in automation rules

Scenario

Rule

Using the Decision Director, create an automation rule that is triggered by any new Confluence pages with the word “DACI” in the title to leave a comment with a review of the document and suggested improvements including resources to inform the decision.

  1. When: Page published

  2. If: AI condition

    1. Content in title is related to DACI

  3. Then: Use Rovo agent

    1. “Review the content on {{page.url}} and give recommendations”

  4. Then: Add comment

    1. {{agentResponse}} as Decision Director

Using the Jira work item organizer, create an automation rule that is triggered every time a work item is created without a parent (or epic) to leave a comment on the new work item with a suggested epic from that project that could be a relevant parent work item.

  1. When: Work item created in Jira

  2. If: Work item fields conditions

    1. type

    2. is one of

    3. [all child work item types]

  3. And: Related work item condition

    1. Parent

    2. Does not exist

  4. Use Rovo agent

    1. Find a relevant parent (or epic) for {{issue.url}} and explain why you recommend it.

  5. Then: Add comment to work item

    1. {{agentResponse}}

Using the Jira Theme Analyzer, create an automation rule that sends a Slack summary of customer feedback captured in the past 2 days based on a JQL search that captures the relevant data in a Jira project.

  1. When: Scheduled

    1. Every 2 days at 8:00am

  2. Then: Use Rovo agent

    1. Identify themes from these work items [insert JQL search]

  3. And: Send Slack message

    1. {{agentResponse}}

Using the Service Triage, create an automation rule that is triggered every time a work item is created to update the priority field and add a comment on the work item.

  1. When: Work item created in Jira

  2. Then: Use Rovo agent

    1. “Suggest priority for the current work item.”

  3. And: Update priority if it’s different from the current priority

  4. And: Add a comment to describe the updates made by the Service Triage agent to the work item.

Using the Service Triage, create an automation rule that is triggered every time a work item is created to update the request type based on similar work items and add a comment on the work items.

  1. When: Work item created in Jira

  2. Then: Use Rovo agent

    1. “Suggest request type for the current work item.”

  3. And: Update request type if it’s different from the current one

  4. And: Add a comment to describe the updates made by the Service Triage agent to the work item.

Using the Service Triage, create an automation rule that is triggered every time a work item is created to update the summary based on description and add a comment on the work item.

  1. When: Work item created in Jira

  2. Then: Use Rovo agent

    1. “Suggest summary for the current work item.”

  3. And: Update summary

  4. And: Add a comment to describe the updates made by the Service Triage agent to the work item.

 

Still need help?

The Atlassian Community is here for you.
Ask the Community
On this pageHow to trigger an agentHow to add an agent to an automation ruleExamples of agents in automation rules
CommunityQuestions, discussions, and articles