これら4つの名前は異なるレイヤーに位置し、1つの問いがそれらを分けています。それは「誰がエージェントループを実行するのか?」という問いです。Responses APIはモデル呼び出しであり、その周りのループはあなたのコードが実行します。Agents SDKは、ランナーがアプリケーション内でループを実行するTypeScriptおよびPythonライブラリです。2026年9月10日から公開ベータ版となっているAgents APIは、OpenAIのCodexハーネスを実行し、セッションとオプションでサンドボックスを維持します。AgentKitは、2025年10月にリリースされたAgent Builder、ChatKit、Connector Registry、およびEvalsのバンドルであり、Agent Builderは2026年11月30日にシャットダウンされる予定です。
9月29日のDevDayでAgents APIにコンピューター利用機能が追加され(DevDay 2026まとめを参照)、命名に関する問題を無視できなくなりました。以下に、ループ、コンピューティング、状態、価格、成熟度に関する比較、意思決定表、および手動で作成したResponsesループからの移行パスを示します。セッションと承認に関する実践的な手順については、OpenAI Agents APIガイドをお読みください。どちらを選択しても、HTTPインターフェースはApidogでテスト可能です。
OpenAIエージェントのオプション比較
| Agents API | Responses API | Agents SDK | AgentKit | |
|---|---|---|---|---|
| 何であるか | Codexハーネス上のマネージドエージェントランタイム | モデルエンドポイント、POST /v1/responses |
TypeScriptおよびPython用ライブラリ | バンドル: Agent Builder, ChatKit, Connector Registry, Evals |
| 誰がループを実行するか | OpenAI | あなたのコード | あなたのアプリ内のSDKランナー | Agent Builderワークフロー、SDKコードにエクスポートまたはChatKitに組み込み |
| どこでコンピューティングが実行されるか | OpenAIホスト型サンドボックス、独自のサンドボックス、またはなし | あなたの環境、およびホスト型ツール | あなたのランタイムとサンドボックスプロバイダー | 該当なし |
| どこで状態が保持されるか | OpenAIセッション: 設定、ターン、アイテム | あなたの履歴、previous_response_id、またはConversations API |
あなたのストレージ、SDKセッション、またはResponsesの状態 | 公開され、バージョン管理されたワークフロー |
| 支払い内容 | トークン、ツール、ホスト型コンテナ; 追加料金なし | トークンとツール | トークンとツール、およびあなたのホスティング費用 | 基盤となるAPIの使用料; 個別のサブスクリプションなし |
| 統合の労力 (OpenAIによる) | 低 | 高 | 中 | 評価なし |
| ステータス | 公開ベータ版 (OpenAI-Beta: agents=v1) |
すべての新規プロジェクトに推奨 | 現行 | Agent BuilderとEvalsは2026年11月30日にシャットダウン予定; ChatKitは継続 |
| データ制御 | 米国データレジデンシーのみ; ZDR非対象; 削除されるまで状態を保持 | ZDR対象(制限あり); 地域別エンドポイント | 呼び出すAPIに依存 | 該当なし |
出典: OpenAIのエージェントランタイム比較、Agents API概要、および非推奨ページ。
誰がループを実行するのか
これが他のほとんどの行を決定する軸となります。
Responses API: あなたが実行します。ウェブ検索、ファイル検索、コードインタプリタ、リモートMCPなどのホスト型ツールは、1つのリクエスト内で複数の呼び出しを実行できますが、独自の関数はあなたに戻されます。モデルが関数を呼び出すと、function_callアイテムを受け取り、それを実行し、次のリクエストで同じcall_idを持つfunction_call_outputを送信します。いつ停止するか、履歴をどのように保存するか(レスポンスはデフォルトで保存されますが、store: falseでオフにできます)、そしてcontext_managementとcompact_thresholdを使用して長いコンテキストをいつ圧縮するかを決定します。Responses APIガイドと関数呼び出しガイドがそのループについて説明しています。
Agents SDK: あなたのプロセスが実行します。OpenAIのドキュメントによると、SDKのランナーは「エージェントループとハンドオフを処理」し、一方、あなたのサーバーがデプロイメント、ツール実装、状態ストレージ、承認決定を所有します。サンドボックスエージェントを使用すると、コマンドがUnixローカル、Docker、またはホスト型プロバイダーのワークスペースで実行されている間、ハーネスはあなたのインフラストラクチャ内に留まることができ、認証、監査ログ、人間のレビューはコンテナの外に保持されます。
Agents API: OpenAIが実行します。マネージドハーネスはセッション、オーケストレーション、コンテキストの圧縮、およびリカバリを処理し、さらにサブエージェント、ツール検索、プログラムによるツール呼び出しを追加します。リモートMCPサーバーはOpenAIによって直接呼び出されます。あなたのコードは引き続き関数ツールを処理します。セッションがrequired_actionsでfunction_callを報告すると、turn_idとcall_idを含むagent.session.input.tool_resultイベントを返します。
同じタスクを、両方の方法で:
# Responses API: 1回のモデル呼び出し; あなたのコードがループを所有
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"reasoning": {"effort": "low"},
"tools": [{"type": "web_search"}],
"input": "Summarize the breaking changes in the latest Node.js release."
}'
# Agents API: 永続的なセッション; OpenAIがループを所有
curl https://api.openai.com/v1/agents/sessions \
-H "OpenAI-Beta: agents=v1" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
"environment": {"type": "none"},
"input": "Summarize the breaking changes in the latest Node.js release."
}'
Agents APIドキュメントの例ではgpt-6-astraを使用しています。他のモデルが受け入れられるかどうかは明記されていないため、gpt-6.1-solに置き換える前に確認してください。
コンピューティング、状態、コスト
コンピューティング。Agents APIは、セッション全体のためにサンドボックスをプロビジョニングおよび管理できます。environment.typeをopenai_hosted、self_hosted、またはnoneに設定します。SDKを使用する場合、サンドボックスプロバイダーはあなたが選択し、費用を支払います。Responsesでは、ホスト型ツールを除き、コードはあなたが実行する場所で実行されます。
状態。Agents APIセッションは、OpenAI側で設定、ターン、アイテムを保持するため、フォローアップは同じセッションIDに対する1つのイベントとなります。Responsesでは、previous_response_idを連結するか、Conversationsを使用します。SDKでは、状態はあなたのストレージまたはSDKセッションに保存されます。
コスト。各オプションは同じモデルを呼び出すため、トークン価格はどこでも同じです。Agents APIは「追加料金なし」とされていますが、ホスト型コンテナは20分セッションあたり0.03ドル(1GB)から0.48ドル(16GB)の費用がかかります。SDKの追加費用は、あなたのホスティング費用です。当社のAgentKit解説によると、AgentKitには個別のサブスクリプションはありません。
データ。Agents APIは米国のデータレジデンシーのみをサポートしており、自己ホスト型サンドボックスを使用した場合でもゼロデータ保持(ZDR)をサポートしていません。OpenAIのデータ管理ページには、/v1/agentsはZDRの対象外で、削除されるまで状態が保持されると記載されています。一方、/v1/responsesは制限付きでZDRの対象であり、eu.api.openai.comなどの地域別エンドポイントで利用可能です。ZDRまたはEUレジデンシーが要件である場合、Agents APIは現時点では除外されます。
2026年後半のAgentKit: 残されたもの
AgentKitは2025年10月6日に4つの要素としてリリースされました。それぞれの状況は以下の通りです。
- Agent Builder: 2026年6月3日に非推奨が発表され、2026年11月30日にシャットダウン予定。OpenAIの移行ガイドでは、ワークフローをAgents SDKコードとしてエクスポートするか、ビジネス、エンタープライズ、または教育機関向けのChatGPT Workspace Agentとして再作成する方法が示されています。
- Evals: 既存の評価は2026年10月31日に読み取り専用になり、ダッシュボードとAPIは11月30日にシャットダウンされる予定です。
- ChatKit: 組み込みチャットとして引き続き利用可能です。
- Connector Registry: OpenAI製品全体のコネクタおよびMCPサーバーの管理パネル。
当社のAgentKitガイドが述べているように、AgentKitを介した耐久性のあるコードファーストのパスはAgents SDKです。
どれを基盤にするか
| 選択肢 | 時期 |
|---|---|
| Agents API | タスクが数分間実行され、ファイル、コマンド、またはブラウザが必要で、ループ、サンドボックス、セッションストレージの運用を望まない場合。米国レジデンシーとベータヘッダーが許容できる場合。 |
| Responses API | 単一の呼び出しを行い、すべてのターンを制御したい場合、ZDRまたは米国以外のデータレジデンシーが必要な場合、またはすでに機能するループがある場合。 |
| Agents SDK | 型付きアプリケーションコードがツール、ストレージ、承認、ハンドオフを所有する必要があり、ループがあなたのインフラストラクチャで実行されなければならない場合。 |
| ChatKit | 製品に組み込みチャットUIが必要な場合。 |
| Agent Builder | ここから開始しないでください。2026年11月30日までに既存のワークフローをエクスポートしてください。 |
AWSでは、OpenAIを搭載したBedrock Managed Agentsが、Agents APIのコア機能をAWSでネイティブに実行できるようにします。どちらのコードファーストパスでもMCPの配線については、OpenAIエージェントによるMCPサーバーを参照してください。
独自のResponsesループからAgents APIへの移行
Responsesでループを構築しており、OpenAIにその実行を任せたい場合:
- 要素をマッピングします。命令、モデル、ツールは
agentに移動し、コンテナはenvironmentになり、会話ストアはセッションIDになります。 - リモートMCPサーバーを
agent.toolsに移動します。それらのトークンはプロンプト内ではなく、vault_idsでアタッチされたボールトに配置します。 - 関数処理を書き直します。
function_call_outputループを、agent.session.input.tool_resultを返すagent.session.requires_action(ストリーム)またはagent.session.action_required(ウェブフック)のハンドラに置き換えます。サブエージェントは関数ツールを呼び出せないため、それらはメインエージェントに残しておきます。 - 圧縮コードを削除します。ハーネスはコンテキストを自動的に圧縮します。
- イベントに切り替えます。ターンの結果(
agent.session.turn.completed,agent.session.turn.failed,agent.session.turn.cancelled)をストリームするか、ウェブフックを使用します。アイドル状態のセッションが成功を意味するわけではありません。 - 制約を確認します。米国レジデンシーのみ、ZDRなし、およびベータヘッダーが必要です。
Apidogプロジェクトで両方を管理する
切り替える前に、古いものと新しいものを並行して実行してください。1つのApidogプロジェクト内で、ResponsesフォルダーとAgents APIフォルダーを作成し、{{OPENAI_API_KEY}}とモデル変数を持つ環境を共有させます。両方に同じプロンプトを送信し、ステータスコードと必須出力フィールドをアサートし、Agents APIストリームをSSEリクエストとして開いてターンイベントを監視します。これらの実行をテストシナリオとして保存し、Apidog CLIを使用してCIで実行することで、ベータ版の変更が失敗したチェックとして表示されるようにします。本番AIエージェントの信頼性ガイドには、アサートすべき内容が記載されています。Apidogをダウンロードして設定してください。
よくある質問 (FAQ)
Agents APIはResponses APIに置き換わるものですか? 非推奨の発表はありません。OpenAIのエージェント概要では、Agents API、Agents SDK、Responses APIが異なるニーズに対応する現在のオプションとして挙げられています。
OpenAI AgentKitは非推奨ですか? 部分的にそうです。Agent BuilderとEvalsは2026年11月30日にシャットダウンされる予定ですが、ChatKitは引き続き利用可能です。
Agents SDKはAgents APIを使用しますか? いいえ。SDKはあなたのアプリケーション内で実行され、Agents APIはOpenAIのサービス内でマネージドハーネスを実行します。
Assistants APIはどうなりましたか? OpenAIの非推奨ページによると、2026年8月26日に削除される予定であり、開発者にはResponsesおよびConversations APIの使用が推奨されています。
最も安価なオプションはどれですか? トークン価格はすべてで一致しています。違いは、Agents API上のホスト型コンテナと、SDKまたはResponsesでの自己ホスティングとの費用です。
今週中に1つのパスを選択する
誰がループを実行すべきかに基づいて選択し、アプリを開発する前にリクエストでそれを検証してください。もし新しく始めるのであれば、1つのAgents APIセッションを試して、Apidogで現在のResponsesの設定と比較してください。
