OpenAI Agents SDKかAgents APIか：開発体制で決める選び方

OpenAIは、マネージド型のAgents APIを2026年9月10日に公開しました。セッション状態の管理、コンテキストの圧縮、障害からの復旧が運用負担になっているならAgents APIを、自社アプリでランタイム、デプロイ、データ経路まで握る必要があるならOpenAI Agents SDKを選ぶべきです。OpenAI Agents APIとAgents SDKの選択を分けるのは、制御の自由度と運用コストです。マネージドサービス自体に別途ハーネス料金はかかりません。

OpenAI Agents SDKとAgents API、どちらを選ぶべきか？

長時間動くエージェントを少人数のプラットフォームチームで提供するなら、まず検討したいのはOpenAI Agents APIです。OpenAIがCodexハーネスを運用し、セッションと保存済みの作業を保持しながら、コンテキストの圧縮、サブエージェントの連携、非同期ターンをまたぐ復旧まで担います。プロダクトの差別化につながりにくいインフラ作業をまとめて減らせます。OpenAIは2026年9月10日にパブリックベータとして公開し、すべての開発者が利用できるとしています。

資金調達を終えた創業者が小規模なバックエンドチームで、承認待ちのまま数時間停止する文書レビューエージェントを開発する場合、ループを自前で所有することよりマネージドセッションの価値が上回ります。限られた開発時間は、ポリシー、ツール、評価、ユーザー体験に振り向けるべきです。

OpenAI Agents SDKが適しているのは、ランタイム制御が「あれば便利」ではなく必須要件である場合です。SDKはアプリケーション内で動き、デプロイ、ストレージ、承認ロジック、ツール実装、状態管理の方針をすべて自社で決められます。Zero Data Retention（ZDR）が必須の中堅企業なら、現時点ではこちらを選ぶべきです。Agents APIのパブリックベータはZDRに対応していないためです。

すでにワーカー群、独自テレメトリー、検証済みの復旧経路を運用している上級開発者にとって、小さなループの保守を避けることだけを理由に移行するのは割に合いません。SDKならその制御を維持しつつ、エージェント、ツール、ハンドオフ、ガードレール、セッション、有人レビュー、トレーシングを利用できます。

OpenAI Agents APIとAgents SDKを一覧で比較

公式な違いは、オーケストレーションがどこで動き、タスク間の状態を誰が所有するかです。どちらもOpenAIのモデルとツールを呼び出せますが、モデルのトークン料金が無料になるわけではありません。

実務上の分岐は明快です。既存サービス内で短いリクエストを一度処理するだけなら、SDKを自社運用する負担はごく小さいかもしれません。一方、ファイルを編集し、承認のために停止し、切断を越えて動き、作業を委任して翌日に再開するエージェントでは、ライフサイクルの状態が増えるほどマネージドAPIが取り除く仕組みも増えます。

ハーネスとサンドボックスは別々に選ぶ

Agents APIが管理するのはエージェントの思考ループであり、すべてのツールをOpenAIのコンピュート上で動かす必要はありません。OpenAIはこのマネージドループをCodexハーネスと呼んでいます。モデル呼び出し、ツール利用、コンテキスト、セッション、サブエージェントを連携する仕組みです。一方、コマンドを実行しファイルを置く実行環境は、これとは別のリソースです。

実行環境は、設けない、OpenAIでホストする、セルフホストする、のいずれかを選べます。実行環境がなくても、ハーネスはリモートMCPサーバーを呼び出し、アプリケーションへ関数呼び出しを送れます。ただし、組み込みのBash、apply-patchツール、ワークスペースファイルは使えません。OpenAIホステッドサンドボックスでは、OpenAIがLinuxワークスペースを用意します。セルフホスト環境では、マネージドハーネスの要求を受けて自社のエグゼキューターがコマンドとファイル操作を実行します。この分離はアーキテクチャガイドにも明記されています。

この違いを理解すれば、高くつく二つの判断ミスを避けられます。まず、コードをVPC内で動かす必要があるという理由だけでAgents SDKを選ぶのは早計です。Agents APIはセルフホスト環境にも接続できます。逆に、すべてをOpenAIに任せたいという理由だけでAgents APIを選ぶのも早計です。アプリケーションの関数ハンドラーは引き続き自社コード内で動き、セルフホストのエグゼキューターではプロビジョニング、再接続、終了処理、ファイル永続化を自社で担います。

