SuperAPI AI 工具集

ai-sdk

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

用途:该技能用于回答 AI SDK 相关问题,并帮助开发者构建 AI 驱动的功能,适用于开发者询问 generateText、streamText 等 AI SDK 函数的场景。

主要能力与要求: 一、前置准备。检索文档前先检查 node_modules/ai/docs/ 是否存在;若不存在,仅用项目包管理器安装 ai 包(例如 pnpm add ai),此阶段不要安装其他包。Provider 包(如 @ai-sdk/openai)和客户端包(如 @ai-sdk/react)应在后续按需求再装。 二、不信任内部知识。资料强调关于 AI SDK 的既有知识可能过时或错误,须先确认 ai 包已安装,再在 node_modules/ai/docs/ 与 node_modules/ai/src/ 中检索当前 API;本地找不到时再查 ai-sdk.dev 文档。禁止依赖记忆,须对照源码或文档核实。useChat 变化较大,编写客户端代码前先查 Common Errors。 三、选择模型与供应商。除非用户另行指定,默认使用 Vercel AI Gateway 供应商。模型 ID 必须实时获取,不得使用记忆中的 ID,可运行 curl -s https://ai-gateway.vercel.sh/v1/models | jq -r '[.data[] | select(.id | startswith("provider/")) | .id] | reverse | .[]'(将 provider 替换为 anthropic、openai、google 等),取版本号最高的模型。 四、文档查找方式。ai@6.0.34+ 可用 grep "query" node_modules/ai/docs/ 与 grep "query" node_modules/ai/src/,供应商包文档见 node_modules/@ai-sdk/<provider>/docs/。更早版本使用 https://ai-sdk.dev/api/search-docs?q=your_query 并取结果中的 .md 链接。类型检查失败时,先查 Common Errors 中对应属性或函数名,再查本地源码与文档,最后查 ai-sdk.dev。 五、智能体与消费。创建智能体始终使用 ToolLoopAgent 模式,文件约定见 type-safe-agents.md;用 useChat 消费智能体时使用 InferAgentUIMessage<typeof agent> 获得类型安全的工具结果。实现前先查看 package.json 判断框架与栈,再检索该框架的快速开始并遵循其流式、API 路由与客户端集成模式。

限制:资料要求改动后运行类型检查,保持最小化配置,仅指定与默认值不同的选项;不确定默认值时查文档或源码,不要猜测或过度指定。找不到支持答案的文档时应明确说明。