πŸͺ†A team behind one agent

Sub-agents & delegation

One agent can't be an expert at everything β€” and a single huge system prompt gets brittle. Sub-agents let you compose a team of focused specialists behind one entry point, coordinated by a supervisor that routes each request to the right expert.

What sub-agents are

A sub-agent is just another saved agent that a parent agent is allowed to delegate to. You add sub-agents in step 5 of the builder. Each sub-agent keeps its own model, system prompt, knowledge, and tools β€” so a research specialist can run a web-search-heavy model while a writer runs a different one, all under the same parent.

The supervisor pattern

When an agent has sub-agents, it becomes a supervisor. Instead of answering directly, it interprets the request, decides which specialist (or specialists) should handle each part, delegates the work, and then merges the results into one coherent answer. The person asking sees a single agent; behind the scenes a coordinated team did the work.

πŸ™‹RequestComes in to the supervisor
🧠SupervisorPlans and routes the work
πŸ”ResearcherGathers facts via web + knowledge
✍️WriterDrafts from the research
🧾Merged answerSupervisor combines and returns
A supervisor delegates to specialist sub-agents, then merges their results into one response.

Why delegate instead of building one big agent

BenefitWhy it matters
FocusEach sub-agent has a tight system prompt and only the tools it needs, so it performs its one job better than a generalist.
Right model for the jobA reasoning-heavy researcher and a fast drafter can run on different models from your six configured providers β€” chosen per sub-agent.
ReuseA sub-agent is a normal agent, so the same specialist can be shared across many supervisors instead of duplicated.
MaintainabilityImproving one specialist improves every team it belongs to, without touching the others.

A worked example

Imagine a Content Desk supervisor for your marketing team. You give it three sub-agents:

  • Researcher β€” web search plus a knowledge folder of past campaigns; gathers facts and references.
  • Writer β€” a strong drafting model with your brand voice baked into its system prompt and an on-brand skill attached.
  • Reviewer β€” checks the draft against guidelines and flags anything off-message.

A teammate asks the Content Desk for a launch announcement. The supervisor sends the brief to the researcher, hands the findings to the writer, routes the draft through the reviewer, and returns a finished, on-brand announcement β€” all from one request.

ℹ️
How delegation runs

The supervisor pattern executes on the same LangGraph runtime as every other agent and workflow. The supervisor and its sub-agents are coordinated as a graph, so routing, delegation, and merging all happen inside one managed run with shared budgets and event streaming.

πŸ’‘
Keep the supervisor thin

Give the supervisor a clear routing prompt β€” when to use each sub-agent and how to combine their output β€” and let the specialists hold the deep instructions. A thin supervisor over focused experts is easier to reason about and to improve over time.