たとえば、機密データ分析のワークフローでは、汎用シェルを渡さず、マネージドハーネスからアプリケーションサービスへSQL関数呼び出しだけを送れます。コーディングエージェントならOpenAIホステッドサンドボックスを使えます。独自ビルドシステムなら、自社の隔離ワーカーへ接続できます。いずれも同じマネージドオーケストレーション上で選べる三つの実行パターンです。

セッション管理ではAgents APIが長時間タスクに強い

タスクのライフサイクルが一度のアプリケーションリクエストを超えるなら、Agents APIが有利です。セッションにはエージェント設定、会話、保存済みの作業が保持されます。セッションがアイドル状態なら新しい入力で非同期ターンが始まり、処理中ならアクティブなターンに指示を追加できます。アプリケーションはストリームを追跡することも、Webhookで状態変化を受け取ることもできます。

セッションがコンテキスト上限に近づくと、OpenAIがコンテキスト圧縮も行います。これは過去の詳細を、より小さな保持用表現に置き換え、複数のコンテキストウィンドウをまたいで作業を続けられるようにする処理です。仕組みの説明は簡単でも、安定運用は容易ではありません。保持する要約には、過去の全トークンを抱え続けることなく、意思決定、ツール結果、未完了の作業を残す必要があります。

目立ちにくいものの、復旧も大きな利点です。イベントストリームは受信できなかったイベントを再送しません。切断後はセッションと保存済みアイテムを取得し、プロセスメモリからエージェントのターンを再構築するのではなく、永続記録から処理を続けます。セッションガイドでは、完了したターン、失敗したターン、キャンセル、単なるアイドル状態を区別しています。

資金調達を終えた創業者が契約書レビューエージェントを運用する場面を考えてみます。エージェントは文書を読み、専門サブエージェントに条項比較を依頼し、法務承認のために停止し、後から修正を受け取り、成果物を作ります。価値を生むのはレビューそのものです。セッション再生、コンテキスト圧縮、途切れたストリーム、ターンの復旧は運用コストにすぎません。マネージドAPIは、まさにこの種の負担を引き受けるためのものです。

ただし、コスト計測の精度には限界があります。エージェントは複数回モデルを呼び出す場合があり、ルートエージェント、サブエージェント、再試行、ツール、サンドボックスのすべてが費用に加わります。OpenAIによると、Agents APIのusageフィールドはベストエフォートで、nullの場合や後から変更される場合があり、最終請求額を示すものではありません。推論トークンは出力トークンとして数えられ、キャッシュ済み入力にも料金がかかります。デバッグにはusageガイドを使い、財務管理では請求データと照合してください。

ダッシュボードも可観測性の境界に含まれます。パブリックベータの顧客向けAPIでは、詳細なトレース取得や外部トレースエクスポーターを利用できません。テレメトリーパイプラインで全トレースのプログラム出力が必須なら、洗練されたマネージドダッシュボードより、この欠落のほうが重要です。

ランタイムとデプロイの制御ではAgents SDKが有利

実行の開始、一時停止、再開、状態の保存、ツールの振り分け、失敗時の処理までアプリケーション側で厳密に決める必要があるなら、Agents SDKが適しています。SDKのランナーがエージェントループとハンドオフを実行しますが、そのループが動く場所は自社サービス内です。そのため、すべての状態遷移を独自のトランザクション、キュー、レート制限、承認記録、テレメトリーで囲めます。

SDKはTypeScript版とPython版があり、PythonリポジトリはMIT Licenseを採用しています。したがって、パッケージにユーザー単位のライセンス料金はありません。一方、OpenAIのモデル呼び出し、ホステッドツール、サンドボックスプロバイダー、アプリケーションを動かすコンピュートは別料金です。SDKガイドでは、デプロイ、ストレージ、承認、ランタイム連携を自社で担うコードファーストのアプリ向けと位置づけられています。

状態管理は自動化されるのではなく、柔軟に選べます。SDKアプリケーションはresult.historyを再生する、SDKセッションを自社ストレージに永続化する、OpenAI Conversations IDを関連づける、過去のResponses APIレスポンスIDから連結する、といった方法を取れます。いずれも有用ですが、エージェント実行ガイドは、ローカル履歴の再生とサーバー管理の状態を意図的に整合させずに混在させると、コンテキストが重複する可能性があると注意しています。

