Skip to main content

Invoke an agent as a tool

Learn how to call an agent as a tool from another agent.

Version: Cloud and 3.227 Edge

You can configure your agent to use another agent as a tool. This is useful for situations in which you have one agent that performs a narrowly-scoped task, and you want another agent that to reuse that capability.

Using an agent as a tool does not copy the agent—it creates a new trigger for the existing agent. Any changes that you make to an agent that is referenced as a tool persist in all uses of that agent.

For example, a marketing team wants to create an agent that helps them with providing discount codes based on the item catalogue and inventory. If the sales team already has an agent that evaluates whether to send discount emails to customers, the marketing team can use that agent as a tool.

Features​

Key features of agents as tools include:

  • Minimize duplicate work by leveraging existing agents.
  • Outsource certain decision-making to a more specialized agent.

Configure an agent as a tool​

Complete the following steps to configure an agent as a tool:

  1. Create a new agent or navigate to an existing agent. Open the Configuration tab.
  2. In the Tools section, click the + Add Tool button.
  3. Select Use Agent.
  4. On the Use Agent page, select the agent that you want to use, or choose to create a new one.
  5. The Name setting auto-populates with the name of the agent. Rename the tool if you choose, and add a description.
  6. Click Save.