导语：很多 Agent 平台，只是一个”套壳”
写 Agent 教程站这一年，我见过太多人一上来就装某个带界面的”Agent 大平台”，结果发现它绑死在某一家模型、改不了底层逻辑、数据也拿不出来。回过头才发现——真正能长期用的东西，往往是一个给你”自由度”的底座，而不是一个替你做完所有决定的”全家桶”。
Vercel AI SDK 就是这个底座里的代表。它不是又一个挂在后台让你点点点的 Agent 面板，而是一个给 TypeScript 开发者用的开源库，让你亲手把模型、工具调用、多步执行这些 Agent 的基本功，拼进你自己的业务代码里。在 ai.godsun.pro 的横向对比里，它和 Mastra、Semantic Kernel 属于同一类”框架派”，而和 Flowise、Dify 这类”可视化派”走的是两条完全不同的路。
项目介绍：一行代码接模型，剩下的自己搭
Vercel AI SDK 的口号是 “The AI Toolkit for TypeScript”——给 TypeScript 的 AI 工具包，来自 Vercel（Next.js 那家公司）。截至我核实的 2026 年数据，它在 GitHub 上有 26.7K 星，仍处于活跃维护，没有被归档。定位很清晰：不做给你”现成的 Agent”，而是给你搭 Agent 的原材料。
它的核心思路就一句话：把”模型调用”统一成一个标准接口。过去你接 OpenAI 要写一套，接 Gemini 又要换一套，接口天天变；Vercel AI SDK 把这些模型厂商封装成统一的 generateText / streamText 接口，你上层写一套逻辑，底下换模型只改一个配置。这对搞多模型路由、想省钱切便宜模型的人特别友好——我在 AI Agent 模型路由那篇 里反复强调的”便宜模型、稳定模型、强模型不要混着用”，在它这儿就是一个配置项的事。
它也支持 Agent 需要的几样基本能力：工具调用（tool calling）、多步执行、流式输出。也就是说，你不光能让它”回答”，还能让它真的去”干活”——调接口、查数据库、读文件，一步做完再想下一步。最新迭代里对 agent 工作流的支持越来越原生。而且它是协议层设计，不是绑定 Vercel 云服务，本地 Node 环境照跑，这点对自托管党是加分项。
上手：从零到第一个”能动手的 Agent”
环境得有 Node.js（18 以上）。建一个 TypeScript 项目：
mkdir my-agent && cd my-agent
npm init -y
npm install ai @ai-sdk/openai
写一个最简单的”能调用工具”的 Agent，比如让它查完资料再回答：
import { generateText, tool } from "ai";
import { openai } from "@ai-sdk/openai";
import { z } from "zod";
const result = await generateText({
model: openai("gpt-4o-mini"),
tools: {
queryDb: tool({
description: "查数据库里的用户信息",
parameters: z.object({ id: z.number() }),
execute: async ({ id }) => `用户 ${id} 的订单: 3 笔`,
}),
},
prompt: "查一下用户 1024 的最新订单",
});
console.log(result.text);
核心动作就两个：tools 里注册你的函数，execute 里写真实逻辑。模型判断”该查用户了”，就会带上参数调用你的 queryDb，拿到结果再继续回答。这其实就是 Agent 最本质的形态——决策是模型做的，动作是你的代码执行的。 从这儿开始往上堆：加记忆、加多 Agent 协作，底层都是这个循环。
实话：它适合谁，又不适合谁
适合： 你是开发者，项目就是要长期维护、要接多模型、要深度定制；你讨厌被某个平台绑死，希望换模型就像换配置。这样的人用 Vercel AI SDK 是越用越顺手。
不适合： 你完全不会写代码，就想拖拖拽拽出个 Agent 面板——那去用 Dify、Flowise 这类可视化平台，别硬啃框架。我经常被问”该学框架还是可视化平台”，答案是看你自己能不能动手写代码，跟谁”先进”没关系。
坑也得说： 它自由度大，意味着记忆、编排这些都得你自己写，上手门槛比可视化平台高；26.7K 星的体量在框架里不算最大，生态和文档在持续完善中；另外它偏向”接在线 API”，本地模型要自己接 provider。它和 Mastra（28K 星，TypeScript 全家桶）算直接竞品，选哪个看你更想要”轻、自由”还是”开箱即用”。
一句话总结：如果你想让 Agent 真正长在自己项目里、而不是住在别人的 App 里，把 Vercel AI SDK 放进你的工具箱。 先用 10 分钟跑通上面那段代码，你就明白了。
by 数码罗记 · godsun.pro
实测数据来源：GitHub API（2026-09）；内链见 AI Agent 模型路由 与 Agent 平台横向对比
