SuperAPI AI 工具集

ai sdk v6 core

编程与开发

查看项目

更新于 10-15 17:27

技能介绍

用途:面向使用 Vercel AI SDK v5/v6 构建后端 AI 功能的开发场景,包括服务端文本生成、结构化输出、带工具的 AI 智能体和多供应商集成。不覆盖 React 聊天界面、前端 hooks、嵌入与图像生成(见 ai-sdk-ui)。

主要能力与原则:简单文本生成用 generateText;结构化输出用 generateObject 配合 Zod schema;流式响应用 streamText;v6 智能体工作流用 ToolLoopAgent 做工具调用;支持工具执行审批以实现 human-in-the-loop;用 callOptions 做运行时动态配置;按具体错误类型处理(如 AI_APICallError、AI_NoObjectGeneratedError);通过 provider 抽象(openai、anthropic、google)支持多供应商。

必要用法与约束:需处理 response.error 的带类型错误响应;结构化输出必须用 Zod schema 校验;streamText 中通过 onError 回调处理错误;启动时校验 API key;限流建议实现带指数退避的重试;有 mode: 'json' 时用于结构化输出;复杂结构化输出建议优先 GPT-4+。避免在 Cloudflare Workers 中使用顶层 import(造成启动开销)、跳过 API 调用错误处理、使用 any 类型、在未迁移情况下混用 v5 与 v6 API。

适用前提:AI SDK v5.0.98+(稳定)或 v6.0.0-beta.107+(测试版);Node.js 18+ 或 Cloudflare Workers;Zod v3.23.8+ 或 v4.x;TypeScript v5+ 且开启 strict 模式。可与 ai-sdk-ui 配合用于 React 聊天界面,并与 Next.js Server Components 和 API 路由协作。

限制:资料未提供收费、价格与具体部署步骤等信息。