Add scenarios to a Rovo agent

Adding scenarios to an agent can help you make more complex and powerful agents to accomplish a variety of tasks.

While it’s typically recommended for an agent to have quite a specific purpose, when you start creating an agent, you might have in mind ways that it can help its users in different situations or with different tasks. You can add scenarios to your agent to help provide separate sets of instructions that prompt your agent to behave a certain way or perform particular tasks.

Context routing: how the agent decides which scenario to run

Before you create scenarios, it’s helpful to understand how they will work. When someone sends a prompt to your agent, or when your agent receives a prompt through an automation, it will check to see if the prompt matches any of the agent’s scenario triggers, if none match, the agent will use the instructions from its default scenario to respond.

Add a scenario to an existing agent

1. Navigate to the Atlassian Studio app in the app switcher.

2. Select Agents from the left-side navigation to see a list of the agents you’ve created.

3. Choose the agent you’d like to edit

4. Select View all scenarios.

5. Provide a name for the scenario so you and any collaborators on the agent can identify it easily and understand its purpose.

6. Write a trigger for the scenario by prompting the agent on when it should run the scenario.

7. Add the instructions, actions, and knowledge you’d like the agent to use in this scenario.

8. When you’re finished designing the scenario, select Save

Add the first scenario to a new agent

When you are creating a new agent, you’ll be encouraged to add a default scenario to the agent, before adding additional scenarios. See more on how to create an agent

1. From Overview of an in progress agent select

2. Select Default scenario in the Scenarios section

3. Provide a name and description for the scenario so you and any collaborators on the agent can identify it easily and understand it’s purpose.

4. Skip the section labeled Trigger as default scenarios don’t use triggers.

5. Add the instructions, actions, and knowledge you’d like the agent to use in this scenario.

6. When you’re finished designing the scenario, toggle it on to enable it.

Repeat this process, for adding more scenarios to a new agent. When you add more than one scenario, you’ll need to start adding triggers so the agent knows how to choose which scenario to run.

Replace an agent's default scenario

An agent must have a default scenario, and it can only have one default scenario. It ensures the agent knows how to generally behave when no specific scenarios match. You can imagine a default scenario as the general instructions, actions, and knowledge you want your agent to use when no trigger has been invoked.

The first set of instructions, actions, and knowledge you add to your agent will be its default scenario. There may be a need to replace the default scenario with a different one as you grow and develop your agent’s goals and capabilities.

You can make any scenario the default scenario and you determine whether a scenario is the default when you select its triggers.

To make a new scenario the default:

• Choose the scenario you’d like to change, and click on its name to edit it.

• Scroll to the section labelled Trigger

• Select Set as default

If you still want your agent to use the previous default scenario, you’ll need to add a custom trigger to it, so your agent knows when to use those instructions.

To edit an existing scenario’s triggers

1. Choose the scenario you’d like to change, and click on its name to edit it.

2. Scroll to the section labelled Trigger

3. Edit the custom trigger, or make the scenario the default scenario.