Skip to content

Evidence for AI operations

No English page yet. Showing the Japanese source.

Back to the entrance

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として保持する。日付を推測補完しない。

根拠資料

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

    source_class=official project documentation; exact_title=Pydantic AI; author/org=Pydantic; canonical_url=

    裏付ける内容
    —
    確認日
    —
    出典・実験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

    source_class=author-maintained implementation documentation; exact_title=pydantic-ai agent guide; author/org=Pydantic; canonical_url=

    裏付ける内容
    —
    確認日
    —
    出典・実験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_PACKET

    EA-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_READBACK

    EA-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の機械可読データです。