pydantic/pydantic-ai

这是什么？

核心功能

• 01通过模型字符串在众多模型提供商之间切换。
• 02支持结构化且经过校验的输出，以及带依赖注入的类型化工具。
• 03同一智能体可作为命令行、Web 聊天、实时语音或 UI 事件流运行。
• 04支持 Temporal、DBOS、Prefect 等引擎的持久化执行。
• 05基于 OpenTelemetry 的埋点，可追踪模型与工具调用。
• 06同一个包内提供图像生成和 embedding 功能。

适用场景

• 构建数据抽取流程，将 LLM 输出转为经过校验的 Pydantic 模型。
• 通过 Temporal 或 DBOS 运行需要在重启后继续执行的长时间研究型智能体。
• 为实时语音助手接入内部工具，在对话过程中调用。
• 基于测试数据集评估智能体的回答和工具调用行为。

快速上手

1. 1

   使用 uv 安装软件包

   uv add pydantic-ai
2. 2

   创建一个 Python 文件，定义 Agent 并调用 agent.run_sync(...) 获取类型化结果

使用前须知

• !运行示例调用托管模型需要对应提供商的 API 密钥，README 对此说明不够详细。
• !持久化执行、实时语音等高级功能需要安装额外依赖，并配置 Temporal 等独立后端。

标签

常见问题

pydantic-ai 是什么？

类型安全的 Python AI SDK，用于构建可切换多种模型、支持 Web、命令行、语音和持久化工作流的智能体。 Pydantic AI 是一个 Python AI SDK，用于构建输入、输出和依赖都带类型的智能体。只需修改一个字符串即可切换 OpenAI、Anthropic、Google、Groq 等提供商的模型，同一个智能体还能以命令行、内置 Web 聊天、实时语音或 UI 事件流的形式对外提供服务。

pydantic-ai 可以免费使用吗？用的什么许可证？

pydantic-ai 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

pydantic-ai 还在维护吗？

活跃维护中。pydantic-ai 最近一次提交是在 2026年10月20日。

pydantic-ai 适合用来做什么？

构建数据抽取流程，将 LLM 输出转为经过校验的 Pydantic 模型。 通过 Temporal 或 DBOS 运行需要在重启后继续执行的长时间研究型智能体。 为实时语音助手接入内部工具，在对话过程中调用。 基于测试数据集评估智能体的回答和工具调用行为。

pydantic-ai 怎么安装和运行？

使用 uv 安装软件包: uv add pydantic-ai 创建一个 Python 文件，定义 Agent 并调用 agent.run_sync(...) 获取类型化结果

在哪里获取 pydantic-ai？

源代码和安装说明在 GitHub 上：https://github.com/pydantic/pydantic-ai