エージェントは、ツールを使ってタスクを計画し、完了まで進めることができます。他のエージェントと連携し、ステップ間でコンテキストを維持することもできます。オーケストレーションをどこで実行するか、タスク間の状態を誰が管理するかに応じて、ランタイムを選んでください。
目的別のガイド
| 目的 | 最初に読むガイド |
|---|---|
| OpenAI が管理する Codex ハーネスでエージェントを実行する | Agents API |
| 再利用可能なエージェント、ツール、ハンドオフを使い、アプリケーション内でエージェントループを制御する | Agents SDK |
| モデルの応答を直接扱い、アプリケーションとの統合を自分で制御する | Responses API |
| アプリケーションにチャットを組み込む | ChatKit |
エージェントランタイムの比較
| Agents API | Agents SDK | Responses API | |
|---|---|---|---|
| 用途 | OpenAI がエージェントを管理し、進捗を保存する長時間のタスク | アプリケーション内で独自のツールやワークフローを使うエージェントの構築 | モデルの直接呼び出し、またはエージェントのゼロからの構築 |
| エージェントの実行場所 | OpenAI が運用するマネージド Codex ハーネス上で実行 | アプリケーション内で SDK が動作 | アプリケーション内で実行。ホスト型オーケストレーションも利用可能 |
| エージェントの統合にかかる工数 | 少ない | 中程度 | 多い |
| タスク間の状態管理 | セッション設定、ターン、項目を保存 | アプリケーション側のストレージと SDK セッション、または Responses API の会話状態 | 履歴の手動管理、応答の連鎖、または Conversations |
| ツールの実行 | サービスに接続されたツール、アプリケーション側の関数ハンドラー、必要に応じてサンドボックス | アプリケーション内で設定したツールと連携機能 | ホスト型ツールとアプリケーション側で実行するツール |
| 実行環境 | OpenAI がホストするサンドボックス、セルフホスト型サンドボックス、またはサンドボックスなし | アプリケーション側のランタイムとサンドボックスプロバイダーとの連携 | 独自の実行環境 |
| 最初に読むガイド | Agents API の概要 | Agents SDK の概要 | Responses API ガイド |
Agents API は Codex ハーネスを実行し、エージェントの基盤となるインフラを管理します。そのため、開発者はエージェントに何をさせるかに集中できます。コンテキストの自動コンパクション、複数のエージェントのオーケストレーション、プログラムによるツール呼び出し、MCP サーバーに対応しています。詳しくはアーキテクチャを参照してください。
Agents SDK では、デプロイ、ストレージ、承認、ランタイムとの統合をアプリケーション側で管理できます。SDK のランナーがエージェントループとハンドオフを処理します。詳しくはエージェントの実行を参照してください。
ツール、スキル、プロンプトキャッシュの導入
ツールの設計、再利用可能なスキル、プロンプトキャッシュは、さまざまなエージェントワークフローに共通します。設定方法やライフサイクルは API によって異なる場合があります。
- Function Calling、MCP、ホスト型の機能については、まずツールの使用を参照してください。
- JavaScript によるオーケストレーションと各 API の設定方法については、プログラムによるツール呼び出しを参照してください。
- 再利用可能な指示と、サポートされている読み込み方法については、スキルを参照してください。
- まずプロンプトキャッシュで各 API に共通するキャッシュの動作を確認し、次に Agents API の可観測性と使用量でセッションごとの使用量の集計方法を確認してください。
Agents API のセッション、SDK のセッション、Responses API の会話、サンドボックスは、それぞれ別のリソースです。選んだランタイムの手順に従って、状態の管理とクリーンアップを行ってください。