Sub-agents
Add another agent from the same workspace as a callable tool inside an agent
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?
Open the parent agent in the editor.
Click the button with the tooltip Add MCP Tool or Sub Agent.
In the picker, open Sub Agents and choose the child agent you want to attach.
Review or update Tool Name. Fetch Hive only allows lowercase letters, numbers, and underscores here.
Add a Tool Description that explains when the parent agent should use this sub agent.
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?
Select the sub agent node in the editor.
Update Tool Name or Tool Description in the settings sheet if needed.
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?
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. To test how a parent agent uses its sub agents, see Testing with Chat.
Last updated