OpenAI Agents APIリリース – 永続的なクラウドエージェント用のマネージドハーネス

TL;DR

OpenAIのAgents APIは、コードを実行し、ツールにアクセスし、セッション間で状態を維持できる永続的なエージェントを構築するためのマネージド、クラウドホステッドなハーネスを提供します。OpenAIホステッドとセルフホステッドの両方のサンドボックス環境をサポートしています。

Agents APIとは

Agents APIは、新しいOpenAIマネージドエンドポイントであり、エージェントハーネスの構築と運用の複雑さを抽象化します。Codexランタイムをプロビジョニングし、セッション状態を管理し、コンテキストの圧縮を処理し、組み込みツール（ウェブ検索、関数呼び出し、MCP接続、プラグイン、バウル）を提供します。開発者はエージェントのモデル、指示、ツール、およびオプションのサンドボックス設定を定義するだけで済みます。

コアコンセプト（自己完結型）

エージェント – モデル（例：gpt-6-astra）、システム指示、およびエージェントが呼び出せるツールの組み合わせ。
環境 – オプションのサンドボックス（OpenAIホステッドまたはセルフホステッド）で、ファイルシステム、機能ディレクトリ、コードや外部コマンドの実行が可能。
セッション – セッション間で状態を永続化するエージェントの耐久インスタンス。イベントのストリーミング、Webhook、ターン中でのエージェントの制御が可能。
イベントとアイテム – セッションを通過する離散的な入力（ユーザーのメッセージ、ツール呼び出し）と出力（応答、アーティファクト）。

"Agents APIは、OpenAIが管理するAPIを通じてアプリケーションにCodexハーネスへのアクセスを提供します。OpenAIがセッション、オーケストレーション、コンテキストの圧縮、復旧を管理し、アプリケーションはツールを提供し、実行環境を選択します。" – OpenAIドキュメント

クイックスタート概要（自己完結型）

セッションの作成 – エージェント定義と環境設定を提供。OpenAIがサンドボックスをプロビジョニング。
タスクの提出 – 環境が準備できたら、最初のユーザーのメッセージがターンを開始。
進行状況の監視 – イベントのストリーミングまたはWebhookコールバックを受信して、エージェントの完了や追加入力の必要性を把握。
継続または制御 – 同じセッションに追加の入力を送信するか、現在のターン中にエージェントを導く。

APIはsession.idを返します。このIDは後続のターンで再利用でき、インシデント対応、データ分析、コードレビューなどの長時間実行ワークフローを可能にします。

料金モデル（自己完結型）

モデル使用料 – 選択したモデルの標準料金で課金（例：gpt-6-astra）。
ツール使用料 – OpenAIの標準ツール料金で課金。
サンドボックスホスティング – 組み込みツールに記載のコンテナ料金で課金。
データの所在 – 現在は米国に限定。セルフホステッドサンドボックスであっても、Zero Data Retention（ZDR）はサポートされていません。

セッション作成の例（自己完結型）

以下のPythonの最小限の例は、セルフホステッドサンドボックス、ウェブ検索、MCPツールを備えたセッションを作成し、最大4つの並行サブエージェントを有効にしています。

from openai import OpenAI

client = OpenAI()

session = client.beta.agents.sessions.create(
    agent={
        "model": "gpt-6-astra",
        "instructions": "OpenAIドキュメントのMCPとウェブ検索を使って、技術的な質問に正確に回答する。有用な場合は独立した調査タスクをサブエージェントに委任する。",
        "tools": [
            {"type": "programmatic_tool_calling"},
            {"type": "mcp", "server_label": "openai_docs", "transport": {"type": "http", "server_url": "https://developers.openai.com/mcp"}},
            {"type": "web_search"},
        ],
        "multi_agent": {"enabled": True, "max_concurrent_subagents": 4},
    },
    environment={
        "type": "self_hosted",
        "workspace_directory": "/workspace",
        "capability_directories": ["/workspace/capabilities/skills"],
    },
    input=[
        {"role": "user", "content": [{"type": "input_text", "text": "MCPサーバーをOpenAIエージェントに接続する方法を調査し、最近の更新を確認し、推奨されるセットアップを要約してください。"}]}]
)
print(session.id)

