AI・機械学習

OpenAI Agents API

OpenAI Agents API (developers.openai.com)

328 pointsby aquir2026年9月11日168 コメント

要約

OpenAIが新たに発表したAgents APIは、アプリケーションにCodexハーネスへのアクセスを提供します。このAPIは、セッション管理、オーケストレーション、コンテキスト圧縮、リカバリなどをOpenAIが担当し、アプリケーション側はツール提供や実行環境の選択を行います。エージェントはコード実行、ファイル編集、外部サーバー接続などが可能なサンドボックス内で動作でき、インシデント対応、データ分析、GitHub issue調査など多様なユースケースが想定されています。

全文翻訳

Agents API

Agents APIは、OpenAI管理のAPIを通じて、アプリケーションにCodexハーネスへのアクセスを提供します。

OpenAIはセッション、オーケストレーション、コンテキストの圧縮、リカバリを管理し、アプリケーションはツールを提供し、実行環境を選択します。

Agentsは、コードを実行し、ファイルを編集し、MCPサーバーに接続し、アーティファクトを生成できるサンドボックス内で動作できます。

エンドポイント、リクエストパラメータ、レスポンスフィールドについては、APIリファレンスを参照してください。

価格

モデルの使用料金は、選択したモデルのAPI料金に基づいて請求されます。OpenAIツールは標準料金を使用し、OpenAIホストのサンドボックスは標準のコンテナ料金を使用します。

例を試す

これらの完全な例を試してください。

ディレクトリツリースクリプトを作成して実行する](https://developers.openai.com/api/docs/guides/agents-api/quickstart#1-run-a-task)OpenAIホストのサンドボックスで。
リリースノートをサブエージェントと比較し、それらの結果を1つの回答にまとめます。

完全なアプリケーションを探る:

インシデント対応エージェント: アラートを調査し、復旧アクションの承認をリクエストします。
Slackボット: 接続されたワークプレイスツールを使用してリクエストを調査します。
データアナリスト: 読み取り専用SQLでデータウェアハウスの質問に答えます。
GitHub issue investigatorを使用して、報告されたバグを再現し、GitHub上で調査結果を共有します。
ドキュメントレビュアーを使用して、ポリシー機能と専門エージェントでドキュメントを確認します。

コアコンセプト

Agents APIは、4つの主要なコンセプトを中心に構築されています。

Agent: エージェントが利用できるモデル、指示、ツール、MCPサーバー。
Environment: エージェントがファイルにアクセスし、スキルをロードし、コマンドを実行する、オプションのサンドボックスまたはコンピューター。
Session: タスクに取り組み、入力に応答するエージェントの永続的なインスタンス。
Events and items: エージェントに送信される入力と、セッション中に生成される出力。

最初から最後までの一連のセッション

クイックスタートでOpenAIホストのサンドボックスから始めます。

セッションを作成する。 エージェントを設定します。OpenAIがその環境をプロビジョニングします。
タスクを与える。 環境が準備できたら、ユーザー入力が作業のターンを開始します。
進捗を追跡する。 出力をストリーミングするか、Webhookを使用して、エージェントが終了したか、入力が必要になったかを確認します。
続行または指示する。 同じセッションに別のタスクを送信するか、現在のターン中にエージェントを誘導します。

OpenAIホストのセッションでは、アプリケーションは入力を送信しイベントを受信し、OpenAIはエージェントを実行し、サンドボックスをプロビジョニングおよび管理します。環境オプションでセットアップと制限を確認してください。

［画像: Your application starts sessions and receives events and output from the Agents API. OpenAI runs the managed Codex harness and provisions and manages its sandbox.］

マネージドハーネスが提供するもの

マネージドCodexハーネスは以下をサポートします。

サンドボックスでのコマンドとコードの実行。
関連するスキルと指示の適用。
ツールまたはMCPを介した外部データへの接続。
作業中のエージェントの誘導。
コンテキストウィンドウを管理するための以前の作業の要約。
作業をサブタスクに分割し、サブエージェントに委任する。
セッションを中断したところから再開する。

APIキーの権限とSDKセットアップについては、クイックスタートの前提条件を確認してください。セッションを作成する際にこれらの機能を設定します。

from openai import OpenAI

client = OpenAI()

session = client.beta.agents.sessions.create(
    agent={
        "model": "gpt-6-astra",
        "instructions": "Use the OpenAI documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful.",
        "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": "Research how to connect an MCP server to an OpenAI agent, check for recent updates, and summarize the recommended setup.",
                }
            ],
        }
    ],
)
print(session.id)

実行時の比較については、Agents overviewを参照してください。

Agents API上に構築されたAWSサービスについては、Bedrock Managed Agentsを参照してください。

Agents APIはセッション状態を保持するため、会話コンテキストを再構築することなく、ターンをまたいで作業を継続できます。セッションと公開されたアーティファクトは、不要になったときに削除できます。Agents APIは現在、米国のみでデータレジデンシーをサポートしており、ゼロデータリテンション（ZDR）はサポートしていません。セルフホストサンドボックスを選択しても、Agents APIはZDRの対象とはなりません。OpenAIプラットフォームのデータコントロールで、データレジデンシーと保持に関する詳細を確認してください。