AI SDK（Vercel）

AI SDK 是 Vercel 推出的 TypeScript 工具包，用于帮助开发者构建由 AI 驱动的应用和智能体（agent），支持 React、Next.js、Vue、Svelte、Node.js 等运行环境^[1]。它的源码放在 GitHub 的 vercel/ai 仓库中。

解决什么问题

各家模型厂商通常会各自提供客户端库、请求格式，以及把回复流式传回浏览器的约定。一个应用如果想用多家模型，或者以后想换一家，这些差异总得在某处被消化掉。AI SDK 的做法是把模型接入标准化：它支持的提供商包括 OpenAI、Anthropic、Google Generative AI、Azure、Amazon Bedrock、Groq、Mistral、DeepSeek、Together.ai 和 Cohere，另外还有 Vercel 自家的 AI Gateway^[1]。应用代码针对 SDK 的接口来写，各家提供商的具体细节留在接口后面。

由来

vercel/ai 仓库创建于 2023 年 5 月 23 日，目前约有 2.8 万个 star^[2]。GitHub 记录的许可证状态为 NOASSERTION，也就是说没有登记标准的许可证标识^[2]。

三层主要接口

SDK 围绕三个主要层面组织^[1]。

AI SDK Core 是一套统一接口，用于生成文本、生成结构化对象、发起工具调用（tool call）以及构建智能体^[1]。其中的 streamText 函数会自动处理多个工具步骤^[1]：当模型要求调用某个工具时，结果被送回模型，模型继续往下走，这个循环由函数负责，不需要在每个调用处手写一遍。

AI SDK UI 提供用于聊天界面和生成式界面的钩子（hook），并且不绑定单一前端框架^[1]。这些钩子包括 useChat 和 useObject^[1]。useChat 对应对话场景——发送消息、接收流式回复；useObject 对应生成结构化对象，界面可以直接把它渲染出来。

AI SDK Harnesses 提供的是一套统一接口，用来运行现成的智能体框架，例如 Claude Code、Codex 和 Pi，调用方式是通过 HarnessAgent^[1]。如果说 Core 封装的是模型调用，这一层封装的则是已经建好的智能体运行环境，把它们收在同一个调用约定之下。

起步模板

除了库本身，Vercel 还提供了基于该 SDK 的起步模板，包括聊天机器人模板、RAG 知识库和多模态聊天^[1]。这些模板可以直接跑起来，而不只是文档里的示例代码：开发者可以从一个能用的聊天应用或检索应用出发，再作修改。

在发展中的位置

AI SDK 所处的位置，是网页应用与模型提供商相接的那一层。它有三个特点。第一，它面向 TypeScript 和 JavaScript 生态，而不是某一个框架，列出的目标环境包括 React、Next.js、Vue、Svelte 和 Node.js^[1]。第二，它通过把一长串提供商和自家网关的接入方式标准化，让「选哪家模型」变成一个配置问题^[1]。第三，它覆盖的范围从单次文本生成，一直延伸到结构化输出、工具调用、智能体和现成的智能体框架^[1]。对开发者来说，实际效果是：一个 AI 应用里最容易变动的几件事——背后是哪家模型、由哪个框架渲染、由哪个智能体运行环境执行——都交给同一套工具包来处理。