从一个函数到完整研究代理：Vercel AI SDK的实战方法论

这场由 Vercel AI SDK 团队成员 Nico 主讲的 Masterclass，不只是一次 API 教程，而是完整展示了如何用统一接口、工具调用和结构化输出，逐步搭建一个“深度研究型 AI Agent”。从最基础的 generateText，到递归式研究代理，视频给出了清晰、可复用的工程路径。

为什么从“生成一句话”开始，是构建 Agent 的正确姿势

在这场分享一开始，Nico 就刻意把门槛放得很低。他没有直接谈复杂的 Agent 架构，而是从 AI SDK 里最基础的原语（primitive）讲起：generateText。原因很现实——如果你不理解最基本的一次模型调用，后面所有“智能”都是空中楼阁。

他在现场只用一个 index.ts 文件，演示了一个最简单的异步 main 函数：调用 generateText，指定模型为 OpenAI 的 GPT‑4o mini，传入 prompt“hello world”，然后把结果打印出来。运行命令只是 pmpp run dev（他笑着说自己用 alias，敲的是 pd），终端里立刻返回了模型的问候语。

这个看似平凡的例子，背后强调的是一个重要观点：AI SDK 的所有高级能力，都是从这些统一的基础调用演化出来的。正如 Nico 所说：“We're going to start with the building blocks that you need to understand about using the AI SDK before we jump into building agents.” Agent 不是魔法，而是组合。

统一接口的真正价值：一行代码切换模型

在生成文本跑通之后，Nico 很快引出了 AI SDK 最核心的设计理念之一：统一接口（unified interface）。这意味着，无论你使用的是哪一家大模型，只要遵循 SDK 的抽象层，切换模型往往只需要改一行代码。

他明确点出了现实动机：成本、更快的响应速度，或者某个模型在特定问题上的表现更好。为了说明差异，他现场抛给模型一个“可能会翻车”的问题，比如询问某个具体时间点的行业会议。这并不是为了难为模型，而是让开发者意识到：模型能力不同，选择本身就是工程决策的一部分。

这也是视频里一个很有价值的洞见——AI SDK 并不试图帮你“选最聪明的模型”，而是帮你保留选择权。Nico 用一句很朴素的话总结这一段：“We're able to switch between language models by just changing one single line of code.” 对工程团队来说，这意味着未来的灵活性。

让模型“动起来”：工具调用与 maxSteps 的关键细节

真正进入 Agent 领域，是从工具调用（tool calling）开始的。Nico 强调，工具听起来复杂，但核心思想非常简单：让语言模型不仅能“说”，还能“做”。比如调用搜索、计算或数据库查询，然后把结果再整合进最终回答。

一个关键细节是，模型如何在多次思考和行动之间来回切换。这里他引入了 maxSteps 这个属性，用来限制模型在一次请求中最多执行多少步推理和工具调用。这看似是个小参数，却直接决定了 Agent 的行为边界。

他特别指出，我们真正想要的是：模型执行完动作后，能“synthesize this action whatever it's performed and communicate that back to the user”。也就是说，不只是调用工具，而是理解工具结果，并用自然语言解释给人听。这一段让很多观众意识到，Agent 的难点不在 API，而在控制流程。

从原语到系统：一步步搭建 Deep Research Agent

在讲完所有基础原语后，视频进入了最实战、也最精彩的部分：用 Node.js 构建一个“深度研究”代理。Nico 没有一次性给出完整代码，而是拆成清晰的阶段。

第一步，是根据用户问题生成多条搜索查询；第二步，真正去搜索网络，并严格控制返回内容的相关性；第三步，对搜索结果做分析，总结出关键发现；接着，再从这些发现中提炼新的学习点和后续问题。到这里，系统已经开始表现出“研究行为”。

真正的转折点在于递归。Nico 引入递归机制，让 Agent 可以围绕新问题反复执行搜索和分析流程。现场跑起来时，他停下来感叹了一句：“So we can see that it is indeed working.” 最后，当所有研究素材累积完成，再把它们交给一个更大的模型，生成最终的综合报告。

这一整段展示的，不只是代码，而是一种可复制的 Agent 架构思路。

总结

这场 Masterclass 的价值，不在于某个 API 调用，而在于 Nico 展示的完整心智模型：从最小原语出发，用统一接口保持灵活性，用工具调用扩展能力，用结构化输出和递归构建复杂行为。对开发者来说，这是一条从“会用模型”走向“设计 Agent 系统”的清晰路径，也提醒我们，真正的智能，往往来自工程上的克制与组合。

关键词： Vercel AI SDK， AI Agent， 工具调用， 结构化输出， 大语言模型

事实核查备注： 演讲者：Nico（Vercel AI SDK 团队）；视频标题：Vercel AI SDK Masterclass： From Fundamentals to Deep Research；模型示例：OpenAI GPT‑4o mini；核心 API：generateText、tool calling、generateObject；参数：maxSteps；项目语言：Node.js（index.ts）