# OpenAI Agents SDK CURRENT_STATUS: UNKNOWN OBSERVATION: SPEC_ONLY FRESHNESS: UNKNOWN PAGE_TYPE: reference CANONICAL_URL: /tools/ea-131-openai-agents-sdk CLAIM_IDS: none EVIDENCE_IDS: EVD-EA-131-URL-52C5EFFFA5B8, EA-131-R11-RESEARCH, EA-131-R11-WEB-READBACK UNKNOWN_IDS: EA-131-UNKNOWN-01, EA-131-UNKNOWN-02, EA-131-UNKNOWN-CURRENTNESS OPS_IDS: none ## Summary 「OpenAI Agents SDKの公式Docsは、agent、tool、handoff、guardrail、session、human-in-the-loop、tracing等のruntime構成を示している。これはOpenAI系実装の仕様証拠であり、プラン・地域・組織設定・production安全性・業務品質の保証ではない。」 ## Current judgment - 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を自動的に防ぐことを証明しない。 ## Scope provider mapping / implementation / governance / security / audit / operability。OpenAI固有のSDK仕様であり、Enterprise AI Coreの一般原則や他providerの可用性へ一般化しない。 ## Confirmed - 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を自動的に防ぐことを証明しない。 ## UNKNOWN - 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として保持する。日付を推測補完しない。 ## Evidence - EVD-EA-131-URL-52C5EFFFA5B8 (RESEARCH): source_class=official project documentation; exact_title=OpenAI Agents SDK; author/org=OpenAI; canonical_url= — https://openai.github.io/openai-agents-python/ - EA-131-R11-RESEARCH (RESEARCH): EA-131 監査済みresearch / canonical revision binding - EA-131-R11-WEB-READBACK (IMPL): EA-131 Web body identity / canonical readback ## Failure / limits 現行Docsは仕様・導入案内であり、独立benchmarkや全API revisionの互換性表ではない。モデル更新、SDK/package変更、tool側の副作用、trace欠損、guardrail bypass、handoff loopのリスクが残る。 ## Failure / limits SDKの存在をOpenAI製品全体・Enterprise契約・特定tenantの有効化へ外挿しない。exampleの成功を安全な実運用の証拠にしない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED --- ## Practice Python実行環境、package/API version、OpenAI API資格情報・契約・地域・組織設定、対象model ID、Responses API等の依存仕様、MCP/toolの許可、tracingデータの保持・権限。 ## Practice OSS/Python実装案内 + PRODUCT_VOLATILE。Docs記載のinstall/exampleは実装入口の証拠であり、認証済みtenantでの実行・課金・production validationは未実施。 ## Practice 公式Docsにtracing/eval機能の記述はあるが、特定業務の精度・安全率・コスト・SLOを示す独立再現benchmarkはこのPacketでは確認していない。UNKNOWN。 ## Practice Security=guardrails/human-in-loopを制御点として設計するが自動安全保証ではない。Privacy=入力・tool結果・traceの保持と権限を確認。Audit=handoff/tool/guardrail/traceを関連付ける。Cost=モデル呼出し・tool・retry・trace・人手承認を測る。Operability=version pin、timeout、rollback、fail-closedを別途設計。 ## Practice provider mappingへ公式Docsの現行URLとaccess dateを引き継ぐ。次回はpackage release、API revision、model ID、trace schema、guardrail fail-open/closed、MCP権限、価格・データ保持を公式release/API docsと安全な再現試験で補完する。 ## Practice 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. ## 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. NEXT: /agent/start.json STOP: This is a knowledge projection, not an execution order.