PydanticAI ビジュアルガイド

Cookbook

動作確認済みスニペット集

レッスンで学んだ概念を、より実用的なシナリオに落とし込んだ完成形のレシピ集。各レシピは Colab で 1 ファイル完結、コピーして即試せる単位で公開します。

実用AgentMultimodalMulti-Agent / MCPProduction9 レシピ予定

実用Agent

3 recipes

Bank Support Agent

Draft

口座照会と振込予約を担当するサポートAgent。Function Tool + 構造化出力 + DI の典型例。

@agent.tooloutput_typeDependenciesPydantic Validation

Weather Agent

Draft

外部APIを叩いて天気を返すAgent。並列ツール呼び出しとリトライの基本パターン。

@agent.toolModelRetryAsync toolsJSON parsing

SQL Generation Agent

Draft

自然言語からPostgreSQL向けSQLを生成し、ドライランで検証するAgent。型安全な出力の応用例。

output_typeValidationReflectionTestModel

Multimodal

3 recipes

Image Tagging Agent

Draft

画像URLを受け取り、構造化タグ (カテゴリ・色・物体) を返す。Gemini のマルチモーダル入力例。

ImageUrloutput_typeUnion 型

PDF Summarizer

Draft

数十ページのPDFを章構造を保ったまま要約するAgent。Gemini のドキュメント入力 + 構造化出力。

BinaryContentoutput_typeStreamed Output

YouTube Explainer

Draft

YouTubeのURLを渡すだけで動画内容を要約・字幕化。Gemini固有機能のショーケース。

YouTube URL inputoutput_typeThinking

Multi-Agent / MCP

2 recipes

MCP File System Bridge

Draft

公式MCPサーバー (filesystem) をPydanticAIに繋ぎ、Geminiにファイル読み書きさせる。

MCP ClientToolsetPermissions

Triage → Specialist Hand-off

Draft

受付Agentが内容を分類し、専門Agentに完全ハンドオフするマルチエージェントの基礎パターン。

Hand-offPydantic GraphDelegation

Production

1 recipes

LLM-Judge による継続評価

Draft

Pydantic Evals + LLM-Judge で本番Agent出力の品質劣化を継続検知するパイプライン。

Pydantic EvalsLLM-JudgeLogfire

レシピのリクエスト

「この処理ってどう書くの?」と感じたユースケースがあれば、ぜひ GitHub Issues で リクエストしてください。需要が高いレシピから順に整備していきます。

プロジェクトについて →