用途:回答 AI SDK 相关问题,并协助开发者构建 AI 驱动的功能,适用于询问 generateText、streamText 等函数用法,或需要实现流式输出、智能体等场景。
主要能力与规范:
- 前置检查:先确认 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/;本地找不到时再查 ai-sdk.dev 文档。useChat 变化较大,写客户端代码前先看 Common Errors。
- 模型与提供商:除非用户指定,默认使用 Vercel AI Gateway provider。不要凭记忆写模型 ID,先运行 curl -s https://ai-gateway.vercel.sh/v1/models | jq -r '[.data[] | select(.id | startswith("provider/")) | .id] | reverse | .[]'(把 provider 换成 anthropic、openai、google 等)获取最新列表,选版本号最高的模型。
- 代码风格:改动后运行 typecheck;保持最小化,只写与默认值不同的选项,不确定默认值就查文档或源码。找不到支撑答案的文档时明确说明。
查找文档:ai@6.0.34+ 用 grep "query" 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 链接。
类型检查失败:先 grep Common Errors 中对应属性或函数名,许多类型错误源于已废弃 API;未找到再查源码、本地文档与 ai-sdk.dev。
构建与消费智能体:创建智能体始终使用 ToolLoopAgent 模式,文件约定见 type-safe-agents.md;用 useChat 消费时用 InferAgentUIMessage<typeof agent> 获得类型安全的工具结果。实现消费前先看 package.json 判断框架,查该框架快速开始,遵循其流式、API 路由与客户端集成模式。
限制:资料未提供具体版本兼容范围、性能或收费信息;所有 API 细节需以本地文档与源码为准。