Skip to main content
A subagent is an internal agent that another agent can hand work to. Instead of building one agent that knows everything, you build focused agents, each with its own instructions, tools and Skills, and let a lead agent delegate to them. For example, a concierge agent can send one guest request to a restaurant-booking agent and a transfer agent at the same time, then combine their answers.

When to use subagents

  • The job has distinct parts. Each part needs different tools or knowledge, such as one agent for your PMS and another for your vendor list.
  • Parts can run in parallel. The lead agent can start several tasks at once and keep working while they run.
  • You want to reuse an agent. A well-tuned “owner report” agent can serve several lead agents.
  • The lead agent’s context is getting crowded. A subagent does its research separately and returns only the result.

Choose an agent’s subagents

1

Open the lead agent

Open the agent that should delegate, and select the Settings tab.
2

Add subagents

Under Subagents, search for the agents it can hand work to and turn on their switches.
3

Save

Select Save in the save bar.
The Subagents section with a search box and switches for General purpose and other internal agents
Turn on the switch next to each agent the lead agent can use. The list offers: Both customer agents and internal agents can have subagents. Only internal agents can be subagents.
Give each subagent a clear description of what it’s for. You can edit an agent’s name and description at the top of its builder. A specific description, such as “Books restaurant tables through OpenTable”, helps you and the lead agent tell subagents apart.

How delegation works

When the lead agent hands off a task, it writes the subagent a prompt describing what to do. The subagent runs with its own instructions, tools and Skills, then reports its result back to the lead agent.
  • A task can run while the lead agent waits, or in the background while the lead agent carries on.
  • A subagent can ask the lead agent a question mid-task, then continue once it gets an answer.
  • If a task fails, the lead agent can retry it or resume it with a follow-up.
  • Background tasks can finish after the lead agent’s turn ends. When they do, the lead agent picks up their results and continues.
In a chat with an internal agent, each delegated task appears as a card with its status, prompt, activity and result. See Subagent tasks.

Things to keep in mind

  • Subagents use their own tools. An internal agent working as a subagent can only do what its own Tools tab allows, not what the lead agent’s allows.
  • Check the usage. Each task card shows how much work the subagent did, so you can spot tasks that are more expensive than expected.
  • Deleted agents drop out. If you delete an agent, lead agents stop seeing it as a subagent.