Multi-agent (Responses API)

ルートエージェントが複数のサブエージェントに作業を委任し、各サブエージェントは同時に作業を進めます。オーケストレーションをアプリケーション側で実装せずに、複数の作業の分担と統合を API に任せる場面に関わります。

ルートエージェントの名前は /root で、起動されたサブエージェントには階層的なパスが付きます。サブエージェントはリクエストのモデルと利用可能なツールを共有し、エージェント同士は spawning (起動)、messaging (メッセージ送信)、waiting (待機) などの協調用の基本操作で連携します。ツリー内のすべてのエージェントが、API リクエストのモデル呼び出しで設定したツールを使えます。

• Multi-agent モードを有効にすると、Responses API は 6 種類のホスト型の協調アクションを提供します。これらは multi_agent_call アイテムとして現れる場合があります。アプリケーションはこれらを実行せず、出力も送信しません。
• 一方、ツリー内のどのエージェントも function_call を出す場合があります。アプリケーションはその呼び出しを実行し、対応する function_call_output を送信する必要があります。
• Multi-agent の応答には、追加の出力アイテムとして multi_agent_call、multi_agent_call_output、agent_message の 3 種類が含まれる場合があります。

max_concurrent_subagents は、エージェントツリー全体で同時に動作できるサブエージェントの最大数を設定します。この数には子・孫やさらに深い階層のサブエージェントがすべて含まれ、ルートエージェントは含まれません。

HTTP と WebSocket は同じ Multi-agent の機能に対応しています。ツールを多く使うワークフローや長時間のワークフローには、WebSocket が推奨されています。

• HTTP では、エージェントが開発者定義の関数を呼び出した場合、保留中の呼び出しをすべて実行し、その出力を含む継続リクエストを作成します。
• WebSocket では、関数の出力が得られた時点で、実行中の応答の完了を待たずに応答へ注入できます。接続は Python の beta SDK では client.beta.responses.connect、TypeScript の beta SDK では ResponsesWS で開き、接続ヘッダーに OpenAI-Beta: responses_multi_agent=v1 を渡します。
• WebSocket では、response.created イベントの応答 ID を保存し、その応答に送るすべての response.inject イベントに含めます。関数の結果は response.inject イベントで実行中の応答に送り、応答が完了し、すべての注入が response.inject.created または response.inject.failed を返すまで読み取りを続けます。
• response.inject.failed が response_already_completed を返した場合は、失敗イベントで返された input を、完了した応答から続ける新しい response.create リクエストで送ります。

• multi_agent.enabled を true にすると、リクエストで context_management を設定していなくても、サーバー側の自動 compaction (コンテキストの圧縮) が暗黙に有効になります。compaction はルートエージェントと各サブエージェントに個別に適用され、それぞれのコンテキストは分かれたまま保たれます。
• Multi-agent を有効にすると、ルートエージェントとサブエージェントに、システムが指示を新しい developer message として自動で追加します。この指示は編集も削除もできません。

Multi-agent はベータとして提供されています。GPT-5.6 で Responses API 向けに追加され、GPT-6.1 Sol もベータで対応しています。対象プランについては、公式のリリースノートには記載がありません。

HTTP リクエストで Multi-agent を有効にする基本の流れです。

1. HTTP リクエストでは client.beta.responses を使い、betas 引数に responses_multi_agent=v1 を渡します。
2. Responses API のリクエストで multi_agent.enabled を true に設定し、Multi-agent を有効にします。
3. developer message を追加し、ルートのモデルがどのような場合にサブエージェントを起動するかを調整します。