assistant-ui 介绍
了解工具的详细功能和使用方法
assistant-ui 是用于 AI 聊天与 Agent 界面的 TypeScript/React 开源库，适合已有模型或 Agent 后端、需要把消息、工具结果、表单和人工确认做成完整产品界面的团队。它提供界面组件、运行时适配和工具 UI；模型选择、业务数据授权与外部操作仍由应用和后端负责。
适合哪些产品
- 给现有客服、知识库或 SaaS 加入有历史记录、附件与工具结果的聊天界面。
- 将查询结果显示为订单卡片、表格或图表，并为业务操作提供可读的确认界面。
- 保留已有 AI SDK、LangGraph 或其他 Agent 后端，重点改善前端交互与流式状态。
当前工具文档覆盖 frontend、backend、human 和 provider 工具，允许为工具调用配置自定义 renderer。生成式 UI 也有不同路线：按已知工具渲染一个组件、让模型从组件词表组成界面，或使用受约束的内容框架。应先选择需要的路线，不能假定这些接口的 schema 可以直接互换。
接入时最重要的边界
工具界面可以展示参数、等待状态、结果、拒绝和错误。addResult 用于收集用户提供的结果；human() / resume() 处理等待用户的交互；服务端审批请求由对应运行时的 approval 状态与 respondToApproval 处理。这些交互都需要后端支持，不能仅画一个按钮就宣布业务操作已得到可靠授权。
服务端仍要从登录会话取得用户与租户，检查资源权限、操作范围、版本和幂等。模型给出的 ID 或浏览器回传的 approved 只能作为请求输入，不能自行证明用户有权操作。历史会话和只读线程也应限制回答工具的能力，避免打开旧记录时再次执行操作。
当前文档还提供 "use generative" 工具包写法，由构建插件分离 schema、执行器和 renderer；采用这条路线时需要相应编译配置。已有项目应核对所选适配器、消息协议和依赖版本，避免把旧版教程片段与当前 SDK 混用。
库、模型与托管费用
截至 2026 年 10 月 12 日，assistant-ui 官方定价页明确：开源库采用 MIT 许可，可保留自己的后端；assistant-cloud 是可选的会话、历史与用户范围存储服务。模型 token、应用服务器、数据库与业务 API 不因 UI 库开源而自动免费。
当前 assistant-cloud 的 B2B 公开方案为 Free 含 200 MAU，Pro 每月 50 美元含 500 MAU，额外每 MAU 0.10 美元，Enterprise 询价。MAU 指当月至少发送一条消息的活跃用户，并不是消息条数或模型 token。消费者应用另行询价。接入托管历史前，确认资料保留、用户/工作区范围、删除与导出要求。
一周试点
先接一个无副作用的工单查询，让 UI 展示加载、成功、空结果、超时和取消。再接一个只返回模拟结果的需审批工具，测试批准、拒绝、重复点击、跨租户请求、历史重放和审批后失败。最后比较首条可见内容的时间、状态可理解性、键盘操作、每个完成任务的模型/运行/托管成本。本文没有把演示效果写成真实业务的性能测量。