用途:为使用 Vercel AI SDK 构建 AI 功能提供专家指导,涵盖聊天界面、文本生成、结构化输出、工具调用、智能体与 MCP 等场景。
主要能力与用法:
- 前置准备:先检查 node_modules/ai/docs/ 是否存在,若不存在则仅用项目包管理器安装 ai 包(如 pnpm add ai),此阶段不要安装其他包;提供商包(如 @ai-sdk/openai)和客户端包(如 @ai-sdk/react)按需求后续再装。
- 不信任内部知识:资料声明关于 AI SDK 的记忆可能过时或有误,必须查阅 node_modules/ai/docs/ 与 node_modules/ai/src/ 中的当前 API;本地找不到时搜索 ai-sdk.dev 文档。useChat 已显著变化,写客户端代码前先查 Common Errors。
- 模型与提供商:除非用户指定,默认使用 Vercel AI Gateway 提供商。模型 ID 必须实时获取,不可凭记忆,资料给出命令:curl -s https://ai-gateway.vercel.sh/v1/models | jq -r '[.data[] | select(.id | startswith("provider/")) | .id] | reverse | .[]',并选用版本号最高的模型。
- 构建智能体:始终使用 ToolLoopAgent 模式,配合 useChat 时用 InferAgentUIMessage<typeof agent> 获得类型安全;先检查 package.json 判断框架,再查对应框架的快速开始指南。
- 其他:变更后运行类型检查;保持最小化配置,只指定与默认值不同的选项;找不到文档支持须明确说明。
文档查找:ai@6.0.34+ 用 grep "query" node_modules/ai/docs/ 或 node_modules/ai/src/;较早版本用 https://ai-sdk.dev/api/search-docs?q=your_query 并抓取结果中的 .md 链接。
限制:以上为资料中明确给出的规则与参考,未提供的功能、收费或平台细节暂未提供。