OpenAIは、Codexエージェントハーネスの背後にあるオーケストレーションレイヤーをホスト型サービスとしてパッケージ化したAgents APIを導入しました。そのコンセプトは明快です。モデル呼び出しの周囲に独自のハーネスを構築する代わりに、APIを呼び出すことで、OpenAIがセッション、オーケストレーション、コンテキストの圧縮、およびリカバリを管理します。ユーザーのアプリケーションはツールを提供し、実行環境を選択する役割を担います。
この記事の主題はOpenAIによってリリースされた製品であり、このマークは記事が引用しているドキュメントのページ自体に表示されています。OpenAIのAgents APIを紹介する冒頭の段落の後に配置され、呼び出し側がツールを提供し実行環境を選択する間、セッション、オーケストレーション、コンテキストの圧縮、およびリカバリを管理するベンダーを特定しています。
Agents APIは4つの概念を中心に構築されています。エージェントとは、モデル、その指示、使用可能なツール、および到達可能なMCPサーバーの総称です。環境とは、エージェントがファイルにアクセスし、スキルをロードし、コマンドを実行するためのオプションのサンドボックスまたはコンピュータです。セッションとは、タスクを実行し入力に応答するエージェントの持続的なインスタンスです。イベントおよびアイテムは、セッション中にエージェントに送信される入力と、エージェントが生成する出力です。
セッションは明確なシーケンスに従います。アプリケーションがセッションを作成してエージェントを構成すると、OpenAIがその環境をプロビジョニングします。アプリケーションがエージェントにタスクを与え、環境の準備が整い次第、ユーザー入力によって作業のターンが開始されます。アプリケーションは、出力をストリーミングするか、Webhookを使用してエージェントの完了や入力の必要性を把握することで進捗を追跡します。その後、同じセッションに別のタスクを送信するか、現在のターン中にエージェントをガイドすることができます。OpenAIがホストするセッションでは、OpenAIがエージェントを実行し、サンドボックスをプロビジョニングおよび管理する間、アプリケーションは入力を送信しイベントを受信します。
この図は、セッションのシーケンス（セッションの作成と構成、OpenAIによる環境のプロビジョニング、タスクの送信、エージェントの完了や入力の必要性を把握するための出力ストリーミングまたはWebhookの使用、およびターン中のエージェントのガイド）を説明する第3段落と直接対応しています。図自体の説明でも、OpenAIがハーネスを実行しサンドボックスをプロビジョニングする間に、アプリケーションがセッションを開始しイベントと出力を受信していることを示していることが確認されており、段落で説明されているフローを正確に図示しています。
ドキュメントによると、管理されたハーネスが提供する機能には、サンドボックス内でのコマンドおよびコードの実行、関連するスキルと指示の適用、ツールやMCPを通じた外部データへの接続、作業中のエージェントの操縦、およびコンテキストを管理するための過去の作業の要約が含まれます。価格設定は選択したモデルのAPI料金に従い、OpenAIツールは標準料金で、OpenAIホストのサンドボックスは標準的なコンテナ料金で請求されます。
環境の選択は主要な設計上の決定事項です。クイックスタートではOpenAIホストのサンドボックスがデフォルトのパスとなっており、呼び出し側が何もプロビジョニングすることなく、エージェントがディレクトリツリースクリプトを作成して実行できます。セルフホストのサンドボックスも利用可能であり、ドキュメントでは呼び出し側が制御する環境でエージェントを実行するためのオプションとしてリストされています。この区別は重要です。なぜなら、実行環境の所有者が誰であるかが変わり、それがデータの所在、ネットワークアクセス、およびコンプライアンスの姿勢に影響を与えるからです。
ドキュメントでは、抽象的な機能よりも具体的なユースケースを中心にAPIを構成しています。それらには、アラートを調査してリカバリアクションの承認を求めるインシデント対応エージェント、接続された職場ツールを使用してリクエストを調査するSlackボット、読み取り専用SQLでウェアハウスの質問に答えるデータアナリスト、報告されたバグを再現してGitHubに調査結果を共有するGitHubイシュー調査員、およびポリシースキルと専門エージェントを使用してドキュメントをレビューするドキュメントレビュアーが含まれます。
2つの重要な注意点があります。第一に、Agents APIは独立したモデル製品ではありません。それはOpenAIのモデルカタログの上で動作するハーネスおよびオーケストレーションレイヤーであり、コストと能力はエージェントに構成されたモデルに依存します。第二に、このリリースに関する実質的なソースはドキュメントのみです。それはOpenAIが製品ができると主張している内容を確立していますが、独立した検証、第三者のベンチマーク、または本番環境における信頼性、レイテンシ、故障率に関する証拠は提供していません。セルフホストのサンドボックスオプションはドキュメントのナビゲーションには記載されていますが、概要テキストでは深く説明されていないため、その正確な構成、制限、およびセキュリティモデルは提供された資料では特定されていません。