项目简介：Pydantic AI 是由 Pydantic 官方团队开发的 Python 原生 AI Agent 框架，目标是将 FastAPI 的开发体验带到生成式 AI 应用和 Agent 开发中。Pydantic 验证库已被 OpenAI SDK、Anthropic SDK、LangChain 等主流 AI 工具采用，而 Pydantic AI 则直接从源头集成 Pydantic 能力，让开发者能够快速、自信、低痛苦地构建生产级 GenAI 应用和工作流。
🔧 安装要求和过程
环境要求
- Python 3.9+（推荐 Python 3.10+）
- pip 或 uv 包管理器
- 支持的操作系统：Windows / macOS / Linux
快速安装
# 使用 pip 安装
pip install pydantic-ai
# 或使用 uv 安装（推荐）
uv pip install pydantic-ai
# 安装可选依赖（如需运行示例）
pip install "pydantic-ai[examples]"
验证安装
python -c "import pydantic_ai; print(pydantic_ai.__version__)"
🚀 核心功能
1. 官方团队原生开发
Pydantic 验证是 OpenAI SDK、Google ADK、Anthropic SDK、LangChain、LlamaIndex 等主流 AI 工具的基础验证层。Pydantic AI 直接从源头集成 Pydantic 能力，稳定性和兼容性更强。
2. 完全类型安全
充分利用 Python 类型提示，为 IDE 提供充足上下文，支持自动补全和静态类型检查，将大量运行时错误提前到编写时发现，获得类似 Rust “编译通过即可用” 的开发体验。
3. 模型无关性
支持几乎所有主流模型和提供商：OpenAI、Anthropic、Gemini、DeepSeek、Grok、Cohere、Mistral、Perplexity；云厂商：Azure AI Foundry、Amazon Bedrock、Google Cloud；本地推理：Ollama、LiteLLM、Groq、OpenRouter 等。未覆盖的模型可通过自定义模型扩展。
4. 无缝可观测性
深度集成 Pydantic Logfire（通用 OpenTelemetry 可观测平台），支持实时调试、基于评估的性能监控、行为追踪、成本追踪。同时也支持其他兼容 OpenTelemetry 的可观测平台。
5. 强大的评估与扩展能力
支持系统化测试和评估 Agent 系统的性能和准确性；支持通过可组合的能力（Capabilities）构建 Agent，能力可打包工具、钩子、指令、模型设置为可复用单元；支持完全通过 YAML/JSON 定义 Agent，无需编写代码。
💡 典型使用场景
场景一：银行客服 Agent
构建具备工具调用、依赖注入、结构化输出的银行客服 Agent。通过 RunContext 注入数据库连接，使用 Pydantic BaseModel 定义结构化输出，实现类型安全的 Agent 响应。
from pydantic_ai import Agent, RunContext
from pydantic import BaseModel
class SupportOutput(BaseModel):
support_advice: str
block_card: bool
risk: int
agent = Agent('openai:gpt-5.2', output_type=SupportOutput)
场景二：带可观测性的生产级 Agent
集成 Pydantic Logfire 实现全链路可观测性，监控 Agent 的完整运行链路、工具调用、数据库查询、Token 消耗和成本追踪，让生产环境 AI 应用透明可控。
import logfire
logfire.configure()
logfire.instrument_pydantic_ai()
logfire.instrument_sqlite3()
💬 推荐理由
Pydantic AI 是我见过的类型安全做得最彻底的 Python AI Agent 框架。如果你已经在用 Pydantic 做数据验证（相信我，你一定在用），那么 Pydantic AI 会让你感觉”回家了”。
最打动我的是它的开发体验——类型提示让 IDE 自动补全几乎能”预测”你想写什么，大量潜在错误在编写阶段就被捕获，而不是在运行时才爆雷。这种”编译通过即可用”的 Rust 式体验，在 Python AI 开发中实在难能可贵。
另外，Pydantic 团队在构建 Pydantic Logfire 时因为没有找到符合预期的 Agent 框架，干脆自己造了一个——这种”自己用它才做得好”的项目，质量通常有保障。目前 17.9K Stars，正处于快速成长阶段，现在上手正当其时。
📥 下载地址
🚀 Pydantic AI —— 类型安全的 AI Agent 框架，让 GenAI 开发像 FastAPI 一样流畅