跳到主要内容

Vercel AI SDK 指南

本文聚焦 Vercel AI SDK 在 TypeScript / Next.js 项目中的适用场景、能力边界和学习入口。

内容主要基于 Vercel 当前官方资料整理。

1. 定位​

按 Vercel 当前官方知识库的定位，AI SDK 是一套帮助你在应用里调用模型、定义工具、组织多步 agent 循环，并把它部署到 Vercel 基础设施上的开发工具。

Vercel AI SDK 更接近面向 Web 应用和 TypeScript 开发者的 agent 编程层。

它主要承载这些能力：

  • LLM 调用
  • tool schema 与执行
  • 多步 agent loop
  • Web 应用里的请求 / 响应集成
  • 部署到 Vercel 的线上运行

2. 它适合什么问题​

2.1 适合 Web 产品里的单 Agent / Tool-Using Agent​

如果项目本身就是：

  • Next.js
  • Node.js / TypeScript
  • API route / server action
  • 前后端一体

那 AI SDK 往往会先用在：

  • 最小 agent demo
  • tool-using assistant
  • research helper
  • 内部工作流助手

2.2 适合想快速把 tool use 接进真实接口​

Vercel 官方 guide 里把 tool()、inputSchema、execute 这套模式讲得很直接。

所以它常见的落点是：

  • 调天气 / 搜索 / 数据接口
  • 跑内部函数
  • 拼 Web 应用里的真实动作

2.3 适合多步 agent loop，但不一定一上来就要大框架​

官方 guide 里直接给了 stopWhen 和 stepCountIs 这种多步控制方式。

因此它比较适合那种：

  • 需要 agent 连续调用多个工具
  • 但暂时还不想引入更重的 graph / workflow 框架

3. 它不太适合什么问题​

3.1 不适合还没想清楚 Agent 边界的场景​

AI SDK 能很快让你把 agent loop 搭起来。

但如果还没分清：

  • 什么地方该用普通函数
  • 什么地方该用 workflow
  • 什么地方才该交给模型自主决策

那很容易做出一个“能跑，但边界模糊”的系统。

3.2 不适合需要很强显式图编排的长流程​

如果要的是：

  • 明确节点
  • 分支控制
  • 长状态链路
  • 更复杂的 orchestration

那通常更适合进一步看：

  • LangGraph
  • Google ADK
  • Azure AI Foundry Agent Service

3.3 不适合只做一次简单模型调用​

如果只是一次普通生成、摘要、抽取，直接模型调用就够了，没必要先上 agent loop。

4. 官方路线中的核心能力​

4.1 generateText​

这是最直接的起点，用于先跑通一次调用。

4.2 tool​

这是 AI SDK 最关键的一层之一：

  • 定义 description
  • 定义输入 schema
  • 执行真实函数

它让 tool use 在 TS 项目里非常自然。

4.3 stopWhen / stepCountIs​

这是 AI SDK 中理解“最小 agent loop”的关键部分。

它和这个专题里的这些内容贴得很近：

  • Minimal Agent
  • Tool-Using Agent

4.4 部署与运行时​

Vercel 官方 guide 明确把部署、maxDuration、Fluid compute、observability 一起带进来了。

因此它不是只停留在本地 demo。

5. 与本专题的关联阅读​

可配合本文一起阅读的内容包括：

在 TypeScript 路线下，Vercel AI SDK 常常用来承接从手写最小 agent 骨架到真实 Web 项目集成层的过渡。

6. 和 OpenAI Agents SDK、LangChain、LangGraph 怎么区分​

6.1 和 OpenAI Agents SDK​

  • OpenAI Agents SDK 更靠近 OpenAI 官方 agent runtime
  • Vercel AI SDK 更偏应用开发层，对 Web 和 TS 项目会更顺手

6.2 和 LangChain​

  • LangChain 更通用、跨运行时
  • Vercel AI SDK 更偏 Web 产品开发体验

6.3 和 LangGraph​

  • LangGraph 更适合显式编排、状态化长流程
  • Vercel AI SDK 更适合先把单 agent / tool loop 跑起来

7. 阅读顺序​

可以按下面顺序阅读：

  1. 先读 OpenAI Agents SDK 指南
  2. 再读本文
  3. 再回到 Tool-Using Agent 代码实现示例
  4. 需要更复杂编排时再读 LangGraph 入门与编排设计

8. 结论​

对于 TypeScript + Web 应用 + 工具型 Agent 场景，Vercel AI SDK 适合优先纳入评估范围。