How to configure the Use Rovo agent action
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 flow.
For agents to work autonomously, they must be managed through your existing Confluence space or Jira Space administrators via an automation flow.
Without automations and setup by an admin, agents can’t work autonomously.
Here’s some tips to help you configure the Use Rovo agent action with confidence.
Provide proper context in your prompt
After you select the agent you want to use, you need to write a prompt for it. Each time the flow is triggered, this prompt gets sent to the agent on your behalf.
To provide the agent with appropriate context, mention the object from the trigger. For example, if the trigger is Work item created, mention “work items”.
Your prompt might be:
Read and review the quality of the description field for this work item.
You can also add {{smart values}}, which may generate a more predictable response:
Read and review the quality of
{{workitem.description}}.
Smart values are dynamic variables that make your flow more flexible. Each smart value is written as a hierarchy, starting with a top-level object and followed by properties of that object, {{object.property.subProperty}}.
In this prompt example, when the flow (and the agent) is triggered, the URL of the relevant work item is provided to the agent as context. The agent will analyze the quality of the work item’s description field and generate a response.
Add a second action that can publish text
The next step is to add a second action that can leverage the agent’s response.
Since the agent’s response is text-based, you must choose actions that can publish that text as a comment, a page, or an email, for example.
Think of it as if you were chatting with the agent. The response would appear as text in the chat window. The action you add is just redirecting to where you want the response to appear.
This means if you want the agent to add its response as a comment, you have to choose the Add comment action.
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 flow runs.
Formatting of the {{agentResponse}} defaults to rich text markdown, but can be changed by adding properties.
Automated agents operate on your behalf as the flow creator, and therefore assume your app permissions automatically.
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, and you appear as the author.
Was this helpful?