SuperAPI AI 工具集

ai-sdk-agents

智能体与模型

查看项目

更新于 10-15 17:26

技能介绍

用途:帮助开发者用 AI SDK v6+ 的 ToolLoopAgent 构建可自主决定调用工具的智能体。资料将其定位为编排可复用模型、工具与循环控制的方案,适用于模型决定调用哪些工具的动态多步任务;确定性的固定流程则建议改用 generateText/streamText。

主要能力:定义模型与工具(示例使用 anthropic 的 claude-sonnet-4-20250514 与 Zod v4.3.5 做输入 schema);通过 Output.object 获得结构化输出;支持 stream 流式读取 textStream;提供 createAgentUIStreamResponse 用于 API 路由,以及 InferAgentUIMessage 做类型安全客户端集成。循环控制包括 stopWhen(默认 stepCountIs(20))、hasToolCall('finalAnswer')、prepareStep(换模型、压缩消息、限制每步工具)。运行时配置包括 callOptionsSchema 定义类型安全选项、prepareCall 每次调用选择模型/工具或注入 RAG 上下文。

使用方式:新建 ToolLoopAgent 实例,传入 model 与 tools,调用 generate 或 stream;API 路由侧用 createAgentUIStreamResponse 返回流式响应。审计或迁移前可运行本地扫描器:python3 skills/ai-sdk-agents/scripts/ai_stack_scan.py --root <repo> --pretty,输出 ai_stack_scan.v1,默认不联网、跳过符号链接,可标记缺失显式 stopWhen 等循环风险。

限制:扫描器结果需对照当前 AI SDK 文档/源码核验后再改行为;完整扫描 JSON 应保留本地,仅外部分享脱敏后的具体信号。参考文件涵盖 fundamentals、loop-control、configuration、workflow-patterns、real-world、production、migration。其余功能细节暂未提供。