AI SDK

这个 Agent 能做什么，适合哪些场景？

AI SDK 是一个厂商无关的 TypeScript 工具包，用于构建 AI 驱动的应用与智能体，可运行在 Next.js、React、Svelte、Vue、Angular 等前端框架以及 Node.js 等运行时中。它通过统一 API 接入 OpenAI、Anthropic、Google 等模型提供商，默认走 Vercel AI Gateway，也可以直连各家 SDK 包。核心能力包括 generateText 文本生成、基于 zod schema 的结构化数据输出、ToolLoopAgent 工具循环智能体，以及提供 useChat 等钩子的 AI SDK UI 模块。该库以 npm 包形式发布，需要 Node.js 22+，主要作为库被引入到你自己的代码或应用中。

调用 generateText 等函数，把模型字符串（如 'anthropic/claude-opus-5.5'）或提供商标识（如 anthropic('claude-opus-5-5')）解析为具体模型并发起推理，返回 { text } 文本结果。借助 Output.object 与 zod schema，可以把模型输出约束为结构化对象，例如菜谱的字段与步骤数组。ToolLoopAgent 类接受 model、system 和 tools，驱动模型在工具循环中反复调用工具，示例中用 openai.tools.localShell 在沙箱中执行 shell 命令并回传 stdout。在前端，AI SDK UI 提供 useChat 等框架无关钩子管理消息与状态；服务端通过 createAgentUIStreamResponse 把智能体的 UI 流返回给前端；InferAgentUIMessage 与 UIToolInvocation 用于类型化消息与工具调用组件。

1. 已经使用 Next.js 或 React 的团队，需要在自己的应用里加入多轮对话式聊天界面。
2. 后端工程师需要从大模型拿到严格符合 zod schema 的 JSON，例如菜谱、表单或分类结果，而不是自由文本。
3. 需要让模型调用外部工具（如执行 shell 命令、生成图片）并处理中间状态的开发者。
4. 希望在同一套代码里切换 OpenAI、Anthropic、Google 等提供商的团队，避免被单一模型厂商锁定。
5. 使用 Svelte 或 Vue 构建生成式 UI，需要一个框架无关的聊天状态钩子库的前端开发者。

如何安装或部署这个 Agent？

需要本地安装 Node.js 22+ 以及 npm 或其他包管理器。

安装核心包：

npm install ai

如需直连某家提供商而非使用 Vercel AI Gateway，安装对应 SDK 包：

npm install @ai-sdk/openai @ai-sdk/anthropic @ai-sdk/google

如需前端 UI 钩子，按所用框架安装：

npm install @ai-sdk/react

若使用 Claude Code、Cursor 等编码智能体，可添加 AI SDK skill：

npx skills add vercel/ai

如何使用这个 Agent？

最小可用调用，走默认的 Vercel AI Gateway：

import { generateText } from 'ai';

const { text } = await generateText({
  model: 'openai/gpt-6-astra', // use Vercel AI Gateway
  prompt: 'What is an agent?',
});

或者直连提供商 SDK：

import { anthropic } from '@ai-sdk/anthropic';

const result = await generateText({
  model: anthropic('claude-opus-5-5'), // or openai('gpt-6-astra'), google('gemini-3.8-flash'), etc.
  prompt: 'Hello!',
});

定义带工具的智能体并通过 Next.js App Router 以流式响应暴露：

import { imageGenerationAgent } from '@/agent/image-generation-agent';
import { createAgentUIStreamResponse } from 'ai';

export async function POST(req: Request) {
  const { messages } = await req.json();

  return createAgentUIStreamResponse({
    agent: imageGenerationAgent,
    messages,
  });
}

前端使用 useChat 消费消息与工具调用状态：

'use client';

import { useChat } from '@ai-sdk/react';

export default function Page() {
  const { messages, status, sendMessage } =
    useChat<ImageGenerationAgentMessage>();
  // render messages and tool parts
}

注意：源文档未说明各提供商的 API Key 具体配置方式与计费细节，实际接入前需查阅对应提供商文档。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题