Skip to main content
为通过 createAgent 创建的智能体构建丰富、交互式的前端。这些模式涵盖了从基础消息渲染到高级工作流(如人工介入审批和时间旅行调试)的所有内容。

架构

每个模式都遵循相同的架构:一个 createAgent 后端通过 useStream 钩子将状态流式传输到前端。 在后端,createAgent 生成一个已编译的 LangGraph 图,该图暴露了一个流式 API。在前端,useStream 钩子连接到该 API,并提供响应式状态——消息、工具调用、中断、历史记录等——你可以使用任何框架来渲染这些状态。
from langchain import create_agent
from langgraph.checkpoint.memory import MemorySaver

agent = create_agent(
    model="openai:gpt-5.4",
    tools=[get_weather, search_web],
    checkpointer=MemorySaver(),
)
useStream 可用于 React、Vue、Svelte 和 Angular:
import { useStream } from "@langchain/react";   // React
import { useStream } from "@langchain/vue";      // Vue
import { useStream } from "@langchain/svelte";   // Svelte
import { useStream } from "@langchain/angular";  // Angular

模式

渲染消息和输出

Markdown 消息

解析并渲染流式传输的 Markdown,提供正确的格式和代码高亮。

结构化输出

将类型化的智能体响应渲染为自定义 UI 组件,而非纯文本。

推理令牌

在可折叠的区块中展示模型的思考过程。

生成式 UI

使用 json-render 根据自然语言提示渲染 AI 生成的用户界面。

展示智能体操作

工具调用

将工具调用显示为丰富、类型安全的 UI 卡片,并带有加载和错误状态。

人工介入

暂停智能体以进行人工审核,并提供批准、拒绝和编辑工作流。

管理对话

分支对话

编辑消息、重新生成响应以及导航对话分支。

消息队列

在智能体顺序处理消息的同时,对多条消息进行排队。

高级流式传输

加入和重新加入流

断开并重新连接到正在运行的智能体流,而不会丢失进度。

时间旅行

检查、导航并从对话历史中的任何检查点恢复。

集成

useStream 是 UI 无关的。可将其用于任何组件库或生成式 UI 框架。

AI Elements

用于 AI 聊天的可组合 shadcn/ui 组件:ConversationMessageToolReasoning

assistant-ui

无头 React 框架,内置线程管理、分支和附件支持。

OpenUI

使用 openui-lang 组件 DSL 构建数据丰富报告和仪表板的生成式 UI 库。