pydantic/pydantic-ai

AI Agent Framework, the Pydantic way

What it solves

Pydantic AI 旨在简化生产级别生成式 AI 代理和工作流的开发。它解决了缺乏符合人体工学、类型安全且高度可观测的自有框架来构建代理系统的问题，为 AI 代理领域带来类似 FastAPI 的开发者体验。

How it works

它提供一个 Python 框架，将代理定义为通用对象，能够与几乎所有 LLM 提供商（OpenAI、Anthropic、Gemini 等）集成。框架利用 Pydantic 验证，确保代理的输入和结构化输出都是类型安全且经过验证的。它使用依赖注入系统（RunContext）将数据和逻辑传递给工具和指令，实现关注点的清晰分离和更好的可测试性。

Who it’s for

适用于以类型安全、静态类型检查和生产就绪（可观测性、耐久性、系统化评估）为优先的 Python 开发者，构建 AI 代理和 LLM 驱动的应用。

Highlights

  • Model-agnostic: 支持广泛的模型和提供商，包括自定义实现。
  • Fully Type-safe: 通过 Python 类型提示将错误从运行时移至写入时，提升 IDE 支持。
  • Seamless Observability: 与 Pydantic Logfire 紧密集成，提供实时调试和成本追踪。
  • Durable Execution: 在 API 失败或重启时保留进度，适用于长时间工作流。
  • Human-in-the-Loop: 内建支持需要人工批准的工具调用。
  • Extensible Capabilities: 可组合的单元，用于网页搜索、思考和 Model Context Protocol（MCP）集成。
  • Structured Outputs: 支持持续流式传输验证过的结构化数据。