SuperAPI AI 工具集

agent-builder-pydantic-ai

智能体与模型

查看项目

更新于 10-16 05:46

技能介绍

用途:使用 Pydantic AI 框架配合 OpenRouter 构建生产可用的对话式 AI 智能体,强调类型安全、自动校验与较少样板代码。适用于为 FastAPI 后端添加 AI 能力、需要严格类型检查与校验、希望 LLM 返回格式错误时自动重试,以及创建带自定义工具的智能体。

主要能力:定义 Pydantic 输出模型约束返回结构;通过 Tool 注册自定义工具并声明参数模型;支持流式输出;可配置 RetryConfig 在 ValidationError、TimeoutError 时自动重试;可与 FastAPI 集成提供 /chat 接口;支持用 pytest 编写异步测试。

使用方式:安装命令为 pip install pydantic-ai httpx pydantic python-dotenv。通过 Agent(model='openrouter:openai/gpt-4o', output_type=..., tools=[...], system_prompt=...) 创建智能体,用 await agent.run(...) 调用。OpenRouter 需设置环境变量 OPENROUTER_API_KEY 与 FRONTEND_URL,并使用 OpenRouterModel 指定模型名与 api_key。工具通过 agent.add_tool(Tool(name=..., description=..., parameters=..., execute=...)) 注册。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;示例中的模型名、工具实现与接口路径需按实际环境调整。