Add scenarios to a Rovo agent

Adding subagents 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 subagents to your agent to help provide separate sets of instructions that prompt your agent to behave a certain way or perform particular tasks.

Creating and Managing Subagents and subagents for Your Agent

Before you create subagents, 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 subagents triggers, if none match, the agent will use the instructions from its default subagents to respond.

Add a subagent 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 subagents.

5. Provide a name for the subagent so you and any editors of the agent can identify it easily and understand its purpose.

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

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

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

Add the first subagent to a new agent

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

1. From Overview of an in progress agent select

2. Select Default subagent in the subagents section

3. Provide a name and description for the subagent so you and any editors of the agent can identify it easily and understand it’s purpose.

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

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

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

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

Replace an agent's default subagent

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

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

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

To make a new subagent the default:

• Choose the subagent 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 subagent, you’ll need to add a custom trigger to it, so your agent knows when to use those instructions.

To edit an existing subagent’s triggers

1. Choose the subagent 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 subagent the default subagent.