SuperAPI AI 工具集

ai-sdk

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:回答关于 AI SDK 的问题,并协助构建 AI 驱动的功能。适用于开发者询问 Vercel AI SDK、generateText、streamText、ToolLoopAgent 等场景。

版本与文档路由:先在工作区的 manifest、lockfile 或已安装包中确认 ai 及 provider/React 包版本,除非要求升级,否则保留已安装主版本。AI SDK 7 的实现或迁移使用 ai-sdk-7;AI SDK 6 维护使用 ai-sdk-6;版本未知、混合或更旧时,先解析版本再套用任一 API 集。新应用从当前主版本开始(写作时为 7,可用 npm view ai dist-tags 确认)。ai@7 搭配 @ai-sdk/react@4,ai@6 搭配 @ai-sdk/react@3。各 provider 主版本不同(v7 中 Amazon Bedrock 与 xAI 为 5.x,OpenAI 兼容为 3.x),v7 装各 provider 最新版,v6 装其 ai-v6 dist-tag(npm view <pkg> dist-tags)。

查找匹配应用的 API:优先搜索已解析包的 docs/、types 与 src/(若随包发布),无需联网。ai 从 6.0.32 起及 7.x 内置文档;6.0.0-6.0.31 无文档,6.0.32 仍无 src/。文档树镜像网站:ai-sdk.dev/docs/<section>/<page> 对应 ai/docs/<nn>-<section>/<nn>-<page>.mdx。provider 包提供 docs/<nn>-<provider>.mdx;@ai-sdk/react、@ai-sdk/workflow、@ai-sdk/harness、@ai-sdk/otel、@ai-sdk/mcp 不提供文档,其指南在 ai/docs,API 在 dist/*.d.ts。Monorepo 提升与 Yarn PnP 可能改变路径;不要仅为获取文档而安装或升级依赖。

本地文档不可用时,使用匹配的仓库标签(vercel/ai,tag ai@<version>,content/docs/)或文档版本。文档搜索与 Markdown 页面变体有助于定位功能。仓库 main 与默认网站可能指向比应用更新的主版本。既无本地文档也无网络时,说明哪些 API 事实未经验证。截至 2026-10-11,可追加 &tag=v6(v5、v6 或 v7)将搜索结果限定到某主版本。

模型 ID 从应用的 provider 配置或当前 provider 目录中选择。Gateway 目录可辅助发现,但其 ID 与能力可用性不代表其他 provider 接受。按任务选择能力、延迟与成本。

定向参考:常见错误(过时名称与协议不匹配)、类型化智能体(UI 推断与服务端/客户端边界)、DevTools(本地调试)、示例(provider 专属官方代码)。

限制:默认值适用时使用默认值;对改动的集成做类型检查并验证其流式/工具路径;受支持的符号仍可能因回调作用域、结果语义或 provider 使用错误。