pydantic-ai 开源 GenAI 代理框架,star 16.9k

15 阅读2分钟

pydantic-ai 开源 GenAI 代理框架,star 16.9k

Pydantic团队开源的GenAI代理框架pydantic-ai,获得16,940个Star:

正文顶部截图

pydantic-ai是Python语言编写的生成式AI代理框架,目标是为GenAI应用开发提供类似FastAPI的开发体验。

README区域截图

pydantic-ai由Pydantic官方团队开发,Pydantic验证库已被OpenAI SDK、Anthropic SDK、LangChain等主流AI库采用。

pydantic-ai支持几乎所有主流模型与服务商,包括OpenAI、Anthropic、Gemini、DeepSeek、Groq等,也支持用户自定义模型接入。

框架与Pydantic Logfire可观测平台深度集成,支持实时调试、性能监控、行为追踪与成本统计,也兼容其他支持OpenTelemetry的可观测平台。

pydantic-ai全链路支持类型安全,IDE可获得完整自动补全与类型检查能力,大量错误可在编码阶段被发现。

框架内置评估能力,可系统性测试代理系统的性能与准确率,支持在生产环境中持续监控运行表现。

pydantic-ai采用可扩展设计,用户可通过能力模块组合构建代理,内置支持网络搜索、思维链、MCP等能力,也支持自定义能力模块或安装第三方扩展。

框架集成Model Context Protocol、Agent2Agent与多种UI事件流标准,支持代理调用外部工具、与其他代理交互、构建交互式应用。

pydantic-ai支持工具调用人工审批功能,可根据工具参数、对话历史或用户偏好,决定是否需要人工确认后再执行工具调用。

框架支持持久化执行,代理状态可在API故障、应用重启后恢复,适合处理长周期异步任务与人机交互工作流。

pydantic-ai提供流式输出能力,结构化输出结果可连续返回并实时验证,用户可即时获得生成数据。

框架支持基于类型提示定义执行图,适合复杂应用场景,避免控制流代码混乱。

使用pydantic-ai开发极简代理仅需少量代码:

from pydantic_ai import Agent

agent = Agent(
    'anthropic:claude-sonnet-4-6',
    instructions='Be concise, reply with one sentence.',
)

result = agent.run_sync('Where does "hello world" come from?')
print(result.output)

添加能力模块后可实现更复杂功能,比如增加思维链与网络搜索能力:

from pydantic_ai import Agent
from pydantic_ai.capabilities import Thinking, WebSearch

agent = Agent(
    'anthropic:claude-sonnet-4-6',
    instructions='Be concise, reply with one sentence.',
    capabilities=[Thinking(), WebSearch()],
)

result = agent.run_sync('What was the mass of the largest meteorite found this year?')
print(result.output)

开源地址:github.com/pydantic/py…