同じリクエストはJavaScript、Go、Java、Ruby、または生のcurlでも表現可能。ドキュメントには言語固有のスニペットが提供されています。

重要なコミュニティの反応（自己完結型）

抽象化の成熟度 – ユーザーはOpenAIがエージェントの正しい抽象化をまだ試行錯誤していると指摘。マネージドハーネスは、開発者が独自のオーケストレーション、メモリ、コンテキスト管理レイヤーを構築する必要を回避できる。

"エージェントとしてのサービスは、必要なツールを接続できる…しかし、メモリやコンテキスト管理のようなハーネスの深い部分をカプセル化し、継続的に改善し続けることができます。" – bluesnowmonkey
セルフホスティングの魅力 – サンドボックスをセルフホステッドできる点は、ベンダーロックインを懸念するチームにとって大きな利点と見なされています。

"そこに隠れてますが、サンドボックスをセルフホステッドすることも選べます…これにより、ずっと魅力的になります。" – 6thbit
ロックインの懸念 – 複数のコメント者が、データの所在、ZDRの欠如、個人のOpenAIサブスクリプションをAPIで使用できない点に懸念を示しています。

"このAPIでは、あなたのサブスクリプションを使うことはできません。そのため、おそらく大手企業だけが本当にこれを使えるでしょう。" – krashidov
既存ツールとの比較 – 一部のユーザーはAgents APIが既存のResponses APIやLangGraphなどのSDKと重複していると主張する一方、他のユーザーはOpenAIのより耐久的な優位性への一歩だと捉えています。

"私は、通常のLLMエンドポイントとエージェント/ハーネスの間の境界が意味をなさなくなると思います…コンピュータを与えれば、それで終わりです。" – brap
ユースケースの検証 – 早期採用者はインシデント対応ボット、Slackアシスタント、データアナリストエージェント、GitHubのイシュー調査エージェントを構築しており、APIの多様性を示しています。

Agents APIとDIYハーネスの使い分け（自己完結型）

シナリオ	Agents APIの利点	DIY / SDKの利点
迅速なプロトタイピング	サンドボックスのライフサイクル管理不要。OpenAIがすべてをプロビジョニング。	環境、カスタムツール、コスト最適化に対する完全な制御。
エンタープライズのコンプライアンス	マネージドセキュリティ、サンドボックスの分離、OpenAIホステッドの監視。	サンドボックスを企業のファイアウォールの後ろにホストし、厳格なデータローカリティルールを満たせる。
数千の並行エージェントへのスケーリング	OpenAIがオーケストレーション、マルチエージェント並行処理、セッション永続性を処理。	自分でスケジューラーとスケーリングレイヤーを構築しなければならない。
細かいコスト制御	モデル、ツール、コンテナごとの明確な課金。	コンテナを即座に停止し、アイドル料金を回避できる。

未解決の質問とオープンソース代替案（自己完結型）

ゼロデータ保持（Zero Data Retention） – APIはZDRをサポートしていません。厳格なデータ削除が必要な開発者は、独自のハーネスを構築する必要があります。
モデルのロックイン – 今のところOpenAIモデルに限定されています。競合他社は、モデルに依存しないプラグインを備えた同様のマネージドハーネスを提供する可能性があります（例：Flue、Eve、FastAgent）。
コミュニティSDK – OpenAI Agents SDKはAPIを模倣していますが、ローカルホスティングにさらに柔軟性を提供します。多くのユーザーは、より厳密な制御のためにSDKを好むと報告しています。
料金の明確さ – サンドボックス課金の仕組み（最小時間単位、終了の意味）について、まだ不明な点があります。

最後に（自己完結型）

OpenAIのAgents APIは、サンドボックスのプロビジョニング、セッション永続性、マルチエージェントオーケストレーションを抽象化した、即戦力のマネージドエージェントハーネスを提供します。独自のインフラを構築せずに、迅速にエージェント機能を提供したいチームにとって特に有用です。同時に、より高いセキュリティを求める場合に、オプションのセルフホステッドサンドボックスも提供しています。コミュニティからのフィードバックは、利便性への期待とベンダーロックイン、データの所在、料金の透明性に関する懸念の両方を示しています。開発者は、スケール、コンプライアンス、コスト制御の要件に基づいて、マネージドサービスとDIY SDKのどちらを選ぶべきかを検討すべきです。