从 Vercel 的 Agent 教程开始：普通开发者怎么做一个能落地的 AI Agent

Vercel 在 2026 年 6 月发了一篇教程：Build AI agents with AI Gateway and AI SDK。它把 Next.js、AI SDK、AI Gateway、Sandbox、Connect 和 Workflow SDK 放在同一条开发路线上。第一次做 Agent 时，很容易看懂每段代码，却不清楚为什么需要这么多部件，离开 Vercel 又该怎样搭。

这个系列沿着一个客服售后任务展开：先让模型查询订单、生成回复草稿，再看工具权限、失败恢复和长任务为什么需要由程序接管。实践部分用本地 Node.js 服务和 AI SDK，不要求先部署到 Vercel；平台产品和 API 说明以写作时的文档为准，接入时仍应核对所安装版本。

阅读顺序

篇目	要回答的问题
1．模型、工具与受控执行循环	模型如何根据工具结果继续推进，哪些任务仍适合确定性程序。
2．用 AI SDK 跑通一个本地客服助手	模型调用、结构化输出与工具循环怎样接进本地 HTTP 服务。
3．从本地 demo 到可恢复的生产任务	中途失败、授权、长任务、隔离执行和预算怎样进入实际控制。

阅读范围

第 2 篇提供可浏览的本地工程与运行步骤，使用模拟订单和本机模型服务。第 3 篇讨论生产中的状态、权限与失败处理；托管产品与自建方案按职责比较，接入时需核对实际版本。

章节定位

按章节名可以直接进入对应正文或补充材料。

1．模型、工具与受控执行循环：Agent 是什么 · 为什么需要 Agent · 为什么 Agent 开发会这么火 · Agent 能干什么 · 常见 Agent 都有哪些 · 一个客服售后 Agent 的例子 · 一个完整 Agent 通常有哪些角色 · Agent 的自主程度怎么控制 · 怎么给 Agent 提供工具。

2．用 AI SDK 跑通一个本地客服助手：文本、流式和结构化输出 · Vercel AI SDK 的三类包 · 从模型调用到结构化结果 · 工具让 Agent 开始做事 · Agent 循环需要退出条件 · 结构化输出是 Agent 的中间状态 · 把最小项目跑起来。

3．从本地 demo 到可恢复的生产任务：fallback 和模型路由是生产能力 · 执行模型生成的代码要隔离 · 第三方 API 要用短期授权 · 长任务要能恢复 · Vercel 在这条链路里的位置 · 从 demo 到生产要补哪些东西 · 日志和追踪 · 工具权限 · 测试和评估 · 成本控制 · 人工介入 · 新手最容易低估的几个边界 · 总结 · 不用 Vercel 时怎么搭 · 平台怎么选。