用途：ai-sdk 技能用于回答关于 AI SDK 的问题并帮助开发者构建 AI 功能，例如生成文本、流式输出、工具调用、结构化输出、智能体、嵌入以及框架 UI 集成。AI SDK 由 Vercel 维护（npm 包名为 ai），仓库为 https://github.com/vercel/ai，文档为 https://ai-sdk.dev/docs。
主要能力与用法：SDK 在多种模型提供商之上提供统一 API。使用时应以项目实际安装版本的文档与源码为准，不要凭记忆编写代码，因为 API 会跨版本更名、移除或新增，useChat 等 UI 钩子尤其经常变动。ai 包在 node_modules 内自带与版本匹配的文档与源码，应优先读取 node_modules/ai/docs/ 与 node_modules/ai/src/；提供商包与框架包也各自在 node_modules/@ai-sdk/<name>/docs/ 内置文档。若文档中没有答案，应明确说明而不猜测。可先安装 ai 包（例如 pnpm add ai），在任务需要时再装提供商包（如 @ai-sdk/openai）和框架包（如 @ai-sdk/react）。
Vercel AI Gateway 是快速起步方式，通过单一 API 访问 OpenAI、Anthropic、Google 等模型，无需安装各提供商包或管理多个密钥，可通过 OIDC 或 AI Gateway API 密钥认证，并以 AI_GATEWAY_API_KEY 环境变量提供，模型用 provider/model 字符串引用。模型 ID 不要凭记忆使用，应先用命令获取当前列表：curl -s https://ai-gateway.vercel.sh/v1/models | jq -r '.data[].id'；按提供商过滤可用 startswith("anthropic/") 等写法。存在多个版本时优先最高版本号。
构建与消费智能体时应使用 SDK 内置的智能体抽象（如 ToolLoopAgent），而非手写工具调用循环；消费时可根据智能体定义推断 UI 消息类型以获得端到端类型安全，具体方式因框架而异。DevTools 为独立包，可捕获请求、响应、工具调用、token 用量和多步运行，仅用于本地开发调试。
限制与注意事项：过旧安装是常见错误来源，应对比 node_modules/ai/package.json 中的版本与 npm view ai version，若落后一个大版本以上应提醒升级，迁移指南见 https://ai-sdk.dev/docs/migration-guides。修改后运行项目类型检查，选项尽量保持默认、只设置与默认不同的值，多数类型错误源自已变更的旧 API。资料中未提供具体收费与价格信息。