# Sub-agents

Sub agents let one agent call another active agent in the same workspace as a tool.

## Overview

You add sub agents from the same picker you use for MCP tools. After you attach one, it appears as its own node in the editor and gets its own settings sheet. This is useful when you want a parent agent to hand off a specific job to another agent instead of keeping all instructions in one place.

## How do I add a sub agent? <a href="#add-sub-agent" id="add-sub-agent"></a>

1. Open the parent agent in the editor.
2. Click the button with the tooltip **Add MCP Tool or Sub Agent**.
3. In the picker, open **Sub Agents** and choose the child agent you want to attach.
4. Review or update **Tool Name**. Fetch Hive only allows lowercase letters, numbers, and underscores here.
5. Add a **Tool Description** that explains when the parent agent should use this sub agent.
6. Click **Add Sub Agent**.

The new sub agent appears as a node on the canvas as soon as Fetch Hive saves it.

## How do I configure a sub agent node? <a href="#configure-sub-agent-node" id="configure-sub-agent-node"></a>

1. Select the sub agent node in the editor.
2. Update **Tool Name** or **Tool Description** in the settings sheet if needed.
3. Click **Open in Editor** if you want to open the child agent in its own editor tab.

If you need to remove the sub agent, hover over its node and use the remove action. Fetch Hive asks you to confirm with **Remove sub agent?** and **Remove sub agent**.

## What limits should I know about? <a href="#sub-agent-limits" id="sub-agent-limits"></a>

Only other active agents in the same workspace appear in **Sub Agents**. Fetch Hive does not let you add the current agent as its own sub agent. If an agent is already attached, the picker shows it as unavailable instead of adding it again. Items marked **Soon** in the picker are not available yet.

For the main editor flow, see [Creating and Configuring](https://docs.fetchhive.com/agents/creating-and-configuring). To test how a parent agent uses its sub agents, see [Testing with Chat](https://docs.fetchhive.com/agents/testing-with-chat).
