Orchestration & Sub-Agents

Pattern

Sub-Agent Orchestrator

Custom Agent implementation demonstrating the Agent interface abstraction with an orchestrator that routes queries to specialized sub-agents (research, analysis, support). Shows options passing and structured outputs.

IntermediateNov 2025View the full pattern on desktop
Sub-Agent Orchestrator preview

Problems solved

  • Implement a custom Agent that routes to specialized sub-agents
  • Pass typed options into research, analysis, and support agents
  • Return structured outputs from the orchestrator layer
  • Delegate queries without collapsing specialists into one prompt

Use cases

  • Multi-agent support systems
  • Research versus analysis routing
  • Custom Agent interface tutorials
  • Specialist delegation architectures

AI SDK APIs

ToolLoopAgentcreateAgentUIStreamResponsetool(Output.objectstepCountIsgatewayInferAgentUIMessage

Tags

aiagentsorchestratorai-sdkcustom-agentsub-agentsroutingoptionsstructured-output

Requirements

Node.js
24+
Memory
512MB
Other
  • OpenAI API key
  • Exa API key

Environment variables

External services

openaiexa

Ready to use?

View the full interactive pattern with live preview and copy the source code.

View the pattern on desktop

Related patterns

Orchestrator-Worker PatternCoordinate multiple worker agents for project management. Handles task distribution, progress tracking, and result synthesis.Oct 2025
Research Agent ChainSequential three-agent chain demonstrating structured outputs flowing between agents. Research Agent 1 gathers research, Expand Agent 2 expands research, Synthesis Agent 3 synthesizes final answer. Uses Exa tools and AI SDK 6's stabilized structured output support.Nov 2025
HIL Inquire Multiple ChoiceGather information through AI-driven multiple choice questions. Includes approval workflows and real-time rendering.Oct 2025
HIL Inquire Text InputGather detailed information through AI-driven text input questions. Includes approval workflows and real-time rendering.Oct 2025