この柔軟性は、規制対象の社内サービスで特に価値を発揮します。承認とエージェントの続行を同じデータベーストランザクションに含め、認可済みのリージョンに状態を置き、プライベートネットワーク制御の背後でツールを動かし、既存のジョブシステムにエージェント実行を組み込めます。また、マネージドCodexハーネスを恒久的なオーケストレーション境界にせず、SDKのモデル層を通じて別のモデルやプロバイダーも統合できます。

代わりに背負うのが運用責任です。プロセスがクラッシュすれば、再開は自社の課題になります。キューが重複配信されれば、冪等性も自社で担います。履歴の増大、圧縮方針、ツールの再試行、状態移行、デプロイのロールバックも同様です。SDKはすべてを制御できますが、その価値があるのは、アプリケーションが実際にその制御を活用する場合に限られます。

料金比較：ハーネスの追加料金はない

同じOpenAIモデル、同じトークン構成、同じツール呼び出しを使うなら、トークンとホステッドツールの請求額はどちらのランタイムでも同じです。料金は2026年9月11日にOpenAIの公開ページで確認されています。GPT-6 Astraの標準・短コンテキスト料金は、1 million入力トークン当たり$10.00、1 million出力トークン当たり$50.00です。Web検索は1,000回当たり$10.00に加え、検索コンテンツのトークンが選択モデルの単価で課金されます。マネージドAgents API自体に追加料金はありません。

条件をそろえたワークロードの一例を示します。以下は実測した本番データではなく、試算上の仮定です。

• エージェントジョブは月1,000件。
• 各ジョブでGPT-6 Astraの未キャッシュ入力トークンを合計10,000、出力トークンを2,000使用。返された検索コンテンツは入力枠に含める。
• 各ジョブでWeb検索を一回実行。
• Agents APIのホステッド構成では、ジョブごとに新しい1 GBコンテナの課金セッションを一つ開始し、公表単価の$0.03を適用。サンドボックスを再利用すれば、この項目は安くなる。
• SDK構成では、月$40で十分な処理能力を持つ共有ワーカーを一つ使うと仮定。ストレージ、ネットワーク、人件費は除外。

モデル料金は、入力が$0.10、出力が$0.10で、ジョブ当たり$0.20です。想定する12,000トークンの構成では、混合モデル料金は1,000トークン当たり$0.0167になります。Web検索一回の$0.01を加えると、共通のOpenAI利用料はジョブ当たり$0.21です。

1,000ジョブの場合、ジョブごとに新しい1 GBホステッドコンテナを使うAgents APIは$240です。内訳は共通のモデル・検索利用料が$210、コンテナが$30です。SDKは、同じ$210のOpenAI利用料に想定$40のワーカーを加え、$250です。この少ない処理量では、直接費用はホステッドコンテナのほうが安くなります。

10,000ジョブでは、マネージド・ホステッド構成が$2,400に達します。共通費用が$2,100、コンテナが$300です。SDKは、想定した共有ワーカーを使うと$2,140です。直接的なコンピュート費用の損益分岐点は月1,334回の新規コンテナセッションで、セッション当たり$0.03が$40を初めて上回る整数の回数です。

最も重要なのは、セルフホスト型Agents APIの行です。Agents APIで同じ想定$40のワーカーを使えば、10,000ジョブの総額も$2,140になります。Codexハーネスは引き続きマネージドですが、OpenAIがハーネス料金を追加しないため、実行費用はSDK構成と一致します。

それでも、現金支出の比較には最大の変数であるエンジニアの時間が入っていません。損益分岐点を超えた後に月$260のコンピュート費用を節約できても、SDKの維持にプラットフォーム作業が数時間かかるなら意味は薄れます。反対に、成熟したSDKシステムなら、分岐点より下でほとんど費用をかけずに維持できる場合があります。

どちらの構成でも予算を厳格に管理するには、ワークロードの見積もりとAI Agent API Budget Controls 2026で紹介するプロジェクト単位の保護策を組み合わせてください。見積もりは計画の道具であり、支出を強制的に止める仕組みではありません。

Agents SDKからAgents APIへの移行コスト

Agents SDKからAgents APIへの移行は、パッケージ名の置き換えではなくランタイムの移行です。エージェント定義やツールスキーマが似ていても、セッションID、SDKセッション、Responsesの会話、Agents APIセッション、サンドボックスは別のリソースです。状態はそのまま移植できる識別子ではなく、境界を越えて移すデータとして扱います。

