Configure advanced agent workflow controls
Advanced agent workflow controls is an open beta feature available on Standard, Premium and Enterprise Jira plans.
Advanced agent workflow controls let you choose when an agent runs on a workflow transition and what happens when it finishes. You can:
Run an agent only when a work item meets conditions you set, such as a certain priority or work type.
Move the work item through a follow-on transition when the agent finishes.
You can use these options with the Trigger agent action to automate handoffs between agents and people without needing to write a separate automation rule.
Conditional execution is also available for other built-in rules under Perform actions, not just Trigger agent.
Turn on advanced agent workflow controls
You must be a Jira admin to enable and disable beta features.
To turn on the feature:
Select Settings (), then System.
Select Beta features from the side navigation.
Select the Advanced agent workflow controls toggle to turn on the feature.
Open the advanced agent options
You can set up advanced agent workflow controls from the workflow editor or from a board.
From the workflow editor
Select Settings (), then Work items.
Select Workflows from the side navigation.
Find the workflow you want to edit and select More actions (), then select Edit.
Select the transition you want to change.
Under Perform actions, select Trigger agent.
Select Edit rule, then select More options.
From a board
Go to the board for your space.
Hover over a column, then select the agent badge.
Select the agent.
Select More options.
Run an agent only when conditions are met
By default, the agent runs every time a work item moves through the transition. You can set conditions that a work item must meet before the agent runs.
Open the advanced agent options from either the workflow editor or a board.
For Apply, select Conditionally.
To create a condition using the condition builder, select the Editor toggle to turn it off.
Select Add condition.
Select a field (such as Priority or Work type), then choose an operator and one or more values.
Select Done. The agent now runs only when the condition is true.
If you choose more than one value for a field, the condition is true when the work item matches any of them. For example, Priority = Highest, High is true for work items with either priority.
Write a condition as a Jira expression
For more complex conditions, you can write a Jira expression instead.
Open the advanced agent options from either the workflow editor or a board.
For Apply, select Conditionally.
Check that the Editor toggle is turned on.
Enter your expression. For example,
["Highest", "High"].includes(issue.priority.name).Select Done. The agent now runs only when the condition is true.
The condition builder supports the following fields:
Work type
Priority
Assignee
Reporter
Label
Status
Parent
Space
The Editor view stays on when the condition builder can't display the expression. This happens when the expression does any of the following:
Groups conditions in parentheses.
Combines AND and OR.
Uses functions or numbers.
Uses a field that the condition builder doesn't support.
Move a work item through a follow-on transition
A follow-on transition moves the work item automatically when the agent finishes. For example, you can move a work item to In review after an agent drafts a response.
Open the advanced agent options from either the workflow editor or a board.
For Once finished, select a transition.
Select Done or Update.
If no follow-on transition has been configured, the default is Do nothing else. The list of options shows the transitions that can leave the destination status of the transition you're editing.
How follow-on transitions work
The follow-on transition runs as the person who made the original transition.
If the agent is waiting for input, the follow-on transition waits until the person who made the original transition approves.
A follow-on transition can start another agent. If that agent has a follow-on transition, it runs too.
When a follow-on transition doesn't run
A follow-on transition doesn't run when:
The work item is no longer in the destination status of the original transition.
A workflow admin changed the rule, and it no longer names the follow-on transition.
Another follow-on transition already ran for the work item.
More than 5 hours have passed since the original transition.
Was this helpful?