SuperAPI AI 工具集

ai-sdk-7

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:面向 ai@7 的实现与迁移。未知版本先用 ai-sdk 解析,v6 维护用 ai-sdk-6;需匹配 provider 与 UI 包版本。AI SDK 7 要求 Node.js 22+,且 AI SDK 包仅支持 ESM。

主要能力与入口:内存型智能体循环用 ai 的 ToolLoopAgent;持久化智能体用 @ai-sdk/workflow 的 WorkflowAgent 加 workflow 5;Claude Code/Codex/Pi 运行时用 @ai-sdk/harness/agent 的 HarnessAgent 加适配器与沙箱包;OpenTelemetry 用 registerTelemetry(new OpenTelemetry()) 与 @ai-sdk/otel;卡住调用用 timeout: ms 或 { totalMs, stepMs, firstChunkMs, chunkMs, toolMs }。

使用方式:先读解析后的 ai/docs/、provider 文档与已安装源码/类型;技能中每个 ai-sdk.dev/docs/... 链接在 ai/docs/ 下有离线副本。Harness、WorkflowAgent 与迁移指南分别位于 ai/docs/03-ai-sdk-harnesses/、03-agents/07-workflow-agent.mdx、08-migration-guides/23-migration-guide-7-0.mdx;配套包只提供类型。本地文档不可用时用官方文档或对应仓库 tag。实验性包 API 在加长期封装前需重新确认。

边界:文本函数与 ToolLoopAgent 用 instructions,循环限制用 isStepCount;核心、agent 与服务端 UI 流助手用 onEnd/onStepEnd(onFinish 为弃用别名),客户端 useChat/Chat 保留 onFinish。prepareStep 的 instruction/message 覆盖会向后传递;usage、tool 数组等结果聚合所有步骤,finalStep 保留末步访问,流需 await。服务端循环状态用 runtimeContext,按工具状态用经 schema 校验的 toolsContext,二者仅作为 context 不会对模型可见。审批、持久化与生命周期在 ToolLoopAgent、WorkflowAgent、HarnessAgent 及 provider 执行工具间不同,应按实际持久化/权限需求选择运行时。模型 ID 与能力从已配置 provider 解析,避免推理设置重叠。

限制:编译通过不代表审批策略或持久化行为正确,需对改动的多轮、工具、流或恢复路径做类型检查与实测。其余细节暂未提供。