TanStack AI

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

TanStack AI 是一个由可组合活动和提供商适配器构成的 TypeScript SDK，用于开发流式聊天、工具调用智能体、结构化输出、实时语音和媒体生成应用。核心包 @tanstack/ai 提供 chat()、toolDefinition() 和流式响应工具，OpenAI、Anthropic、Gemini、Ollama、Grok、Groq、ElevenLabs、BytePlus、fal.ai 与 OpenRouter 等能力通过独立适配器接入。客户端层包括无框架绑定的 @tanstack/ai-client，以及面向 React、Solid、Vue、Svelte 和 Preact 的原生包。它可以处理文本、图片、音频、视频和文档，并支持 JSON Schema、Zod、ArkType 与 Valibot 驱动的结构化结果。代码作为应用依赖运行在开发者自己的前端或服务器边界内；具体模型服务、凭据、托管方式和费用由所选适配器决定。它适合希望保留提供商切换能力、同时接受自行集成和部署 TypeScript 应用的团队。

应用把消息传给 chat()，并通过 openaiText() 等活动适配器选择模型；返回流可由 toServerSentEventsResponse() 转成服务器发送事件响应。toolDefinition() 使用输入和输出 schema 定义共享契约，再通过 .server() 或客户端实现执行工具。设置 outputSchema 后，聊天调用生成经过 JSON Schema、Zod、ArkType、Valibot 或普通 JSON Schema 约束的对象。生成客户端以统一模式调用图片、音频、视频、语音、转录和摘要能力；实时适配器负责语音会话与令牌签发。Code Mode 允许模型在隔离沙箱中编写并执行 TypeScript，以循环、分支或并行调用组织工具。开发工具、类型化事件、使用量和错误观测以及 OpenTelemetry 链路可用于检查消息、工具调用和流数据。

1. React、Vue、Svelte、Solid 或 Preact 团队需要在现有应用中加入带类型化消息和工具调用的流式聊天。
2. 后端 TypeScript 团队希望用同一套 toolDefinition() 契约实现服务端或客户端工具。
3. 需要在 OpenAI、Anthropic、Gemini、Ollama 或其他已列适配器之间切换模型提供商的产品团队。
4. 需要让模型返回符合 Zod、ArkType、Valibot 或 JSON Schema 的业务对象，而非自由文本的开发者。
5. 构建图片、视频、语音、转录、音频或摘要工作流，并希望采用统一生成客户端模式的多媒体应用。
6. 需要实时语音会话、Code Mode 工具编排或 OpenTelemetry 可观测性的高级 AI 应用团队。

如何安装或部署这个 Agent？

安装核心包和 OpenAI 适配器：

pnpm add @tanstack/ai @tanstack/ai-openai

React 流式聊天还需要客户端与 React 包：

pnpm add @tanstack/ai @tanstack/ai-client @tanstack/ai-react @tanstack/ai-openai

若希望通过一个 API 入口访问多个模型，可安装 OpenRouter 适配器：

pnpm add @tanstack/ai @tanstack/ai-openrouter

来源未规定 Node.js 版本，也未给出提供商凭据的环境变量名称或配置步骤；运行前需按所选适配器补齐相应服务访问配置。

如何使用这个 Agent？

在支持标准 Request、Response 和服务器发送事件的 TypeScript 服务端路由中创建聊天流：

import { chat, toServerSentEventsResponse } from '@tanstack/ai'
import { openaiText } from '@tanstack/ai-openai'

export async function POST(request: Request) {
  const body = await request.json()

  const stream = chat({
    adapter: openaiText('gpt-5.2'),
    messages: body.messages,
  })

  return toServerSentEventsResponse(stream)
}

调用方应向该 POST 端点发送包含 messages 的 JSON 请求。示例使用 OpenAI 适配器和 gpt-5.2；来源没有展示凭据配置、错误处理或部署命令。

如需结构化对象，可设置 outputSchema：

import { chat } from '@tanstack/ai'
import { openaiText } from '@tanstack/ai-openai'
import { z } from 'zod'

const Person = z.object({
  name: z.string(),
  age: z.number(),
})

const person = await chat({
  adapter: openaiText('gpt-5.2'),
  messages: [{ role: 'user', content: 'Ada Lovelace, 36' }],
  outputSchema: Person,
})

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

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

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

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. @tanstack/[email protected] 2026-10-13
   发布说明摘录

   Minor Changes - [#1715](https://github.com/TanStack/ai/pull/1715) [fac0555](https://github.com/TanStack/ai/commit/fac055559de98eb0fa23a0bc725808033ba3c2fc) - New hooks for hosts that run chat() for a long session. - @tanstack/ai exports runAgentStream (runs a defineAgent agent outside a parent chat turn), createSubagentId, createSubagentSink, CapabilityRegistry, and the SubagentsBag and SubagentSink types. Pass the sink to keep interrupt objects and token usage. The finished event has interruptIds only. …

   在 GitHub 查看 ↗
2. @tanstack/[email protected] 2026-10-13
   发布说明摘录

   Patch Changes - Updated dependencies \[[1bfcee3](https://github.com/TanStack/ai/commit/1bfcee35bb3cf0ff3aac005440c842e66c3d687d), [412b0fe](https://github.com/TanStack/ai/commit/412b0fea4f4bb569998c3d253d174efd7b501e3c), [a0150c2](https://github.com/TanStack/ai/commit/a0150c26b9e2b6050663450171e36a9dfa80915b), [b881627](https://github.com/TanStack/ai/commit/b881627d51076dcc1af031ac951046e2fb7d84c4), [fac0555](https://github.com/TanStack/ai/commit/fac055559de98eb0fa23a0bc725808033ba3c2fc), [6774e80](https://github.com/TanStack/ai/commit/6774e803da3205101613ab2857c9ed4fbf97568 …

   在 GitHub 查看 ↗
3. @tanstack/[email protected] 2026-10-13
   发布说明摘录

   Patch Changes - Updated dependencies \[[1bfcee3](https://github.com/TanStack/ai/commit/1bfcee35bb3cf0ff3aac005440c842e66c3d687d), [412b0fe](https://github.com/TanStack/ai/commit/412b0fea4f4bb569998c3d253d174efd7b501e3c), [a0150c2](https://github.com/TanStack/ai/commit/a0150c26b9e2b6050663450171e36a9dfa80915b), [b881627](https://github.com/TanStack/ai/commit/b881627d51076dcc1af031ac951046e2fb7d84c4), [fac0555](https://github.com/TanStack/ai/commit/fac055559de98eb0fa23a0bc725808033ba3c2fc), [6774e80](https://github.com/TanStack/ai/commit/6774e803da3205101613ab2857c9ed4fbf97568 …

   在 GitHub 查看 ↗

常见问题