OpenAI Agents SDK

用語・参照公式仕様のみ鮮度未確認

記事状態: 公開 · 最終確認: 未確認

要点

「OpenAI Agents SDKの公式Docsは、agent、ツール、引継ぎ、guardrail、セッション、human-in-the-loop、tracing等の実行環境構成を示している。これはOpenAI系実装の仕様証拠であり、プラン・地域・組織設定・本番環境安全性・業務品質の保証ではない。」

現在の判断

ESTABLISHED: 公式Docsは、LLM・instructions・toolsから成るAgent、引継ぎ/agents-as-tools、guardrails、セッション、human-in-the-loop、tracing/評価等のSDK概念と、実行環境がturn・ツール実行・guardrail・引継ぎ・セッションを管理する用途を説明している。
未確立（NOT_ESTABLISHED）: ドキュメントにプリミティブが存在することは、任意のプラン、地域、組織設定、モデルIDでの利用可能性、本番環境における安全性、SLA、特定の組織の利用環境における実際の挙動、およびエージェントが危険なアクションを自動的に防ぐことを証明するものではない。

どこまで当てはまるか

プロバイダーマッピング / 実装 / 運用管理・統制 / セキュリティ / 監査 / 運用性。OpenAI固有のSDK仕様であり、企業AI運用の共通原則の一般原則や他のプロバイダーの可用性へと一般化しない。

詳しく理解する

なぜ重要か

OpenAI系agent 実行環境の構成要素、trace、guardrail、引継ぎ、セッション等を、将来の製品への対応付けへ現行仕様として更新可能な証拠にする。

対象範囲と前提

検討ポイント

現行公式DocsがAgents SDKの実行環境 primitivesと導入境界について何を明示しているか。どこまでが仕様記述で、どこからが組織の利用環境・契約・本番環境保証の未知か。

根拠資料の対応表

ソース種別=公式プロジェクトドキュメント; 正式なタイトル=OpenAI Agents SDK; 著者/組織=OpenAI; 正式なURL=https://openai.github.io/openai-agents-python/ 出版/更新/アクセス日=現在のドキュメントを2026-09-13（日本標準時）にアクセス; 改訂版/リリース/タグ/コミット/API改訂版=現在のドキュメント（ページ上に固定されたパッケージバージョンなし）; 根拠となる箇所=概要 / コアコンセプト / 「Agents SDKの使用場面」 / インストール（エージェント、ツールとしてのエージェント、ハンドオフ、ガードレール、ファンクションツール、MCP、セッション、人による確認、トレーシング/評価、Responses APIとの関係、pip install openai-agentsについて記載）; 根拠ラベル=検証済み仕様+製品の流動性あり; 関係性=支持+文脈

利用できる条件

Python実行環境、パッケージ/APIバージョン、OpenAI APIの資格情報・契約・地域・組織設定、対象モデルID、Responses API等の依存仕様、MCP/ツールの許可、およびトレーシングデータの保持・権限。

実装・運用

OSS/Python実装案内 + PRODUCT_VOLATILE。Docs記載のinstall/exampleは実装入口の証拠であり、認証済み組織の利用環境での実行・課金・本番環境妥当性の検証は未実施。

確認・評価方法

公式Docsにtracing/評価機能の記述はあるが、特定業務の精度・安全率・コスト・SLOを示す独立再現比較評価はこのPacketでは確認していない。未確認事項。

セキュリティとプライバシー

Security=guardrails/human-in-loopを制御点として設計するが自動安全保証ではない。Privacy=入力・ツール結果・traceの保持と権限を確認。監査=引継ぎ/ツール/guardrail/traceを関連付ける。Cost=モデル呼出し・ツール・再試行・trace・人手承認を測る。Operability=バージョン pin、処理待ち時間の上限、以前の状態へ戻す操作、fail-closedを別途設計。

検証済みの適用範囲

OpenAI Agents SDK provider-specific 適用範囲 only. Guardrail coverage is boundary-specific; parallel input guardrails may allow work before tripwire; tracing 利用可能性/保持期間・保持方針 is organization-policy dependent.

確認できていること

