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.

Add a trigger to 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 screen to see it listed

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. 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 details below)

Tips to configure the action, Use Rovo agent

Mention the trigger’s object in your prompt

When you use a Rovo agent in an automation rule, you’ll need to write a default prompt — in the same way you’d prompt an agent directly. Each time the rule is triggered, this prompt is sent to the agent on your behalf.

As long as the object in your prompt matches the object from your chosen trigger, the appropriate context will be provided.

If the trigger is Work item created, your prompt in Use Rovo agent might be:

Read and review the quality of the description field for this work item.

In this example, when the rule (and the agent) is triggered, the URL of the relevant work item is provided to the agent as context. The agent would analyze the quality of the work item’s description field and generate a response.

Add a second action – with text output

To use the agent’s response, you must add a second action that can leverage it. That is, it’s not enough to add a Rovo agent to a rule — you have to give it another action to execute.

This means if you want the agent to add its response as a comment, you have to add the Add comment action — whether or not an agent’s profile contains the Add comment skill.

And since the agent’s response is text-based, you must choose actions that generate text output. Think of it as if you were chatting with the agent — the response would appear as text in the Chat window.

Use the smart value, {{agentResponse}}

Once you select a compatible secondary action, type the smart value {{agentResponse}} in the configuration field. This inserts a uniquely generated response each time the rule runs.

Automated agents assume your app permissions since they operate on behalf of the rule creator. So for example when the {{agentResponse}} generated by the first action, Use rovo agent, becomes the comment that is added by the second action, Add comment — the agent only adds comments to pages you have access to.

The comment is attributed to the agent by default, but if you prefer you can reassign the author. For example, you can configure the Add comment action so the comment is attributed to you (the rule creator) rather than the agent. A note will still indicate that an agent auto-generated it.

Rule examples