{ "format": "agent-article-v0", "article_id": "EA-137", "canonical_url": "/tools/ea-137-pydanticai", "page_type": "reference", "claim_ids": [], "evidence_ids": [ "EVD-EA-137-URL-6B0FDAB392FB", "EVD-EA-137-URL-949203C9ED00", "EA-137-R11-RESEARCH", "EA-137-R11-WEB-READBACK" ], "unknown_ids": [ "EA-137-UNKNOWN-01", "EA-137-UNKNOWN-02", "EA-137-UNKNOWN-CURRENTNESS" ], "operational_object_ids": [], "provider": [], "models": [], "plans": [], "surfaces": [], "regions": [], "current_status": "UNKNOWN", "observation_status": "SPEC_ONLY", "freshness": "UNKNOWN", "last_verified": null, "supersedes": [], "superseded_by": [], "provenance": [ "COMM-044-EA0137", "SRC-EA-137-URL-6B0FDAB392FB", "SRC-EA-137-URL-949203C9ED00", "WEBBODY-EA0137-R8-385942AF" ], "article_sources": [ { "id": "EVD-EA-137-URL-6B0FDAB392FB", "evidence_class": "RESEARCH", "title": "source_class=official project documentation; exact_title=Pydantic AI; author/org=Pydantic; canonical_url=", "href": "https://pydantic.dev/docs/ai/overview/", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-137-URL-6B0FDAB392FB" ], "supporting_locators": [ "EVIDENCE_TABLE", "- source_class=official project documentation; exact_title=Pydantic AI; author/org=Pydantic; canonical_url=https://pydantic.dev/docs/ai/overview/" ], "scope": "EVIDENCE_TABLE", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EVD-EA-137-URL-949203C9ED00", "evidence_class": "RESEARCH", "title": "source_class=author-maintained implementation documentation; exact_title=pydantic-ai agent guide; author/org=Pydantic; canonical_url=", "href": "https://github.com/pydantic/pydantic-ai/blob/main/docs/agent.md", "supports": [], "limit": "元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。", "origin_class": "SOURCE_PACKET_REFERENCE", "source_or_experiment_ids": [ "SRC-EA-137-URL-949203C9ED00" ], "supporting_locators": [ "EVIDENCE_TABLE", "- source_class=author-maintained implementation documentation; exact_title=pydantic-ai agent guide; author/org=Pydantic; canonical_url=https://github.com/pydantic/pydantic-ai/blob/main/docs/agent.md" ], "scope": "EVIDENCE_TABLE", "provenance_status": "SOURCE_PACKET_REFERENCE_PROJECTED" }, { "id": "EA-137-R11-RESEARCH", "evidence_class": "RESEARCH", "title": "EA-137 監査済みresearch / canonical revision binding", "supports": [ "- ESTABLISHED: 公式資料は、Pydantic AIをPython SDKとして、typed agent loop、model/provider差し替え、tools、structured output、agent graph、streaming、durable execution連携、OpenTelemetry instrumentationの実装要素として記載している。\n- NOT_ESTABLISHED: schema/型検証が事実性・意味的正しさ・認可・prompt injection耐性・外部side effect安全性を保証すること、全provider/model/versionで同一挙動になること、production SLOやtenant可用性は確立していない。" ], "limit": "canonical監査・revision bindingの存在を示す。外部ソースcurrentnessが本文またはcontrol-planeで確定していない場合は、currentnessをUNKNOWNのまま保持する。", "origin_class": "AUDITED_CANONICAL_RESEARCH_PACKET", "source_or_experiment_ids": [ "COMM-044-EA0137" ], "supporting_locators": [ "COMM-044-EA0137", "EA-137-R5-LEGACY-MIGRATION-20261008-R1", "content/staging/EA-137.md" ], "scope": "監査済みEA本文・canonical revision・既存Source Graph relationの範囲。欠損currentnessは推測で閉じない。", "provenance_status": "AUDIT_PASS_CANONICAL_BINDING" }, { "id": "EA-137-R11-WEB-READBACK", "evidence_class": "IMPL", "title": "EA-137 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-EA0137-R8-385942AF" ], "supporting_locators": [ "WEBBODY-EA0137-R8-385942AF", "content/staging/EA-137.md", "EA-137-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": "typed agent loop、structured output、model交換、tool・durable execution・observabilityの現行実装境界を、Python系frameworkのprovider mappingへ反映する。" }, { "heading": "SCOPE_ROUTING", "text": "Enterprise AI Core / implementation / interoperability / governance / audit / operability。Pydantic validationの存在とLLMの真偽・安全性を分離する。" }, { "heading": "CLAIM_OR_RESEARCH_QUESTION", "text": "現行Pydantic AI公式DocsがAgent・typed output・model/provider・tool・durability・instrumentationを何と記載しているか。" }, { "heading": "EVIDENCE_TABLE", "text": "- source_class=official project documentation; exact_title=Pydantic AI; author/org=Pydantic; canonical_url=https://pydantic.dev/docs/ai/overview/; publication/update/access_date=current docs accessed 2026-09-13 JST; version/release/tag/commit/API revision=current documentation（固定package release/tagはページ上で未固定）; supporting_locator=Overview / What are you building? / typed output / Durable execution / Instrumentation（Python AI SDK、typed end-to-end agent loop、model interface、tools、structured output、Temporal等のdurable execution、OpenTelemetry/Logfireの記述。pip install pydantic-aiの導入例）; evidence_label=VERIFIED_SPEC+PRODUCT_VOLATILE; relation=support+limit\n- source_class=author-maintained implementation documentation; exact_title=pydantic-ai agent guide; author/org=Pydantic; canonical_url=https://github.com/pydantic/pydantic-ai/blob/main/docs/agent.md; publication/update/access_date=current main branch accessed 2026-09-13 JST; version/release/tag/commit/API revision=main（commit未固定）; supporting_locator=Introduction / Agent components / Running Agents / structured output validation / graph iteration / retries（Agentのinstructions・tools・structured output・dependency・model settings、run/run_sync/stream/iter、Pydantic validationとretryの説明）; evidence_label=OSS_PRACTICE+PRODUCT_VOLATILE; relation=support+context" }, { "heading": "FINDINGS", "text": "- ESTABLISHED: 公式資料は、Pydantic AIをPython SDKとして、typed agent loop、model/provider差し替え、tools、structured output、agent graph、streaming、durable execution連携、OpenTelemetry instrumentationの実装要素として記載している。\n- NOT_ESTABLISHED: schema/型検証が事実性・意味的正しさ・認可・prompt injection耐性・外部side effect安全性を保証すること、全provider/model/versionで同一挙動になること、production SLOやtenant可用性は確立していない。" }, { "heading": "LIMITS / COUNTEREVIDENCE / FAILURE ENVELOPE", "text": "型に適合した誤情報、retryによる重複tool call、model/providerの拒否差、durable再実行時のside effect、traceに記録されない情報が残る。公式Docsの「every model」「runs everywhere」等は設計意図・provider表現として扱い、全model実証へ広げない。" }, { "heading": "AVAILABILITY_GATES", "text": "Python/package version、model adapterとmodel ID、provider資格情報・契約・地域、optional Temporal/DBOS/Prefect/Restate等のruntime、Logfire/OTel backend、MCP/tool権限、state/traceの保持・削除。" }, { "heading": "IMPLEMENTATION_STATE", "text": "OSS/Python official docs + PRODUCT_VOLATILE。install/exampleは実装入口で、認証済みtenant・外部書込み・durable recovery実測は未実施。" }, { "heading": "BENCHMARK_OR_EVAL", "text": "公式Docsのvalidation・instrumentation記述はAPI機能の証拠。特定業務の精度、安全率、durable SLO、cost/latencyの独立再現benchmarkはこのPacketで確認しておらずUNKNOWN。" }, { "heading": "SECURITY / PRIVACY / AUDIT / COST / OPERABILITY", "text": "Security=schema validationをauthorizationの代替にしない。Privacy=prompt・tool・state・traceのPII境界を設定。Audit=agent/model/version、tool、validation/retry、state、approvalを相関。Cost=LLM・retry・durable backend・observabilityを含める。Operability=version pin、idempotency、timeout、resume/rollback、provider failureを試験。" }, { "heading": "SAFE_WORDING_FOR_FUTURE_BOOK", "text": "「Pydantic AIの公式資料は、型付きPython agent loop、tools、structured output、複数model接続、streaming・durable execution・instrumentationを実装要素として示す。型検証やdurabilityの記載は、LLMの真偽・認可・外部action安全性・全providerの同一性を保証しない。」" }, { "heading": "UPDATE_WORK_HANDOFF", "text": "Python framework mappingへ、typed controlとsemantic verificationを別列で渡す。次回は固定release/tag・provider matrix・durable retry semantics・trace schema・license/support・公開issue/incidentを補い、危険toolを使わない再現TEST_PROFILEを作る。" }, { "heading": "OPEN_UNKNOWN", "text": "current package release/commit、provider別feature parity、schema適合後のsemantic error、durable exactly-once相当性、trace data boundary、tenant/region availability、実業務benchmark。" }, { "heading": "STOP_CONDITION", "text": "「typed」「validated」「durable」を正しさ・安全性・exactly-once・SLAへ読み替えない。Docs sampleやREADME claimだけで本番採用を閉じない。\nUNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED\n\n---" }, { "heading": "AUDITED_BOUNDARY", "text": "PydanticAI V1/V2 distinction preserved; typed validation is not semantic or authorization assurance; durable execution is not exactly-once external-side-effect assurance; security claims require patched version/configuration; independent production evidence UNKNOWN." }, { "heading": "OPEN_UNKNOWN", "text": "All UNKNOWN/PRODUCT_VOLATILE/provider- or organization-specific limits from authority/audit remain open unless explicitly closed by the audited handoff." } ], "human_url": "/tools/ea-137-pydanticai", "markdown_url": "/agent/article.md?path=%2Ftools%2Fea-137-pydanticai", "json_url": "/agent/article.json?path=%2Ftools%2Fea-137-pydanticai" }