Skip to content

Evidence for AI operations

No English page yet. Showing the Japanese source.

Back to the entrance

OpenAI Agents SDK

用語・参照用語・参照公式仕様のみ公式仕様のみ鮮度未確認鮮度を確定できない

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

要点

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

現在の判断

  • 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を自動的に防ぐことを証明しない。

どこまで当てはまるか

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

詳しく理解する

なぜ重要か

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

対象範囲と前提

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

検討ポイント

現行公式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

利用できる条件

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

実装・運用

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

確認・評価方法

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

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

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

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.

確認できていること

  • 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を自動的に防ぐことを証明しない。

よくある失敗・反証

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

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

    ---

実務での使い方

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

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

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

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

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

  • 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.

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

  • EA-131-UNKNOWN-01

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

  • EA-131-UNKNOWN-02

    All UNKNOWN/PRODUCT_VOLATILE/provider- or organization-specific limits from the authority/audit remain open unless explicitly closed by the audited handoff.

  • EA-131-UNKNOWN-CURRENTNESS

    外部根拠の再確認日がcanonical body/control-planeで確定していないため、currentnessはUNKNOWNとして保持する。日付を推測補完しない。

根拠資料

出典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.

OPEN_UNKNOWN

All UNKNOWN/PRODUCT_VOLATILE/provider- or organization-specific limits from the authority/audit remain open unless explicitly closed by the audited handoff.

  • EVD-EA-131-URL-52C5EFFFA5B8研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    source_class=official project documentation; exact_title=OpenAI Agents SDK; author/org=OpenAI; canonical_url=

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-131-URL-52C5EFFFA5B8
    検証箇所
    EVIDENCE_TABLE · - source_class=official project documentation; exact_title=OpenAI Agents SDK; author/org=OpenAI; canonical_url=https://openai.github.io/openai-agents-python/
    適用範囲
    EVIDENCE_TABLE
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EA-131-R11-RESEARCH研究資料研究資料根拠の出所: AUDITED_CANONICAL_RESEARCH_PACKET

    EA-131 監査済みresearch / canonical revision binding

    裏付ける内容
    - 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を自動的に防ぐことを証明しない。
    確認日
    —
    出典・実験ID
    COMM-043-EA0131
    検証箇所
    COMM-043-EA0131 · EA-131-R5-LEGACY-MIGRATION-20261008-R1 · content/staging/EA-131.md
    適用範囲
    監査済みEA本文・canonical revision・既存Source Graph relationの範囲。欠損currentnessは推測で閉じない。
    出典・来歴
    AUDIT_PASS_CANONICAL_BINDING
    限界
    canonical監査・revision bindingの存在を示す。外部ソースcurrentnessが本文またはcontrol-planeで確定していない場合は、currentnessをUNKNOWNのまま保持する。
  • EA-131-R11-WEB-READBACK実装資料実装資料根拠の出所: IMPLEMENTATION_READBACK

    EA-131 Web body identity / canonical readback

    裏付ける内容
    canonical staging bodyのSHA-256一致とR9 canonical ledger readbackをProduction projectionの入力として検証する。
    確認日
    —
    出典・実験ID
    WEBBODY-EA0131-R8-0E44AC14
    検証箇所
    WEBBODY-EA0131-R8-0E44AC14 · content/staging/EA-131.md · EA-131-R5-LEGACY-MIGRATION-20261008-R1
    適用範囲
    R9/R10 canonical readback後のProduction生成時body identity。
    出典・来歴
    CANONICAL_READBACK_BODY_HASH_MATCH
    限界
    body identity/readbackは本文claim自体の真偽や外部ソースの最新性を追加保証しない。
出典ID
COMM-043-EA0131, SRC-EA-131-URL-52C5EFFFA5B8, WEBBODY-EA0131-R8-0E44AC14
追跡中のUNKNOWN ID
EA-131-UNKNOWN-01, EA-131-UNKNOWN-02, EA-131-UNKNOWN-CURRENTNESS
再確認のきっかけ
canonical revision/publication state change · body artifact hash change · source currentness change · new contradiction or implementation readback

機械検査: 通過 — Automated validation does not guarantee accuracy or authorize execution.

    同じ記事IDの機械可読データです。