1. 1

   現在の挙動を契約として固定する

   現在のエージェント指示、ツールスキーマ、承認ポイント、出力形式、トークン予算、失敗時の方針を記録します。比較中はモデルとツールを固定し、品質の変化をランタイム改善と取り違えないようにします。

2. 2

   エージェントとツールの設定を対応づける

   モデル、指示、MCP接続、関数定義をAgents APIの設定へ移します。アプリケーションの関数ハンドラーには、呼び出しを受信して結果を返すサービスが引き続き必要です。オーケストレーションを移しただけでホステッドになるわけではありません。

3. 3

   状態の境界を明確にする

   新しい会話はAgents APIセッションとして開始し、そのIDをアプリケーションの会話レコードと並べて保存します。移行中も従来のSDK履歴を読める状態に保ちます。過去のコンテキストを引き継ぐ必要がある場合は、SDKセッションをAgents APIセッションに見せかけず、必要な業務状態だけを明示的な入力へ変換します。

4. 4

   ライフサイクル処理を置き換える

   インプロセスのランナー起動処理を、セッション作成、イベント、保存済みアイテム、必須アクション、Webhook、キャンセル、削除に置き換えます。マネージド状態を使ってもアプリケーション境界での重複配信リスクはなくならないため、すべてのWebhookと関数結果に冪等性を持たせます。

5. 5

   シャドーテストと回帰検証を行う

   同じ評価セットを両方の経路で実行します。タスク成功率、入力・出力トークンの合計、ツール呼び出し、所要時間、復旧時の挙動、人の介入を比較します。新しい経路が従来の契約を満たしてからトラフィックを移します。

移行工数の例を置くと、判断が具体的になります。既存ワークフローに三つの関数ツール、永続セッション、有人承認があると仮定します。エンジニアリングに24時間、時給$150を割り当てます。内訳は設定とツールの対応づけに6時間、セッションとライフサイクルに8時間、Webhook・復旧・冪等性に6時間、回帰検証とコスト確認に4時間です。一度限りの移行費用は$3,600になります。

マネージドのコンテキスト圧縮、復旧、セッション、オーケストレーションによって毎月6時間を節約できると仮定すると、人件費の削減は月$900で、回収には四か月かかります。現在のSDK経路がたまにしか手を必要としないなら、回収できない可能性もあります。重要なのは仮定そのものです。移行の根拠はトークン単価の低下ではなく、不要になる運用作業で考えるべきです。

Agents APIへ移行すべきでないケース

パブリックベータのデータ管理要件が調達基準を満たさないなら、移行すべきではありません。現在のAgents API概要によると、データレジデンシーは米国に限られ、Zero Data Retentionには対応していません。サンドボックスをセルフホストしても、ハーネスとセッションはマネージドサービス側に残るため、このポリシーは変わりません。

次のいずれかに当てはまるなら、Agents SDKを継続してください。

• ランタイムを独自スケジューラー、トランザクション境界、またはアプリケーションが直接制御するレイテンシー条件の下で実行する必要がある。
• ストレージ、トレース出力、データレジデンシーのポリシーがマネージドのパブリックベータに適合しない。
• Codexハーネスに依存させたくないプロバイダーの柔軟性、またはモデル抽象化をエージェントが利用している。
• 既存のSDKシステムに信頼できるコンテキスト圧縮、復旧、可観測性、デプロイがあり、継続的な保守負担が小さい。
• 作業の大半が短時間かつステートレスで、永続的なマネージドセッションを導入しても削減できる基盤が少ない。

パブリックベータであること自体も判断材料です。OpenAIは一般提供まで速いペースで改良するとしています。変更管理の予定が厳格なチームなら、今は評価だけを行い、仕様が安定してから移行するほうがよいでしょう。

反対に、SDKにも避けるべきケースがあります。少人数のスタートアップが理論上のロックインを恐れるだけでSDKを選び、裏側でセッション、復旧、サンドボックスのライフサイクル、オーケストレーションを作り直すべきではありません。実際に使わない制御権は、保守負債になります。

コード実行が必要なエージェントでは、実行環境の層を切り離し、Best AI Agent Code Sandboxes 2026も比較してください。サンドボックスを選ぶだけでは、オーケストレーション状態を誰が所有すべきかは決まりません。

顧客事例の成果は参考値として扱う

