SuperAPI AI 工具集

tanstack-ai-core

智能体与模型

查看项目

更新于 10-16 00:01

技能介绍

用途:TanStack AI 是一个类型安全、与提供商无关的 AI SDK。本技能是其核心概念入口,按需求把使用者路由到对应子技能文档,避免凭猜测调用 API。

主要能力与路由:构建流式聊天 UI 读 chat-experience;浏览器刷新后保持会话读 client-persistence;添加工具调用读 tool-calling;生成图像、视频、语音或转写读 media-generation;获取类型化 JSON 输出读 structured-outputs;选择与配置提供商适配器读 adapter-configuration;服务端实现 AG-UI 流式协议读 ag-ui-protocol;添加分析、日志或生命周期钩子读 middleware;多实例锁协调读 locks;接入非 TanStack AI 后端读 custom-backend-integration;调试日志读 debug-logging。服务端持久化与 Code Mode 属于独立包,需先安装再读其自带技能。

使用方式:服务端函数位于 @tanstack/ai 与提供商适配器包;客户端钩子位于框架包(@tanstack/ai-react、@tanstack/ai-solid 等),客户端应从框架包导入,而非直接使用 @tanstack/ai-client(纯 JS 除外)。持久化包安装命令为 pnpm add @tanstack/ai-persistence,随后执行 npx @tanstack/intent@latest install 重新扫描 node_modules 并接入代理配置。

关键规则:这不是 Vercel AI SDK,使用 chat() 而非 streamText(),使用 openaiText() 而非 createOpenAI(),从 @tanstack/ai 导入而非 ai;用 toServerSentEventsResponse() 转换流为 HTTP 响应,不要手写 SSE;生命周期事件用 middleware,chat() 没有 onEnd/onFinish 回调;工具需同时传给服务端与客户端,客户端通过 clientTools() 传入 tools 选项。目标版本为 TanStack AI v0.42.0。

限制:持久化包不提供数据库后端,需自行针对 Postgres、SQLite、D1、Mongo 等实现存储接口;浏览器端持久化不在该包中。具体 API 细节需阅读对应子技能,本文件不展开。