项目定位vercel/ai 的官方描述很直接The AI Toolkit for TypeScript由 Next.js 创作者打造目标是构建 AI 应用与 agent。README 说明该库由 Vercel 与 Next.js 团队成员创建并接受开源社区贡献话题标签覆盖 anthropic、openai、gemini、llm、language-model、generative-ui、nextjs、react、svelte、vue、typescript 等方向。其自我定位中的关键词是 provider-agnostic上层调用方式保持一致模型来源可以替换。这决定了它和直接调用某一家 SDK 的写法有本质差别。统一 Provider 层给了两条路第一条是默认走 Vercel AI Gateway只需传模型字符串例如model: anthropic/claude-opus-4.6README 同时列出openai/gpt-5.4、google/gemini-3-flash等示例。第二条是直连 provider SDK 包npm install ai-sdk/openai ai-sdk/anthropic ai-sdk/google然后以anthropic(claude-opus-4-6)形式传入。官方明确说 AI SDK 为 OpenAI、Anthropic、Google 等 provider 提供统一 API。对工程化而言两条路的取舍很实际默认 Gateway 让“换模型”退化为改一个字符串直连 SDK 则把 provider 的版本与鉴权留在自己手里。官方并未在同一处对比两者的延迟、配额或计费这部分属于需要自行验证的范围。从文本到结构化输出基础调用是generateText。结构化数据同样走generateText但配合Output.object与 zod schema示例直接生成一份含 name、ingredients、steps 的菜谱对象。也就是说schema 校验被拉进调用参数而不是让模型自由输出后再自行解析。Agent 与工具README 给出的 agent 原语是ToolLoopAgent构造时传model、system、tools。示例工具为openai.tools.localShell其execute回调拿到action.command拆分出 cmd 与 args交给 Vercel Sandbox 的sandbox.runCommand执行再把 stdout 作为 output 返回。能读到的事实是工具定义、执行与结果回传被组织在同一构造结构内沙箱本身由外部提供示例中调用getSandbox()。工具循环在哪一层收敛、超时与错误如何传播README 未展开需要回到源码或文档确认。UI 接入与框架差异AI SDK UI 提供一组 hooks 用于构建聊天机器人与生成式 UI官方强调这些 hooks 是 framework agnostic可用于 Next.js、React、Svelte、Vue。用哪套 UI 就装对应包例如npm install ai-sdk/react。一个 Next.js App Router 的完整链路是agent 文件导出ToolLoopAgent实例与InferAgentUIMessage推导出的消息类型route 的 POST 解析 messages 后调用createAgentUIStreamResponse({ agent, messages })视图组件以UIToolInvocation为 props 类型按invocation.state分支渲染input-available显示生成中output-available渲染返回图像页面用use client加useChat遍历message.parts按part.type分流text与tool-generateImage。几点值得注意顶层介绍把 Angular 与 Node.js 一并列为可用的 UI 框架与运行时而 UI hooks 一段只点名 Next.js、React、Svelte、Vue。Angular 场景下 hooks 的可用性README 在这段没有给出结论。官方单独说明需按框架安装对应包说明抽象落在 hooks 层而非 UI 组件层——生成式 UI 的组件仍由开发者按框架自己写。route 示例函数名为createAgentUIStreamResponse说明 agent 的 UI 输出以流式响应形式从服务端发出具体协议与增量语义需查文档。InferAgentUIMessage与UIToolInvocation让工具调用状态在 TS 中可被穷举这是跨框架项目里的公共类型约定。选型检查清单工程分析非官方结论技术栈是 React / Next.js 时官方示例、模板与文档密度最高接入成本最低。Vue 或 Svelte 场景hooks 可用且存在对应框架包但端到端示例是 Next.js非 React 路径需要更多自行验证。必须使用某家 provider 私有能力时统一 API 是抽象也可能成为不透明的边界官方保留的ai-sdk/*直连路径可以作为兜底。涉及 agent 与代码执行时示例依赖外部沙箱权限、产物与超时策略属于使用方的工程责任而非 SDK 提供。生产前应核对流式响应的中断与重连语义、多 provider 差异被统一 API 抹平的程度、工具循环的错误传播路径、以及 Angular 等未出现在 hooks 段落中的框架支持状态。上手路径README 要求 Node.js 22 与 npm 或其他包管理器npm install ai即可开始。若团队使用 Claude Code、Cursor 一类编码 agent官方建议执行npx skills add vercel/ai把 AI SDK skill 加进仓库官方还提供了覆盖不同用例、provider 与框架的 templates 供起步对照。来源https://github.com/vercel/ai官方页面标题 AI SDK发布时间 2026-09-20