ESTABLISHED: 公式Docsは、LLM・instructions・toolsから成るAgent、引継ぎ/agents-as-tools、guardrails、セッション、human-in-the-loop、tracing/評価等のSDK概念と、実行環境がturn・ツール実行・guardrail・引継ぎ・セッションを管理する用途を説明している。
未確立（NOT_ESTABLISHED）: ドキュメントにプリミティブが存在することは、任意のプラン、地域、組織設定、モデルIDでの利用可能性、本番環境における安全性、SLA、特定の組織の利用環境における実際の挙動、およびエージェントが危険なアクションを自動的に防ぐことを証明するものではない。

よくある失敗・反証

現行Docsは仕様・導入案内であり、独立比較評価や全API 改訂版の互換性表ではない。モデル更新、SDK/package変更、ツール側の副作用、trace欠損、guardrail bypass、引継ぎ loopのリスクが残る。
SDKの存在をOpenAI製品全体・Enterprise契約・特定の組織の利用環境での有効化へ外挿しない。例示の成功を安全な実運用における証拠としない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED
---

実務での使い方

Python実行環境、パッケージ/APIバージョン、OpenAI APIの資格情報・契約・地域・組織設定、対象モデルID、Responses API等の依存仕様、MCP/ツールの許可、およびトレーシングデータの保持・権限。
OSS/Python実装案内 + PRODUCT_VOLATILE。Docs記載のinstall/exampleは実装入口の証拠であり、認証済み組織の利用環境での実行・課金・本番環境妥当性の検証は未実施。
公式Docsにtracing/評価機能の記述はあるが、特定業務の精度・安全率・コスト・SLOを示す独立再現比較評価はこのPacketでは確認していない。未確認事項。
Security=guardrails/human-in-loopを制御点として設計するが自動安全保証ではない。Privacy=入力・ツール結果・traceの保持と権限を確認。監査=引継ぎ/ツール/guardrail/traceを関連付ける。Cost=モデル呼出し・ツール・再試行・trace・人手承認を測る。Operability=バージョン pin、処理待ち時間の上限、以前の状態へ戻す操作、fail-closedを別途設計。
製品への対応付けへ公式Docsの現行URLとaccess dateを引き継ぐ。次回はpackage 公開・提供、API 改訂版、モデル ID、trace データ形式の定義、guardrail fail-open/closed、MCP権限、価格・データ保持を公式公開・提供/API docsと安全な再現試験で補完する。
OpenAI Agents SDK provider-specific 適用範囲 only. Guardrail coverage is boundary-specific; parallel input guardrails may allow work before tripwire; tracing 利用可能性/保持期間・保持方針 is organization-policy dependent.

まだ確認できていないこと

EA-131-UNKNOWN-01
現在の package 公開・提供/tag、言語別parity、trace/評価の保存境界、モデル別ツール/引継ぎ挙動、組織の利用環境利用可能性、障害時の再開/以前の状態へ戻す操作、本番環境失敗 report。
EA-131-UNKNOWN-02
All 未確認事項/PRODUCT_VOLATILE/提供元- or organization-specific limits from the authority/監査 remain open unless explicitly closed by the audited 引継ぎ.
EA-131-UNKNOWN-CURRENTNESS
外部根拠の再確認日が正式な本文・公開管理情報で確定していないため、現行性は未確認のまま保持する。確認日を推測して補わない。

根拠資料

研究資料研究資料
source_class=公式プロジェクトドキュメント; exact_title=OpenAI Agents SDK; 著者・組織=OpenAI; canonical_url=
原資料を開く
確認上の限界
元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

出典ID・検証情報・機械可読データ

根拠の種類と情報の鮮度は、ラベルとアイコンで確認できます。

記事ID: EA-131
最終確認日: —
提供元・モデル・プラン・利用環境: OpenAI
対象地域: —

元資料の全文と収録照合記録

WHY_THIS_MATTERS_TO_UPDATE

OpenAI系agent runtimeの構成要素、trace、guardrail、handoff、session等を、将来のprovider mappingへ現行仕様として更新可能な証拠にする。

SCOPE_ROUTING

