AgentsSubagents

You are viewing the docs for Archestra v1.4. View the latest docs

Subagents

Split big tasks across specialists. An agent, the parent, can hand part of a task to another agent, its subagent, and use the result. The parent decides on its own when to delegate.

A subagent can be:

  • An agent you built, such as a researcher or a reviewer.
  • An external agent on another system, over A2A.

Add Subagents

  1. Open the parent agent and go to Tools, Skills & Knowledge.
  2. Under Subagents, choose Manual and select the agents.
  3. Save, and send a task in Chat that needs one of them.

What to know:

  • All agents lets the parent agent use any agent the person can access, including agents created later. To leave one out, click Exclude a local agent. External agents are never added this way.
  • External agents are added after the parent agent is created. See External Agents.
  • Subagents must share the parent agent's environment.
  • Automated runs, with no signed-in person, use only the agents you selected.
  • For long coding tasks, pick a subagent with a dedicated runtime.

Fork the Agent

Keep long searches and noisy tool output out of the conversation. Every agent can hand a task to a fresh copy of itself, and only the copy's answer comes back. You don't need to set this up.

What to know:

  • The copy has the same tools and instructions, but none of the conversation. The agent writes everything the copy needs into the task.
  • A copy cannot fork again.

Get Trusted Answers From Untrusted Data

Let a subagent read untrusted data, such as inbound email or a web page, without the parent losing trust. With Guardrails on, a parent can ask for a structured answer, such as a number of days or one choice from a fixed list. An answer that matches comes back at the parent's own trust.

What to know:

  • The parent names the answer's shape when it delegates. Every field must be bounded: a number in a range, a yes or no, or a fixed list of values. Free text is never accepted.
  • An answer that does not match is withheld. The parent gets an error, never the raw text.
  • External agents cannot return structured answers.

Explore