Rovo agent tools

Tools are what agents use to take their responses and do something with them.

For example, here are some tools that a custom Rovo agent could perform in Confluence:

The agent will only allow the person to publish in spaces they have permission to create content in, and to edit or archive content they have the appropriate permissions for. Currently, permission control for creating, writing, or deleting content is not supported. However, assigning specific tools to agents can indirectly control their operational capabilities.

スペース名、ページ タイトル、形式などの不足している詳細情報をユーザーに求めてから、公開を許可する前にプレビューの確認 (編集オプション付き) を求めます。

There are dozens of different tools that agents can perform, you can see the full list of tools while you’re creating or editing an agent of your own. Otherwise, you’ll see the tools a particular agent can perform by viewing its profile page.

While there are many tools to choose from when you’re creating or editing an agent, try creating your agent for a very specific use case. We recommend selecting fewer than 5 tools for each agent.

To give your agent specific tools while creating or editing an agent:

1. サイド メニューからサブエージェントを選択します。

2. Navigate to the Tools section, and select Add tools.

3. Browse all tools, search for them by name, or filter by app.

4. Select checkboxes for the tools you want to include.

5. [保存] を選択します。

Tools will appear in your agent's profile so people browsing for agents can find the one best suited for their needs.

Use tools while chatting to an agent

チームメイトに依頼するのと同じように、エージェントにも依頼してください。次に例を示します。

• 「調査要約の記述に関する作業項目を Jira で作成してください」

• 「「今週の要約」という名前の Confluence ページを作成してください」

• 「このインシデントの PIR Confluence ページを作成してください」

• 「このプロジェクトの作業項目に対してエピックを提案してください」

• 「この作業項目を In progress ステータスに移動してください」

• 「この作業項目についてコメントし、説明に改善の余地があれば提案してください」

• 「このプロジェクトで似たような要約を含むリクエストを検索してください」

Some tools have limitations or require fields a user will need to provide the agent. For example:

• Jira の一括アクションは現時点では一度に 20 件の作業項目までに制限されています。

• Jira で作業項目を作成する際、必須フィールドがあれば追加の入力が必要になる場合があります。

• エージェントを通じて作成するカレンダー招待は、一度に 4 人までに制限されています。

The agent will respond asking for confirmation. No matter the tool, you’ll be asked to confirm it. Sometimes, for things like deleting information, you’ll be asked to confirm again.

Third-party tools for agents

Tools that allow an agent to act outside of an Atlassian app require that you connect your Atlassian account with the third-party product the first time you use it. Doing so ensures that that agent can’t access information or do anything that you wouldn’t normally be able to do. In other words, it ensures the agent has the access required to work on your behalf and no additional access.

During the connection process, you'll be redirected to the third-party authentication page where you can grant access. Once you’ve granted access, you can continue using that tools in future chats and won’t need to authenticate again.

Any third-party tools performed by an agent will appear as if it was performed by you, the user of the agent. For example, if you ask an agent to send a Slack message, the message will appear as if you sent it.

アクセス権を取り消すには、次の手順に従います。

上部のナビゲーション バーにあるプロファイル アバターから [アカウント] メニューに移動します。

1. [アカウントを管理] を選択します。

2. [接続済みのアプリ] タブに移動します。

3. アクセス権を取り消すサードパーティ アプリを選択します。

You can re-authenticate later if you change your mind and want the agent to perform third-party tools again in the future.

Create your own tool with Forge

Developers using Forge can now publish their tool modules for use by Rovo agents that have been created by users in an organization. This allows customer-created agents to access data that the app itself might not have been able to reach, without writing code. If you publish your own tool module, it will only be visible to your organization or, if you choose, it can be published on the Atlassian Marketplace.

Learn more about creating tools as a developer