Mihata
AI活用2026.09.12

OpenAI Agents APIとは|Codex基盤とZDR非対応の壁

OpenAI は2026年9月10日Agents API をパブリックベータで公開しました。ひとことで言えば、Codex のハーネス(エージェントを動かす土台)を、OpenAI が運用する API としてそのまま借りられる仕組みです。セッションの管理、オーケストレーション、コンテキストの圧縮、中断からの復帰まで OpenAI 側が持ち、開発者はツールと実行環境を渡すだけで済みます。

一方で、日本企業が導入を検討するなら真っ先に見るべき制約があります。Agents API は現時点でデータ所在地が米国のみで、ゼロデータ保持(ZDR)に対応していません。しかも自前のサンドボックスを選んでも ZDR 対象にはなりません。この記事では、何ができるのか・既存の Agents SDK や Responses API とどう違うのか・費用はどう積み上がるのかを、OpenAI 公式ドキュメントの記載だけで整理します。

Agents API とは何か(3行でわかる要点)

公式の説明は明快で、「Agents API は、OpenAI が管理する API を通じて Codex ハーネスへのアクセスを提供する」というものです。構成要素は4つに整理されています。

概念

中身

Agent(エージェント)

モデル・指示文・ツール・接続する MCP サーバーの定義

Environment(環境)

ファイル操作やコマンド実行を行うサンドボックス。任意

Session(セッション)

タスクを処理し入力に応答し続ける、永続的なエージェントの実体

Events / Items

エージェントへの入力と、セッション中に生成される出力

管理ハーネスが面倒を見てくれるのは、サンドボックスでのコマンド・コード実行、スキルと指示の適用、ツールや MCP 経由での外部データ接続、作業中のステアリング、コンテキストウィンドウを管理するための過去作業の要約、サブエージェントへのタスク分割と委譲、そして中断したセッションの再開です。自作のエージェント基盤で最も手のかかる部分が、そのまま API 側にあります。

Agents SDK・Responses API とどう使い分けるか

OpenAI はエージェント向けに3つのランタイムを並行して提供しており、公式ドキュメントに比較表があります。要点だけ抜き出すと次のとおりです。

Agents API

Agents SDK

Responses API

向いている用途

OpenAI がエージェントを動かし進捗を保存する長時間タスク

自分のアプリ内で独自ツール・ワークフローを組む

モデルを直接呼ぶ/ゼロから組む

エージェントが動く場所

OpenAI が管理する Codex ハーネス

SDK が自社アプリ内で動く

自社アプリ(ホスト型オーケストレーションは任意)

統合の手間

低い

中くらい

高い

タスク間の状態

セッション設定・ターン・アイテムが保存される

自前ストレージ、または Responses の会話状態

手動の履歴管理・レスポンス連鎖・Conversations

実行環境

OpenAI ホストのサンドボックス/自前サンドボックス/なし

自社ランタイムとサンドボックス連携

自前の実行環境

判断の軸はシンプルです。「エージェントのループを自分で握りたいか、預けたいか」。握りたいなら Agents SDK、預けて構わないなら Agents API、そもそもエージェントではなくモデル呼び出しで足りるなら Responses API、という並びになります。統合コストが最も低いのは Agents API ですが、後述する制約とのトレードオフになります。

なお、2026年8月26日に終了した Assistants API とは別物です。あちらの移行先は Responses API と Conversations API で、Agents API は置き換え先として案内されているわけではありません。移行の経緯はAssistants API の終了と Responses API への移行手順にまとめてあります。

★導入前に必ず見る制約:米国限定・ZDR非対応

ここが今回いちばん重要です。公式ドキュメントには次のように書かれています。

Agents API は現時点で米国のデータ所在地のみをサポートし、ゼロデータ保持(ZDR)には対応していません。自前ホストのサンドボックスを選んでも、Agents API が ZDR の対象になることはありません。

つまり「実行環境を自社に置けばデータ residency の問題は解決する」という直感が、ここでは通用しません。サンドボックスをどこに置くかと、セッションの状態が OpenAI 側にどう保持されるかは別の話だからです。Agents API はセッションの状態を保持することで「前回の続きから再開できる」価値を出しているので、この性質は設計上ほぼ不可分です。

実務での線引きはこうなります。

  • 顧客の個人情報や機微な業務データを扱う本番ワークフロー: 現時点では Agents API を第一候補にしない。ZDR が必要なら Responses API 側で組む。
  • 社内の調査・要約・レポート生成など、外に出ても致命傷にならない業務: 統合コストの低さが効くので有力。
  • データ所在地に規程がある業種: 米国のみという条件が社内規程を通るかを、実装前に法務・情報システムへ確認する。

セッションと公開した成果物は不要になれば削除できるとも明記されています。ただし「削除できる」ことと「保持されない」ことは別なので、ZDR が要件に入っている場合は削除機能で代替できない点に注意してください。ZDR そのものの仕組みはOpenAIのゼロデータ保持(ZDR)で何が変わるかで整理しています。

料金はどう積み上がるか

Agents API には「セッション利用料」という独立した課金がありません。公式の記載では、費用は次の3つの合算です。

費目

単価の考え方

モデル利用

選んだモデルの通常 API 料金(GPT-6 Astra なら Astra の単価)

OpenAI のツール

Web 検索・ファイル検索などの標準レート

OpenAI ホストのサンドボックス

コンテナの標準レート。1GB $0.03/4GB $0.12/16GB $0.48/64GB $1.92(20分セッション・コンテナあたり)