初期の数値はマネージド構成に有利ですが、独立した対照実験の結果ではありません。OpenAIが9月10日の発表記事で紹介した顧客報告です。SafetyKitは案件当たりコストが60%低下したと報告しました。Hyphaは、マネージドハーネスと自社サンドボックスを分離した後、エージェント応答の失敗が86%減ったとしています。Ciridaeは評価スコアが0.71から0.85へ上がり、レイテンシーが4x改善したと報告しています。

これらの結果から分かるのは、ランタイム境界が成果を左右し得るということです。一方で、移行によって自社がどれだけ節約できるかまでは示していません。発表記事では、各社の従来構成、モデル構成、トークン量、タスク難易度、エンジニア工数が正規化されていないためです。予測値として使うのではなく、シャドー評価を始める根拠として扱ってください。

OpenAI Agents APIとAgents SDKのよくある質問

OpenAI Agents SDKを使う理由は？

デプロイ、ストレージ、承認判断、ツール実装、ランタイムループをアプリケーション側で直接所有したい場合にOpenAI Agents SDKを使います。OpenAIのエージェント機能を利用しながら、オーケストレーションをマネージドAgents APIへ移さずに済みます。

OpenAI Agents SDKとPydanticAIはどちらが自分に合う？

それは別のフレームワーク比較です。まず、Agents APIを通じてOpenAIにCodexハーネスを管理してもらうのか、SDKランタイムをアプリケーションで所有するのかを決めます。SDKを選んだ場合に、その枠内でフレームワークを比較してください。

AIエージェント開発に最適なSDKは？

すべてのアーキテクチャに最適なSDKはありません。TypeScriptまたはPythonのループ、ツール、ハンドオフ、ガードレール、セッション、OpenAI連携が自社アプリに合い、デプロイを自社で管理したいなら、OpenAI Agents SDKは有力な選択肢です。

OpenAI Agents SDKは無料？

Python Agents SDKはMITライセンスなので、パッケージのライセンス料はかかりません。ただし、モデル呼び出し、有料ツール、サンドボックスサービス、アプリケーションを動かすインフラには料金がかかります。

OpenAI Agents SDKの使い方は？

公式のTypeScriptまたはPythonパッケージをインストールし、指示とツールを持つエージェントを定義して、状態管理の方針を一つ選び、アプリケーション内で実行します。承認、永続化、トレーシング、サンドボックスは、ワークフローで必要な範囲にだけ追加します。

OpenAIエージェントの料金はいくら？

モデルの入力、キャッシュ済み入力、出力、ツール呼び出し、サンドボックスまたはアプリケーションのコンピュート、外部サービス、運用工数を合算します。Agents APIのハーネスに追加料金はありません。本記事の仮定では、月$40の共有ワーカーと比べた実行環境費用の分岐点は、月1,334回の新規1 GBコンテナセッションです。

OpenAI APIは無料、それとも有料？

OpenAI APIのモデルと有料ツールは、API料金に基づく従量課金です。ChatGPTのプランは別の製品契約であり、Agents APIまたはAgents SDKアプリケーションのAPI利用料は含まれません。

ChatGPTに$20を払う理由は？

これはChatGPTのサブスクリプションについての判断であり、Agents APIとSDKの選択とは別です。ChatGPTのサブスクリプションは、そのプラン条件に基づくChatGPT製品へのアクセスを提供します。OpenAI APIの利用料は別途請求されます。

OpenAI Agent Builderは無料、それとも有料？

Agent Builderは標準のAPIモデル料金に含まれていましたが、本記事で比較しているどちらのランタイムにも該当しません。OpenAIはAgent Builderを段階的に終了しており、2026年11月30日に停止する予定だとしています。

次の月曜日に試すこと

来週、長時間動くワークフローを一つ選び、シャドー比較を実施します。モデル、指示、トークン予算、ツール、評価セットは固定してください。新しいテスト会話をAgents APIへ送り、既存ユーザーの履歴はSDK経路に残します。マネージドハーネスの価値だけを切り分けたい場合は、両方で同じ実行環境を選びます。

タスク成功率、合計トークン、有料ツール呼び出し、サンドボックスの課金セッション、復旧事象、人の介入、エンジニア工数を記録します。削減できるセッション管理と復旧作業の価値が、手放す制御権を上回るならAgents APIです。マネージドサービスがデータ要件を満たさない、または移行費用を回収できるほど運用時間を減らせないなら、Agents SDKを維持します。

エージェントのランタイムを変更する前に、AI Business Workflow Audit Checklistを入手してください。