openai · OpenAI Platform Docs
Agents Orchestration and handoffs | OpenAI API
Explains how to manage multi-agent workflows by implementing orchestration patterns and handoff mechanisms between specialized agents.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Agents Orchestration and handoffs | OpenAI API
Explains how to manage multi-agent workflows by implementing orchestration patterns and handoff mechanisms between specialized agents.
When To Use
Use when designing multi-agent systems that require delegating tasks between specialized models or managing complex conversational flows through handoffs.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/agents-orchestration-and-handoffs-openai-api-workflow-guide.md | A guide explaining orchestration patterns and handoff strategies for multi-agent workflows using the OpenAI API. | Questions about a guide explaining orchestration patterns and handoff strategies for multi-agent workflows using the OpenAI API. |
examples/agents-orchestration-and-handoffs-openai-api-openai-agents-orchestration.text | A JavaScript code example demonstrating how to define multiple agents and configure handoffs between a triage agent and specialized billing or refund agents. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to define multiple agents and configure handoffs between a triage agent a... |
examples/agents-orchestration-and-handoffs-openai-api-openai-agents-orchestration-2.text | A Python code example demonstrating how to define multiple agents and configure handoffs between them using the OpenAI Agents API. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to define multiple agents and configure handoffs between them using the OpenA... |
examples/agents-orchestration-and-handoffs-openai-api-openai-agents-orchestration-3.text | A JavaScript code example demonstrating how to define multiple agents and configure one agent to use another as a tool for orchestration and handoffs. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to define multiple agents and configure one agent to use another as a too... |
examples/agents-orchestration-and-handoffs-openai-api-openai-agents-orchestration-4.text | A Python code example demonstrating how to define multiple agents and configure tool-based handoffs between them. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to define multiple agents and configure tool-based handoffs between them. |
What This Skill Covers
- Multi-agent workflows are useful when specialists should own different parts of the job. The first design choice is deciding who owns the final user-facing a...
- Main sections:
Choose the orchestration pattern,Use handoffs for delegated ownership,Use agents as tools for manager-style workflows,Add specialists only when the contract changes,Next steps.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/agents/orchestration