用途:PydanticAI 是 Pydantic 团队开发的 Python 智能体框架,用于构建生产级 AI 智能体、聊天机器人和 LLM 流水线,强调正确性与可测试性。
主要能力:支持用 Pydantic 模型定义结构化输出并自动校验;通过 @agent.tool 注册工具供模型调用;使用 deps_type 与 RunContext 实现依赖注入;支持流式响应、多轮对话、结果校验器与 ModelRetry 重试;可切换 OpenAI、Anthropic、Google Gemini、Groq、Mistral、Ollama 等模型而不改智能体代码。
使用方式:安装 pip install pydantic-ai,按需安装提供商扩展,如 pip install 'pydantic-ai[openai]'、'pydantic-ai[anthropic]'、'pydantic-ai[gemini]'、'pydantic-ai[groq]'、'pydantic-ai[vertexai]'。用 Agent() 创建智能体,run_sync 或 run 执行,result_type 指定输出模型,@agent.tool 注册工具,deps 传入依赖,run_stream 流式输出,message_history 维持多轮上下文。测试时用 TestModel 或 FunctionModel 覆盖模型,避免真实调用。
适用场景:需要类型化、可校验 LLM 输出的 Python 应用;需要单元测试智能体逻辑;需要在不同模型提供商间切换;构建代码审查、客服、多智能体流水线等。
限制与注意:API 密钥应通过环境变量设置,不要硬编码;工具输入需校验;变更数据的工具在生产环境应要求用户确认;建议设置 retries 限制防止循环;不要在异步任务间共享依赖不同的同一 Agent 实例;FastAPI 中应直接 await agent.run(),不要用 asyncio.run()。具体收费与价格暂未提供。