# 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](/agents/creating-and-configuring.md). To test how a parent agent uses its sub agents, see [Testing with Chat](/agents/testing-with-chat.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fetchhive.com/agents/sub-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.