SuperAPI AI 工具集

ai-sdk

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:该技能用于回答 AI SDK 相关问题,并协助开发者构建 AI 驱动的功能,例如涉及 generateText、streamText 等函数,以及 useChat 客户端集成和 Agent 构建。

主要能力与原则:强调不要信任内部知识,认为训练数据中的 AI SDK API 已过时或错误,要求始终对照源码或文档验证。使用前先检查 node_modules/ai/docs/ 是否存在,若不存在则仅安装 ai 包(如 pnpm add ai),暂不安装 provider 包(如 @ai-sdk/openai)或客户端包(如 @ai-sdk/react),待需要时再装。

查找文档:ai@6.0.34+ 可在 node_modules/ai/ 中搜索捆绑文档与源码,例如 grep "query" node_modules/ai/docs/ 与 grep "query" node_modules/ai/src/;provider 包文档位于 node_modules/@ai-sdk/<provider>/docs/。更早版本可搜索 https://ai-sdk.dev/api/search-docs?q=your_query 并获取结果中的 .md 链接。

模型与网关:选择模型和 provider 时,除非用户另有指定,默认使用 Vercel AI Gateway。不要凭记忆使用模型 ID,需先运行 curl -s https://ai-gateway.vercel.sh/v1/models | jq -r '[.data[] | select(.id | startswith("provider/")) | .id] | reverse | .[]'(将 provider 替换为 anthropic、openai、google 等)获取最新模型列表,并选用版本号最高的模型。

Agent 与类型安全:创建 Agent 时使用 ToolLoopAgent 模式,文件约定见 type-safe-agents.md;用 useChat 消费 Agent 时使用 InferAgentUIMessage<typeof agent> 获得类型安全的工具结果。实现前先检查 package.json 判断框架,再按框架快速上手文档处理流式、API 路由与客户端集成。

排错与限制:类型检查失败时先在 Common Errors 中搜索相关属性或函数名,再查源码与文档。若找不到支持答案的文档,应明确说明。保持最小化,只指定与默认值不同的选项。资料未提供具体收费、价格与平台支持范围。