pydanticai-docs

Pydantic AI ドキュメントスキル

Pydantic AI とは？

Pydantic AI は、型安全で依存性注入に対応した生成 AI アプリケーションを構築するための、本番環境対応の Python エージェントフレームワークです。複数の LLM プロバイダー、Pydantic モデルによる構造化出力、組み合わせ可能なマルチエージェントパターンをサポートしています。

ドキュメント：https://ai.pydantic.dev/

---

コアコンセプト

1. エージェントのインスタンス化

from pydantic_ai import Agent

agent = Agent(
    'openai:gpt-4o',          # model string: provider:model-name
    system_prompt='Be helpful.',
)
result = agent.run_sync('What is the capital of France?')
print(result.output)

コンストラクターの全パラメーター、実行メソッド、ストリーミングについては、references/AGENT.md を読み込んでください。

2. 関数ツール（@agent.tool）

from pydantic_ai import Agent, RunContext

agent = Agent('openai:gpt-4o', deps_type=str)

@agent.tool
def get_user_name(ctx: RunContext[str]) -> str:
    """Return the current user's name."""
    return ctx.deps

result = agent.run_sync('What is my name?', deps='Alice')

RunContext が不要な場合は、@agent.tool_plain を使用してください。ツールの登録、戻り値の型、再試行については、references/FUNCTION_TOOLS.md を読み込んでください。

3. 依存性注入（RunContext）

from dataclasses import dataclass
from pydantic_ai import Agent, RunContext

@dataclass
class MyDeps:
    api_key: str
    user_id: int

agent = Agent('openai:gpt-4o', deps_type=MyDeps)

@agent.tool
async def fetch_data(ctx: RunContext[MyDeps]) -> str:
    return f'User {ctx.deps.user_id}'

RunContext のフィールド、システムプロンプトへの注入、出力バリデーターについては、references/DEPENDENCIES.md を読み込んでください。

4. 構造化出力

from pydantic import BaseModel
from pydantic_ai import Agent

class CityInfo(BaseModel):
    city: str
    country: str

agent = Agent('openai:gpt-4o', output_type=CityInfo)
result = agent.run_sync('Where were the 2012 Olympics held?')
print(result.output)  # CityInfo(city='London', country='United Kingdom')

共用体型、プレーンなスカラー値、output_validator、部分的な検証については、references/OUTPUT.md を読み込んでください。

---

その他のトピック

これらのトピックについては、指定されたリファレンスファイルを読み込むか、ドキュメントのリンクを参照してください。ここでは実装コードは提供していません。

トピック	リファレンスファイル	ドキュメントリンク
メッセージ履歴／複数ターンの会話	references/MESSAGES.md	https://ai.pydantic.dev/core-concepts/message-history/index.md
モデル／プロバイダーの設定（すべてのプロバイダー）	references/MODELS.md	https://ai.pydantic.dev/models/overview/index.md
ツールセット（FunctionToolset、合成）	references/TOOLS_AND_TOOLSETS.md	https://ai.pydantic.dev/tools-toolsets/toolsets/index.md
MCP サーバーの統合	references/MCP.md	https://ai.pydantic.dev/mcp/client/index.md
マルチエージェントアプリケーション	ドキュメントリンクのみ	https://ai.pydantic.dev/guides/multi-agent-applications/index.md
グラフ（pydantic-graph）	ドキュメントリンクのみ	https://ai.pydantic.dev/graph/graph/index.md
評価（pydantic-evals）	ドキュメントリンクのみ	https://ai.pydantic.dev/evals/evals/index.md
耐久実行	ドキュメントリンクのみ	https://ai.pydantic.dev/durable_execution/overview/index.md
再試行	ドキュメントリンクのみ	https://ai.pydantic.dev/core-concepts/retries/index.md
テスト（TestModel、override）	ドキュメントリンクのみ	https://ai.pydantic.dev/guides/testing/index.md
Logfire の統合	ドキュメントリンクのみ	https://ai.pydantic.dev/integrations/logfire/index.md
ネイティブツール（旧称：組み込みツール）	ドキュメントリンクのみ	https://ai.pydantic.dev/tools-toolsets/native-tools/index.md
ストリーミング	ドキュメントリンクのみ	https://ai.pydantic.dev/core-concepts/agent/index.md

---

エージェントの動作ルール

1. まずこのファイルを参照する — まずコアコンセプトに基づいて回答し、さらに詳しい情報が必要な場合に限り、ユーザーの質問に関連する特定の references/<CONCEPT>.md を読み込んでください。
2. API の詳細を捏造しない — 上記の公式インデックスにあるリンクを使用し、必ず「詳細については、こちらを参照してください：<URL>」で締めくくってください。
3. コア以外のトピックでは実装コードを提供しない — 「その他のトピック」表に記載されたトピックについては、ドキュメントリンクのみを返してください。
4. 具体性を重視する — ユーザーの質問が特定のプロバイダーを対象としている場合は、概要ではなく、より具体的なページ（例：models/anthropic/index.md）を案内してください。
5. 対象外 — ユーザーのコードを受動的にデバッグしたり、本番環境向けのエージェント実装一式を生成したり、Pydantic AI エコシステムに関係のない質問に回答したりしないでください。