provider mapping / implementation / governance / security / audit / operability。OpenAI固有のSDK仕様であり、Enterprise AI Coreの一般原則や他providerの可用性へ一般化しない。

CLAIM_OR_RESEARCH_QUESTION

現行公式DocsがAgents SDKのruntime primitivesと導入境界について何を明示しているか。どこまでが仕様記述で、どこからがtenant・契約・production保証の未知か。

EVIDENCE_TABLE

source_class=official project documentation; exact_title=OpenAI Agents SDK; author/org=OpenAI; canonical_url=https://openai.github.io/openai-agents-python/ publication/update/access_date=current docs accessed 2026-09-13 JST; version/release/tag/commit/API revision=current documentation（ページ上に固定package versionなし）; supporting_locator=Overview / Core concepts / “When to use the Agents SDK” / Installation（Agent、Agents as tools、Handoffs、Guardrails、function tools、MCP、sessions、human-in-the-loop、tracing/eval、Responses APIとの関係、pip install openai-agentsを記載）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; relation=support+context

FINDINGS

ESTABLISHED: 公式Docsは、LLM・instructions・toolsから成るAgent、handoff/agents-as-tools、guardrails、session、human-in-the-loop、tracing/eval等のSDK概念と、runtimeがturn・tool execution・guardrail・handoff・sessionを管理する用途を説明している。
NOT_ESTABLISHED: docsのprimitive存在は、任意のプラン・地域・組織設定・model IDでの利用可能性、production安全性、SLA、特定tenantの実挙動、agentが危険actionを自動的に防ぐことを証明しない。

LIMITS / COUNTEREVIDENCE / FAILURE ENVELOPE

現行Docsは仕様・導入案内であり、独立benchmarkや全API revisionの互換性表ではない。モデル更新、SDK/package変更、tool側の副作用、trace欠損、guardrail bypass、handoff loopのリスクが残る。

AVAILABILITY_GATES

Python実行環境、package/API version、OpenAI API資格情報・契約・地域・組織設定、対象model ID、Responses API等の依存仕様、MCP/toolの許可、tracingデータの保持・権限。

IMPLEMENTATION_STATE

OSS/Python実装案内 + PRODUCT_VOLATILE。Docs記載のinstall/exampleは実装入口の証拠であり、認証済みtenantでの実行・課金・production validationは未実施。

BENCHMARK_OR_EVAL

公式Docsにtracing/eval機能の記述はあるが、特定業務の精度・安全率・コスト・SLOを示す独立再現benchmarkはこのPacketでは確認していない。UNKNOWN。

SECURITY / PRIVACY / AUDIT / COST / OPERABILITY

Security=guardrails/human-in-loopを制御点として設計するが自動安全保証ではない。Privacy=入力・tool結果・traceの保持と権限を確認。Audit=handoff/tool/guardrail/traceを関連付ける。Cost=モデル呼出し・tool・retry・trace・人手承認を測る。Operability=version pin、timeout、rollback、fail-closedを別途設計。

SAFE_WORDING_FOR_FUTURE_BOOK

「OpenAI Agents SDKの公式Docsは、agent、tool、handoff、guardrail、session、human-in-the-loop、tracing等のruntime構成を示している。これはOpenAI系実装の仕様証拠であり、プラン・地域・組織設定・production安全性・業務品質の保証ではない。」

UPDATE_WORK_HANDOFF

provider mappingへ公式Docsの現行URLとaccess dateを引き継ぐ。次回はpackage release、API revision、model ID、trace schema、guardrail fail-open/closed、MCP権限、価格・データ保持を公式release/API docsと安全な再現試験で補完する。

OPEN_UNKNOWN

current package release/tag、言語別parity、trace/evalの保存境界、model別tool/handoff挙動、tenant availability、障害時のresume/rollback、production failure report。

STOP_CONDITION

SDKの存在をOpenAI製品全体・Enterprise契約・特定tenantの有効化へ外挿しない。exampleの成功を安全な実運用の証拠にしない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED

---

AUDITED_BOUNDARY

OpenAI Agents SDK provider-specific scope only. Guardrail coverage is boundary-specific; parallel input guardrails may allow work before tripwire; tracing availability/retention is organization-policy dependent.