No English page yet. Showing the Japanese source.
PydanticAI
記事状態: 公開 · 最終確認: 未確認
要点
「Pydantic AIの公式資料は、型付きPython agent loop、tools、structured output、複数model接続、streaming・durable execution・instrumentationを実装要素として示す。型検証やdurabilityの記載は、LLMの真偽・認可・外部action安全性・全providerの同一性を保証しない。」
現在の判断
- ESTABLISHED: 公式資料は、Pydantic AIをPython SDKとして、typed agent loop、model/provider差し替え、tools、structured output、agent graph、streaming、durable execution連携、OpenTelemetry instrumentationの実装要素として記載している。
- NOT_ESTABLISHED: schema/型検証が事実性・意味的正しさ・認可・prompt injection耐性・外部side effect安全性を保証すること、全provider/model/versionで同一挙動になること、production SLOやtenant可用性は確立していない。
どこまで当てはまるか
Enterprise AI Core / implementation / interoperability / governance / audit / operability。Pydantic validationの存在とLLMの真偽・安全性を分離する。
詳しく理解する
なぜ重要か
typed agent loop、structured output、model交換、tool・durable execution・observabilityの現行実装境界を、Python系frameworkのprovider mappingへ反映する。
対象範囲と前提
Enterprise AI Core / implementation / interoperability / governance / audit / operability。Pydantic validationの存在とLLMの真偽・安全性を分離する。
検討ポイント
現行Pydantic AI公式DocsがAgent・typed output・model/provider・tool・durability・instrumentationを何と記載しているか。
EVIDENCE TABLE
- 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
- 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
利用できる条件
Python/package version、model adapterとmodel ID、provider資格情報・契約・地域、optional Temporal/DBOS/Prefect/Restate等のruntime、Logfire/OTel backend、MCP/tool権限、state/traceの保持・削除。
実装・運用
OSS/Python official docs + PRODUCT_VOLATILE。install/exampleは実装入口で、認証済みtenant・外部書込み・durable recovery実測は未実施。
確認・評価方法
公式Docsのvalidation・instrumentation記述はAPI機能の証拠。特定業務の精度、安全率、durable SLO、cost/latencyの独立再現benchmarkはこのPacketで確認しておらずUNKNOWN。
セキュリティとプライバシー
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を試験。
AUDITED BOUNDARY
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.
確認できていること
ESTABLISHED: 公式資料は、Pydantic AIをPython SDKとして、typed agent loop、model/provider差し替え、tools、structured output、agent graph、streaming、durable execution連携、OpenTelemetry instrumentationの実装要素として記載している。
NOT_ESTABLISHED: schema/型検証が事実性・意味的正しさ・認可・prompt injection耐性・外部side effect安全性を保証すること、全provider/model/versionで同一挙動になること、production SLOやtenant可用性は確立していない。
よくある失敗・反証
型に適合した誤情報、retryによる重複tool call、model/providerの拒否差、durable再実行時のside effect、traceに記録されない情報が残る。公式Docsの「every model」「runs everywhere」等は設計意図・provider表現として扱い、全model実証へ広げない。
「typed」「validated」「durable」を正しさ・安全性・exactly-once・SLAへ読み替えない。Docs sampleやREADME claimだけで本番採用を閉じない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED
---
実務での使い方
Python/package version、model adapterとmodel ID、provider資格情報・契約・地域、optional Temporal/DBOS/Prefect/Restate等のruntime、Logfire/OTel backend、MCP/tool権限、state/traceの保持・削除。
OSS/Python official docs + PRODUCT_VOLATILE。install/exampleは実装入口で、認証済みtenant・外部書込み・durable recovery実測は未実施。
公式Docsのvalidation・instrumentation記述はAPI機能の証拠。特定業務の精度、安全率、durable SLO、cost/latencyの独立再現benchmarkはこのPacketで確認しておらずUNKNOWN。
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を試験。
Python framework mappingへ、typed controlとsemantic verificationを別列で渡す。次回は固定release/tag・provider matrix・durable retry semantics・trace schema・license/support・公開issue/incidentを補い、危険toolを使わない再現TEST_PROFILEを作る。
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.
まだ確認できていないこと
- EA-137-UNKNOWN-01
current package release/commit、provider別feature parity、schema適合後のsemantic error、durable exactly-once相当性、trace data boundary、tenant/region availability、実業務benchmark。
- EA-137-UNKNOWN-02
All UNKNOWN/PRODUCT_VOLATILE/provider- or organization-specific limits from authority/audit remain open unless explicitly closed by the audited handoff.
- EA-137-UNKNOWN-CURRENTNESS
外部根拠の再確認日がcanonical body/control-planeで確定していないため、currentnessはUNKNOWNとして保持する。日付を推測補完しない。
根拠資料
- 研究資料研究資料
source_class=official project documentation; exact_title=Pydantic AI; author/org=Pydantic; canonical_url=
確認上の限界
元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
- 研究資料研究資料
source_class=author-maintained implementation documentation; exact_title=pydantic-ai agent guide; author/org=Pydantic; canonical_url=
確認上の限界
元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
出典ID・検証情報・機械可読データ
根拠の種類と情報の鮮度は、ラベルとアイコンで確認できます。
- 記事ID
- EA-137
- 最終確認日
- —
- 提供元・モデル・プラン・利用環境
- —
- 対象地域
- —
元資料の全文と収録照合記録
WHY_THIS_MATTERS_TO_UPDATE
typed agent loop、structured output、model交換、tool・durable execution・observabilityの現行実装境界を、Python系frameworkのprovider mappingへ反映する。
SCOPE_ROUTING
Enterprise AI Core / implementation / interoperability / governance / audit / operability。Pydantic validationの存在とLLMの真偽・安全性を分離する。
CLAIM_OR_RESEARCH_QUESTION
現行Pydantic AI公式DocsがAgent・typed output・model/provider・tool・durability・instrumentationを何と記載しているか。
EVIDENCE_TABLE
- 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
- 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
FINDINGS
- ESTABLISHED: 公式資料は、Pydantic AIをPython SDKとして、typed agent loop、model/provider差し替え、tools、structured output、agent graph、streaming、durable execution連携、OpenTelemetry instrumentationの実装要素として記載している。
- NOT_ESTABLISHED: schema/型検証が事実性・意味的正しさ・認可・prompt injection耐性・外部side effect安全性を保証すること、全provider/model/versionで同一挙動になること、production SLOやtenant可用性は確立していない。
LIMITS / COUNTEREVIDENCE / FAILURE ENVELOPE
型に適合した誤情報、retryによる重複tool call、model/providerの拒否差、durable再実行時のside effect、traceに記録されない情報が残る。公式Docsの「every model」「runs everywhere」等は設計意図・provider表現として扱い、全model実証へ広げない。
AVAILABILITY_GATES
Python/package version、model adapterとmodel ID、provider資格情報・契約・地域、optional Temporal/DBOS/Prefect/Restate等のruntime、Logfire/OTel backend、MCP/tool権限、state/traceの保持・削除。
IMPLEMENTATION_STATE
OSS/Python official docs + PRODUCT_VOLATILE。install/exampleは実装入口で、認証済みtenant・外部書込み・durable recovery実測は未実施。
BENCHMARK_OR_EVAL
公式Docsのvalidation・instrumentation記述はAPI機能の証拠。特定業務の精度、安全率、durable SLO、cost/latencyの独立再現benchmarkはこのPacketで確認しておらずUNKNOWN。
SECURITY / PRIVACY / AUDIT / COST / OPERABILITY
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を試験。
SAFE_WORDING_FOR_FUTURE_BOOK
「Pydantic AIの公式資料は、型付きPython agent loop、tools、structured output、複数model接続、streaming・durable execution・instrumentationを実装要素として示す。型検証やdurabilityの記載は、LLMの真偽・認可・外部action安全性・全providerの同一性を保証しない。」
UPDATE_WORK_HANDOFF
Python framework mappingへ、typed controlとsemantic verificationを別列で渡す。次回は固定release/tag・provider matrix・durable retry semantics・trace schema・license/support・公開issue/incidentを補い、危険toolを使わない再現TEST_PROFILEを作る。
OPEN_UNKNOWN
current package release/commit、provider別feature parity、schema適合後のsemantic error、durable exactly-once相当性、trace data boundary、tenant/region availability、実業務benchmark。
STOP_CONDITION
「typed」「validated」「durable」を正しさ・安全性・exactly-once・SLAへ読み替えない。Docs sampleやREADME claimだけで本番採用を閉じない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED
---
AUDITED_BOUNDARY
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.
OPEN_UNKNOWN
All UNKNOWN/PRODUCT_VOLATILE/provider- or organization-specific limits from authority/audit remain open unless explicitly closed by the audited handoff.
EVD-EA-137-URL-6B0FDAB392FB研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE- 裏付ける内容
- —
- 確認日
- —
- 出典・実験ID
- SRC-EA-137-URL-6B0FDAB392FB
- 検証箇所
- EVIDENCE_TABLE · - source_class=official project documentation; exact_title=Pydantic AI; author/org=Pydantic; canonical_url=https://pydantic.dev/docs/ai/overview/
- 適用範囲
- EVIDENCE_TABLE
- 出典・来歴
- SOURCE_PACKET_REFERENCE_PROJECTED
- 限界
- 元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
EVD-EA-137-URL-949203C9ED00研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE- 裏付ける内容
- —
- 確認日
- —
- 出典・実験ID
- SRC-EA-137-URL-949203C9ED00
- 検証箇所
- 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
- 適用範囲
- EVIDENCE_TABLE
- 出典・来歴
- SOURCE_PACKET_REFERENCE_PROJECTED
- 限界
- 元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
EA-137-R11-RESEARCH研究資料研究資料根拠の出所: AUDITED_CANONICAL_RESEARCH_PACKETEA-137 監査済みresearch / canonical revision binding
- 裏付ける内容
- - ESTABLISHED: 公式資料は、Pydantic AIをPython SDKとして、typed agent loop、model/provider差し替え、tools、structured output、agent graph、streaming、durable execution連携、OpenTelemetry instrumentationの実装要素として記載している。 - NOT_ESTABLISHED: schema/型検証が事実性・意味的正しさ・認可・prompt injection耐性・外部side effect安全性を保証すること、全provider/model/versionで同一挙動になること、production SLOやtenant可用性は確立していない。
- 確認日
- —
- 出典・実験ID
- COMM-044-EA0137
- 検証箇所
- COMM-044-EA0137 · EA-137-R5-LEGACY-MIGRATION-20261008-R1 · content/staging/EA-137.md
- 適用範囲
- 監査済みEA本文・canonical revision・既存Source Graph relationの範囲。欠損currentnessは推測で閉じない。
- 出典・来歴
- AUDIT_PASS_CANONICAL_BINDING
- 限界
- canonical監査・revision bindingの存在を示す。外部ソースcurrentnessが本文またはcontrol-planeで確定していない場合は、currentnessをUNKNOWNのまま保持する。
EA-137-R11-WEB-READBACK実装資料実装資料根拠の出所: IMPLEMENTATION_READBACKEA-137 Web body identity / canonical readback
- 裏付ける内容
- canonical staging bodyのSHA-256一致とR9 canonical ledger readbackをProduction projectionの入力として検証する。
- 確認日
- —
- 出典・実験ID
- WEBBODY-EA0137-R8-385942AF
- 検証箇所
- WEBBODY-EA0137-R8-385942AF · content/staging/EA-137.md · EA-137-R5-LEGACY-MIGRATION-20261008-R1
- 適用範囲
- R9/R10 canonical readback後のProduction生成時body identity。
- 出典・来歴
- CANONICAL_READBACK_BODY_HASH_MATCH
- 限界
- body identity/readbackは本文claim自体の真偽や外部ソースの最新性を追加保証しない。
- 出典ID
- COMM-044-EA0137, SRC-EA-137-URL-6B0FDAB392FB, SRC-EA-137-URL-949203C9ED00, WEBBODY-EA0137-R8-385942AF
- 追跡中のUNKNOWN ID
- EA-137-UNKNOWN-01, EA-137-UNKNOWN-02, EA-137-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の機械可読データです。