← All examplesEnterprise support
// Orchestration
Synchronous agent handoff via `delegate_to_agent`
During runTeam / runTasks, pool agents register the built-in delegate_to_agent tool so one specialist can run a sub-prompt on another roster agent and read the answer in the same conversation turn.
01 Run it
OMA APIs
OpenMultiAgentFrom a clone of the repo — this exact file:
npx tsx packages/core/examples/patterns/agent-handoff.ts
Prerequisites
- ANTHROPIC_API_KEY
OMA is provider-agnostic — this example is written for the key above, but you can run it on OpenAI, Gemini, Groq and others. All providers →
Open the complete, synchronized source · 64 lines
The complete example, synchronized from the pinned Framework commit.
/*** Synchronous agent handoff via `delegate_to_agent`** During `runTeam` / `runTasks`, pool agents register the built-in* `delegate_to_agent` tool so one specialist can run a sub-prompt on another* roster agent and read the answer in the same conversation turn.** Whitelist `delegate_to_agent` in `tools` when you want the model to see it;* standalone `runAgent()` does not register this tool by default.** Run:* npx tsx packages/core/examples/patterns/agent-handoff.ts** Prerequisites:* ANTHROPIC_API_KEY*/import { OpenMultiAgent } from '../../src/index.js'import type { AgentConfig } from '../../src/types.js'const researcher: AgentConfig = {name: 'researcher',model: 'claude-sonnet-4-6',provider: 'anthropic',systemPrompt:'You answer factual questions briefly. When the user asks for a second opinion ' +'from the analyst, use delegate_to_agent to ask the analyst agent, then summarize both views.',tools: ['delegate_to_agent'],maxTurns: 6,}const analyst: AgentConfig = {name: 'analyst',model: 'claude-sonnet-4-6',provider: 'anthropic',systemPrompt: 'You give short, skeptical analysis of claims. Push back when evidence is weak.',tools: [],maxTurns: 4,}async function main(): Promise<void> {const orchestrator = new OpenMultiAgent({ maxConcurrency: 2 })const team = orchestrator.createTeam('handoff-demo', {name: 'handoff-demo',agents: [researcher, analyst],sharedMemory: true,})const goal ='In one paragraph: state a simple fact about photosynthesis. ' +'Then ask the analyst (via delegate_to_agent) for a one-sentence critique of overstated claims in popular science. ' +'Merge both into a final short answer.'const result = await orchestrator.runTeam(team, goal)console.log('Success:', result.success)for (const [name, ar] of result.agentResults) {console.log(`\n--- ${name} ---\n${ar.output.slice(0, 2000)}`)}}main().catch((err) => {console.error(err)process.exit(1)})
// Learn the concepts
// Enterprise
Taking this to production?
open-multi-agent is MIT-licensed and free to run yourself. When you need it delivered, integrated, or supported on a deadline, 元定义科技 (YuanASI) offers commercial delivery and support.