---
title: "Pydantic AI：功能、版本和快速入门 · DotsAgent"
description: "Pydantic 维护的 Pydantic AI：许可证、最新版本、MCP 支持、持久化运行、人工审批、追踪和评测，并附有可复制的快速入门。"
url: https://dotsagent.io/zh/frameworks/pydantic-ai
---

框架 · Pydantic

# 快速了解 Pydantic AI

Pydantic 团队打造的 Python agent framework，围绕类型提示、经过验证的结构化输出和依赖注入设计。它支持七种持久化执行引擎，从 Temporal 到 Airflow，并附带 Pydantic Evals。

**适用于：**  需要输出经过验证、类型安全的 Python agent，且希望自行选择持久化执行引擎的场景。

## 关键信息

- **维护者**: Pydantic
- **语言**: Python
- **许可证**: MIT
- **最新版本**: `2.52.0` · 2026年9月30日
- **代码仓库**: [pydantic/pydantic-ai](https://github.com/pydantic/pydantic-ai) · 20,308 个 stars
- **托管选项**: 无

## 快速入门

安装软件包、设置凭据，然后运行官方文档中的最简 agent。这里使用的模型 ID 与文档一致，但你的账户可能尚未启用这些模型。

`安装`

```
pip install pydantic-ai
```

需要 OPENAI_API_KEY (or use Agent('test') offline)

`Python`

```
from 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
```

[快速入门来源](https://ai.pydantic.dev/)

## 功能

| 支持任意模型 | — | 更换模型只需修改字符串；内置离线测试模型 |
| --- | --- | --- |
| MCP 客户端 | — | 作为 agent 的一项 MCP 能力添加 |
| MCP 服务器 | — | — |
| 多 agent | — | 支持 SubAgents，并通过 Pydantic Graph 实现类型安全的控制流 |
| 持久化运行 | — | 支持 Temporal、DBOS、Prefect、Restate、AWS Lambda、Kitaru 或 Airflow |
| 人工审批 | — | 持久化执行期间也支持审批 |
| 追踪 | — | 原生支持 OpenTelemetry；一行代码即可将 trace 发送到 Logfire |
| 评测 | — | Pydantic Evals，是同一项目中的独立包 |

## 近期更新

- 已进入 2.x 系列；1.x 仍会获得维护版本，例如 2026 年 9 月 30 日发布的 v1.107.7。
- 新增 pydantic-ai-harness 包，提供 Coder、Researcher 和 SubAgents。
- 新增实时语音、图像生成和 embeddings。
- 文档已迁移至 pydantic.dev/docs/ai/。

## 同一语言的替代方案

- [OpenAI Agents SDK](https://dotsagent.io/zh/frameworks/openai-agents-python)

- [Claude Agent SDK](https://dotsagent.io/zh/frameworks/claude-agent-sdk)

- [Google ADK](https://dotsagent.io/zh/frameworks/google-adk)

- [Microsoft Agent Framework](https://dotsagent.io/zh/frameworks/microsoft-agent-framework)

- [LangGraph](https://dotsagent.io/zh/frameworks/langgraph)

- [CrewAI](https://dotsagent.io/zh/frameworks/crewai)

## 来源

1. [ai.pydantic.dev](https://ai.pydantic.dev/)/
2. [github.com](https://github.com/pydantic/pydantic-ai)/pydantic/pydantic-ai
3. [pypi.org](https://pypi.org/pypi/pydantic-ai/json)/pypi/pydantic-ai/json
4. [api.github.com](https://api.github.com/repos/pydantic/pydantic-ai/releases)/repos/pydantic/pydantic-ai/releases

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期：2026年10月1日