用途:帮助开发者解答 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/docs/ 与 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 | .[]',并选用版本号最高的模型。
智能体:创建智能体应使用 ToolLoopAgent 模式,文件约定见 type-safe-agents.md;用 useChat 消费智能体时使用 InferAgentUIMessage<typeof agent> 获得类型安全的工具结果。消费智能体前先检查 package.json 判断框架,再查对应框架的快速开始指南。
限制与排错:类型检查失败时,先在 Common Errors 中搜索相关属性或函数名,再搜索源码与文档;若找不到支持答案的文档,应明确说明。修改后运行类型检查,保持最小化配置,只指定与默认值不同的选项。