Framework · Pydantic
Pydantic AI の概要
Pydanticチームが開発するPythonエージェントフレームワークです。型ヒント、検証済みの構造化出力、依存性注入を中心に設計されています。TemporalからAirflowまで7つのエンジンで耐久実行できる点が特長で、Pydantic Evalsも付属します。
おすすめの用途: 出力の検証が必要な型安全なPythonエージェントと、好みの耐久実行エンジンを使いたい場合。
基本情報
- メンテナー
- Pydantic
- 言語
- Python
- ライセンス
- MIT
- 最新バージョン
2.52.0· 2026年9月30日- リポジトリ
- pydantic/pydantic-ai
- ホスティング विकल्प
- なし
クイックスタート
パッケージをインストールして認証情報を設定し、公式ドキュメントにある最小構成のエージェントを実行します。モデル ID はドキュメントで使われているものです。アカウントで有効になっていない場合があります。
pip install pydantic-aifrom typing import Literal
from pydantic import BaseModel, Field
from pydantic_ai import Agent, RunContext
class Sentiment(BaseModel):
label: Literal['positive', 'negative', 'neutral']
score: float = Field(ge=-1, le=1)
agent = Agent('openai:gpt-6-sol', output_type=Sentiment)
@agent.tool
def recent_reviews(ctx: RunContext, product: str) -> list[str]:
"""Fetch recent review snippets for a product."""
return ['The new release fixed everything I complained about!']
result = agent.run_sync('How are people feeling about the Extract app?')
print(result.output)
#> label='positive' score=0.9機能
| 任意のモデル | はい | モデルの切り替えは文字列の変更だけ。オフラインテスト用モデルも付属 |
|---|---|---|
| MCPクライアント | はい | エージェントにMCP機能として追加 |
| MCPサーバー | 未確認 | |
| マルチエージェント | はい | SubAgents機能と、Pydantic Graphによる型付き制御フロー |
| 耐久性のある実行 | はい | Temporal、DBOS、Prefect、Restate、AWS Lambda、Kitaru、Airflowに対応 |
| 人による承認 | はい | 耐久実行でも承認に対応 |
| トレーシング | はい | OpenTelemetryネイティブ。1行の設定でLogfireにトレースを送信 |
| Evals | はい | 同じプロジェクトの別パッケージ、Pydantic Evals |
最近の変更
- 2.x系に移行。1.xもメンテナンスリリースが提供されており、2026年9月30日にはv1.107.7がリリースされました。
- 新しいpydantic-ai-harnessパッケージで、Coder、Researcher、SubAgentsが追加されました。
- リアルタイム音声、画像生成、埋め込みに対応しました。
- ドキュメントのURLがpydantic.dev/docs/ai/に変更されました。