{ "format": "agent-article-v0", "article_id": "EA-131", "canonical_url": "/tools/ea-131-openai-agents-sdk", "page_type": "reference", "claim_ids": [], "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" ], "operational_object_ids": [], "provider": [ "OpenAI" ], "models": [], "plans": [], "surfaces": [], "regions": [], "current_status": "UNKNOWN", "observation_status": "SPEC_ONLY", "freshness": "UNKNOWN", "last_verified": null, "supersedes": [], "superseded_by": [], "provenance": [ "COMM-043-EA0131", "SRC-EA-131-URL-52C5EFFFA5B8", "WEBBODY-EA0131-R8-0E44AC14" ], "article_sources": [ { "id": "EVD-EA-131-URL-52C5EFFFA5B8", "evidence_class": "RESEARCH", "title": "source_class=official project documentation; exact_title=OpenAI Agents SDK; author/org=OpenAI; canonical_url=", "href": "https://openai.github.io/openai-agents-python/", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-131-URL-52C5EFFFA5B8" ], "supporting_locators": [ "EVIDENCE_TABLE", "- source_class=official project documentation; exact_title=OpenAI Agents SDK; author/org=OpenAI; canonical_url=https://openai.github.io/openai-agents-python/" ], "scope": "EVIDENCE_TABLE", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EA-131-R11-RESEARCH", "evidence_class": "RESEARCH", "title": "EA-131 監査済みresearch / canonical revision binding", "supports": [ "- 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を管理する用途を説明している。\n- NOT_ESTABLISHED: docsのprimitive存在は、任意のプラン・地域・組織設定・model IDでの利用可能性、production安全性、SLA、特定tenantの実挙動、agentが危険actionを自動的に防ぐことを証明しない。" ], "limit": "canonical監査・revision bindingの存在を示す。外部ソースcurrentnessが本文またはcontrol-planeで確定していない場合は、currentnessをUNKNOWNのまま保持する。", "origin_class": "AUDITED_CANONICAL_RESEARCH_PACKET", "source_or_experiment_ids": [ "COMM-043-EA0131" ], "supporting_locators": [ "COMM-043-EA0131", "EA-131-R5-LEGACY-MIGRATION-20261008-R1", "content/staging/EA-131.md" ], "scope": "監査済みEA本文・canonical revision・既存Source Graph relationの範囲。欠損currentnessは推測で閉じない。", "provenance_status": "AUDIT_PASS_CANONICAL_BINDING" }, { "id": "EA-131-R11-WEB-READBACK", "evidence_class": "IMPL", "title": "EA-131 Web body identity / canonical readback", "supports": [ "canonical staging bodyのSHA-256一致とR9 canonical ledger readbackをProduction projectionの入力として検証する。" ], "limit": "body identity/readbackは本文claim自体の真偽や外部ソースの最新性を追加保証しない。", "checked_at": null, "origin_class": "IMPLEMENTATION_READBACK", "source_or_experiment_ids": [ "WEBBODY-EA0131-R8-0E44AC14" ], "supporting_locators": [ "WEBBODY-EA0131-R8-0E44AC14", "content/staging/EA-131.md", "EA-131-R5-LEGACY-MIGRATION-20261008-R1" ], "scope": "R9/R10 canonical readback後のProduction生成時body identity。", "provenance_status": "CANONICAL_READBACK_BODY_HASH_MATCH" } ], "research_sections": [ { "heading": "WHY_THIS_MATTERS_TO_UPDATE", "text": "OpenAI系agent runtimeの構成要素、trace、guardrail、handoff、session等を、将来のprovider mappingへ現行仕様として更新可能な証拠にする。" }, { "heading": "SCOPE_ROUTING", "text": "provider mapping / implementation / governance / security / audit / operability。OpenAI固有のSDK仕様であり、Enterprise AI Coreの一般原則や他providerの可用性へ一般化しない。" }, { "heading": "CLAIM_OR_RESEARCH_QUESTION", "text": "現行公式DocsがAgents SDKのruntime primitivesと導入境界について何を明示しているか。どこまでが仕様記述で、どこからがtenant・契約・production保証の未知か。" }, { "heading": "EVIDENCE_TABLE", "text": "- 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" }, { "heading": "FINDINGS", "text": "- 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を管理する用途を説明している。\n- NOT_ESTABLISHED: docsのprimitive存在は、任意のプラン・地域・組織設定・model IDでの利用可能性、production安全性、SLA、特定tenantの実挙動、agentが危険actionを自動的に防ぐことを証明しない。" }, { "heading": "LIMITS / COUNTEREVIDENCE / FAILURE ENVELOPE", "text": "現行Docsは仕様・導入案内であり、独立benchmarkや全API revisionの互換性表ではない。モデル更新、SDK/package変更、tool側の副作用、trace欠損、guardrail bypass、handoff loopのリスクが残る。" }, { "heading": "AVAILABILITY_GATES", "text": "Python実行環境、package/API version、OpenAI API資格情報・契約・地域・組織設定、対象model ID、Responses API等の依存仕様、MCP/toolの許可、tracingデータの保持・権限。" }, { "heading": "IMPLEMENTATION_STATE", "text": "OSS/Python実装案内 + PRODUCT_VOLATILE。Docs記載のinstall/exampleは実装入口の証拠であり、認証済みtenantでの実行・課金・production validationは未実施。" }, { "heading": "BENCHMARK_OR_EVAL", "text": "公式Docsにtracing/eval機能の記述はあるが、特定業務の精度・安全率・コスト・SLOを示す独立再現benchmarkはこのPacketでは確認していない。UNKNOWN。" }, { "heading": "SECURITY / PRIVACY / AUDIT / COST / OPERABILITY", "text": "Security=guardrails/human-in-loopを制御点として設計するが自動安全保証ではない。Privacy=入力・tool結果・traceの保持と権限を確認。Audit=handoff/tool/guardrail/traceを関連付ける。Cost=モデル呼出し・tool・retry・trace・人手承認を測る。Operability=version pin、timeout、rollback、fail-closedを別途設計。" }, { "heading": "SAFE_WORDING_FOR_FUTURE_BOOK", "text": "「OpenAI Agents SDKの公式Docsは、agent、tool、handoff、guardrail、session、human-in-the-loop、tracing等のruntime構成を示している。これはOpenAI系実装の仕様証拠であり、プラン・地域・組織設定・production安全性・業務品質の保証ではない。」" }, { "heading": "UPDATE_WORK_HANDOFF", "text": "provider mappingへ公式Docsの現行URLとaccess dateを引き継ぐ。次回はpackage release、API revision、model ID、trace schema、guardrail fail-open/closed、MCP権限、価格・データ保持を公式release/API docsと安全な再現試験で補完する。" }, { "heading": "OPEN_UNKNOWN", "text": "current package release/tag、言語別parity、trace/evalの保存境界、model別tool/handoff挙動、tenant availability、障害時のresume/rollback、production failure report。" }, { "heading": "STOP_CONDITION", "text": "SDKの存在をOpenAI製品全体・Enterprise契約・特定tenantの有効化へ外挿しない。exampleの成功を安全な実運用の証拠にしない。\nUNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED\n\n---" }, { "heading": "AUDITED_BOUNDARY", "text": "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." }, { "heading": "OPEN_UNKNOWN", "text": "All UNKNOWN/PRODUCT_VOLATILE/provider- or organization-specific limits from the authority/audit remain open unless explicitly closed by the audited handoff." } ], "human_url": "/tools/ea-131-openai-agents-sdk", "markdown_url": "/agent/article.md?path=%2Ftools%2Fea-131-openai-agents-sdk", "json_url": "/agent/article.json?path=%2Ftools%2Fea-131-openai-agents-sdk" }