用途:assistant-ui 是用于构建 AI 聊天界面的 React 库,提供可组合的基础组件,可用于从零搭建聊天 UI、连接已有流式后端、支持自定义消息类型(工具、图片、文件等)、多会话应用以及生产级应用。
主要能力:其架构分为多层,自下而上依次为适配层(AI SDK、LangGraph、自定义后端、云端持久化)、运行时层(AssistantRuntime → ThreadRuntime → MessageRuntime)、上下文 Hook 层(useAui、useAuiState、useAuiEvent)以及 UI 组件原语层(ThreadPrimitive、MessagePrimitive、ComposerPrimitive)。核心包包括 @assistant-ui/react(UI 原语与 Hook)、@assistant-ui/react-ai-sdk(Vercel AI SDK v6 适配器)、@assistant-ui/react-langgraph(LangGraph 适配器)、@assistant-ui/react-markdown(Markdown 渲染)、assistant-stream(流式协议)、assistant-cloud(云持久化)。
使用方式:选择运行时后接入。使用 AI SDK 时推荐 useChatRuntime;外部状态(Redux/Zustand)用 useExternalStoreRuntime;LangGraph 智能体用 useLangGraphRuntime;AG-UI 协议用 useAgUiRuntime;A2A 协议用 useA2ARuntime;自定义 API 用 useLocalRuntime。基础用法为创建 runtime,再以 AssistantRuntimeProvider 包裹 Thread 组件。状态访问通过 useAui 获取 api,可调用 api.thread().append(...) 追加消息、api.thread().cancelRun() 取消运行,并用 useAuiState 读取消息与运行状态。
限制与说明:官方建议始终查阅 assistant-ui.com/llms.txt 获取最新 API;其余细节(如具体收费、价格、平台支持范围等)暂未提供。