> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conduit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Subagents

> Let an agent hand parts of a job to specialized internal agents or a general-purpose agent, and follow each delegated task in the chat.

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](https://mintcdn.com/conduit-58d85182/Dxa79236R9TzscJw/images/internal-agents/subagents-settings.png?fit=max\&auto=format\&n=Dxa79236R9TzscJw\&q=85\&s=f400479c14ce66f26a74765dfd853988)

Turn on the switch next to each agent the lead agent can use. The list offers:

| Option | What it is |
| - | - |
| **General purpose** | A built-in agent for a wide variety of tasks, including research, analysis and writing. The lead agent uses it when no specialized subagent fits. |
| Your internal agents | Any other internal agent in the workspace. An agent can't be its own subagent. |

Both customer agents and internal agents can have subagents. Only internal agents can be subagents.

> [!TIP]
>
> 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](https://docs.conduit.ai/build-your-agent/agents/internal-agents/chat-and-activity.md#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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.