見積もりで外しやすいのはコンテナです。エージェントは人間より長くセッションを開けたままにするので、「20分あたり」の単位が効いてきます。対象となるコンテナセッションは分単位課金・1セッションあたり最低5分という条件も公式に明記されているため、短いタスクを大量に走らせる設計では最低課金が積み上がります。自前のサンドボックスを使えばこのコンテナ費用は発生しませんが、前述のとおり ZDR 対象にはなりません。

もう一点、サブエージェントを有効にすると同時実行数の分だけモデル利用が増えます。公式サンプルでは max_concurrent_subagents を4に設定していますが、この数字はそのまま費用の倍率だと考えておくのが安全です。

試すときの前提(ここでつまずきやすい)

クイックスタートに書かれている前提条件は3つです。手を動かす前に確認しておくと早いです。

  • API キーの権限スコープ: セッション操作に api.agents.readapi.agents.write、モデル推論に api.responses.write が必要です。既存のキーを流用すると権限不足で弾かれます。
  • ベータヘッダ: リクエストには OpenAI-Beta: agents=v1 が必要です。公式 SDK は自動で付けますが、cURL で叩くときは自分で書きます。
  • API キーをサンドボックスの中に置かない: 公式が明示的に注意している点です。エージェントがコマンドを実行できる環境に認証情報を置くのは、そのまま事故につながります。

エンドポイントは https://api.openai.com/v1/agents/sessions、SDK では beta.agents 名前空間です。ベータの名前空間が付いている=仕様が変わりうるということなので、本番のコードに直接埋め込むのではなく、薄いラッパーを1枚挟んでおくことをおすすめします。

公式には、インシデント対応エージェント、Slack ボット、データアナリスト、GitHub の課題調査、ドキュメントレビューといった実装例が公開されています。いきなり自社業務に当てるより、近い形のサンプルを1本動かしてから設計に入るほうが早いはずです。

結局、いま採用すべきか

実務での判断はこう整理できます。「長時間動き続けるエージェントを、できるだけ少ない実装で立ち上げたい」なら Agents API は有力です。コンテキストの圧縮、セッションの再開、サブエージェントへの委譲は、自作すると本当に手間のかかる部分で、それが最初から入っています。

逆に、データの所在地や保持ポリシーが要件に入っている案件では、現時点では見送りが妥当です。米国のみ・ZDR非対応という制約は回避策がなく、自前サンドボックスでも解消しません。ここは「あとで直せる技術的負債」ではなく、最初の設計判断です。

そして公開からまだ日が浅いパブリックベータであることも忘れないでください。提供範囲や制約は変わる可能性がありますので、本番投入の前には必ず最新のドキュメントを当たってください。AIエージェント全般の考え方や、どの業務から始めるかについては中小企業がAIエージェント導入を始める5ステップもあわせてどうぞ。

Mihataでは、こうした「使えるが制約もある」新しい仕組みを、自社の業務にどこまで当てられるかを一緒に見極めるところからお手伝いしています。記事の最後に恐縮ですが、社内でAIエージェントの検討が始まっている方は、よろしければご覧いただけたら嬉しいです。

よくある質問

OpenAI Agents APIとは何ですか?

OpenAIが管理するAPIを通じてCodexのハーネス(エージェントを動かす土台)にアクセスできる仕組みです。2026年9月10日にパブリックベータで公開されました。セッション管理・オーケストレーション・コンテキストの圧縮・中断からの復帰をOpenAI側が担い、開発者はツールと実行環境を指定します。

Agents SDKとの違いは何ですか?

エージェントのループをどこで回すかが違います。Agents APIはOpenAIが管理するCodexハーネスで動き、統合の手間が低い代わりに挙動を預ける形です。Agents SDKは自社アプリの中でSDKが動くため、デプロイ・保存・承認フローを自分で制御できます。長時間タスクをOpenAIに任せたいならAgents API、制御を握りたいならAgents SDKです。

Agents APIはゼロデータ保持(ZDR)に対応していますか?

対応していません。公式ドキュメントは、Agents APIが現時点で米国のデータ所在地のみをサポートし、ZDRには対応していないと明記しています。さらに自前ホストのサンドボックスを選んでもZDRの対象にはなりません。データの所在地や保持ポリシーが要件に入っている案件では、現時点では採用を見送る判断が妥当です。

料金はどうなりますか?

セッション自体の独立した課金はなく、選んだモデルの通常API料金、OpenAIのツールの標準レート、OpenAIホストのサンドボックス(コンテナ)の標準レートの合算です。コンテナは1GB $0.03/4GB $0.12/16GB $0.48/64GB $1.92(20分セッション・コンテナあたり)で、対象セッションは分単位課金・1セッションあたり最低5分となっています。

試すのに必要な準備はありますか?

API キーに api.agents.read と api.agents.write(セッション操作)、api.responses.write(モデル推論)の権限が必要です。またリクエストにはベータヘッダ OpenAI-Beta: agents=v1 が必要で、公式SDKは自動で付与します。APIキーはエージェントのサンドボックスの外に置くよう公式が注意しています。

終了したAssistants APIの移行先ですか?

違います。2026年8月26日に終了したAssistants APIの移行先として案内されているのはResponses APIとConversations APIで、Agents APIは別の新しい選択肢です。

まずはお気軽にご相談ください

AI・IT・デザインに関するお悩みやご相談、お見積りのご依頼など、
どんなことでもお気軽にお問い合わせください。

お問い合わせ