OpenAI は開発者ドキュメントで正式に Agents API をリリースし、Codex の harness を OpenAI がホストする REST API を通じて公開しました。コアエンドポイントは1つだけです:POST https://api.openai.com/v1/agents/sessions で、OpenAI-Beta: agents=v1 ヘッダーを付ける必要があります。意味は明確です——OpenAI はセッションの管理、ワークフローの編成、コンテキストの圧縮と復元を担当し、アプリケーションはツールの提供や実行環境の決定を担当します。
4つの主要なコンセプトと1つのホスティング機能
ドキュメントではコンセプトを4つに分類しています:Agent(モデル + 指示 + ツール + MCP サーバー)、Environment(オプションのサンドボックスまたはコンピュータ、Agent がファイルを読み書きしたり、スキルをロードしてコマンドを実行する場所)、Session(永続的な Agent のインスタンスで、タスクを処理し入力を応答するもの)、そして Events と items(セッション中に発生する入出力)。ワークフローは、セッションを作成→タスクを割り当て→ストリームまたは webhook でフォローアップ→継続または介入するという流れです。
ホスティングされた harness 機能には、サンドボックス内でコマンドやコードを実行し、スキルや指示を適用し、ツールや MCP を通じて外部データに接続し、作業中いつでも介入可能で、過去のコンテキストを圧縮し、サブエージェントにサブタスクを委任し、中断後に再開できる機能が含まれます。マルチエージェントは agent.multi_agent で有効化でき、max_concurrent_subagents を設定できます。ツールは programmatic_tool_calling、mcp(HTTP トランスポート)および web_search の3種類をサポートしており、環境は self_hosted または OpenAI がホストするサンドボックスを選択できます。
データは米国のみ対応、ZDRはサポートされず、コミュニティがベンダーロックインを懸念
料金はモデルに従います:モデルの使用量は選んだモデルに基づいて請求され、OpenAI のツールは標準価格、ホスティングされたサンドボックスはコンテナ価格となります。しかし、2つのデータ面での制限に注意が必要です——データの保存は現在アメリカに限定されており、Zero Data Retention(ZDR)はサポートされていません。自ホスティングされたサンドボックスを選んでも、ZDR準拠にはなりません。SDK は Python、TS/JS、Go、Java、Ruby に対応しており、統一された記述は client.beta.agents.sessions.create(...) です。
コミュニティでの議論は主に2点に焦点を当てています:セッションを OpenAI にホストすることの価値、および料金体系の曖昧さ。あるユーザーはサンドボックスのネットワークアクセス設定をテストし、enabled / disabled / restricted の3つのモードがあることを確認しました。制限されたネットワークでは外部ドメインへのアクセスは「Domain forbidden」と返されます。また、課金方法について疑問を投げました——各エージェントセッションごとに新しい環境が作成されるのか、環境は少なくとも1時間単位で課金されるのか、節約のために手動で終了できるのか。
この API を使用する理由として、自分で SDK を走らせるよりもどうして使うのかについては、意見が分かれています。疑問を投げた人々は「これはむしろベンダーロックインを強化しているように見える」と述べました。一方、支持者にとっては現実的です——「自分自身でサンドボックス VM を維持する手間を省けるから」。アーキテクチャの観点から見ると、Agents API の本質は Codex クライアントのための harness をサーバーサイド化し、長期間実行可能な、ファイルを読み書きでき、サブタスクを分割できるエージェントを、あらゆるバックエンドプログラムが呼び出せる第一級の API にするものです。その代償は、セッションの状態と実行環境を OpenAI に渡すことです。
VIP会員