开放协议 · 事件驱动 · 实时双向
让智能体
真正融入用户界面。
AG-UI(Agent–User Interaction Protocol)标准化 AI 智能体与前端应用之间的交互方式。 通过统一的事件流,你可以轻松实现流式聊天、共享状态、工具调用、生成式 UI 与人机协同。
协议定位 · Agentic Protocol Stack
MCP 提供工具,A2A 连接智能体,AG-UI 负责将智能体能力带入面向用户的应用体验。
开放协议 · MIT 许可传输无关(SSE / WebSocket)框架与客户端可互操作
适用于多种语言、框架与客户端形态
- AG-UI Dojo
- 官方文档
- Web / 终端 / 聊天平台
- LangGraph · CrewAI · ADK 等
- RUN_STARTED会话启动已接收
- TEXT_MESSAGE_*流式输出进行中
- TOOL_CALL_*工具调用已完成
- STATE_SNAPSHOT状态同步已同步
一套协议覆盖
智能体交互关键能力
- SSE / WebSocket
- 流式聊天
- 共享状态
- 前端工具调用
- 后端工具渲染
- 生成式 UI
- 人机协同中断
- 自定义事件
对比
从临时对接到标准化交互。
没有统一协议时,流式输出、状态同步、工具调用与中断往往需要在每个项目里重复拼装。 AG-UI 用一致的事件模型把智能体与界面连接起来,让交互链路更清晰、更易扩展。
每个框架与前端都要单独适配,流式与状态同步逻辑容易分散且难维护。
额外适配层 多 个
能解决部分问题,但在工具、状态、中断等能力上仍需额外约定。
额外适配层 多 个
以统一事件模型连接智能体与界面,天然适配流式输出、工具与人机协同。
额外适配层 0 个
本节为协议价值的可视化示意,用于说明标准事件模型如何减少自定义胶水代码与重复适配。实际收益取决于框架、传输方式与应用架构。了解核心架构 →
临时拼接局部协议AG-UI交互链路复杂度示意 · 越低越好
核心能力
构建智能体应用所需的交互构建块。
从流式聊天到共享状态、从工具调用到人机协同,AG-UI 将复杂的智能体交互抽象为可组合、可扩展的标准能力。
实时流式交互
基于事件流传输 token、步骤与中间结果,让多轮智能体会话保持即时响应与可感知进展。
查看说明双向状态同步
在智能体与应用之间共享类型化状态,通过增量事件同步变更,支撑协作式体验。
查看说明生成式 UI
将模型输出映射为稳定组件或声明式 UI 意图,在灵活表达与应用可控之间取得平衡。
查看说明工具调用可视化
统一呈现后端工具执行与前端动作交接,让长链路任务的过程与结果一目了然。
查看说明人机协同中断
在关键节点暂停、批准、编辑或重试,在不丢失状态的前提下引入人工判断。
查看说明广泛生态集成
对接多种智能体框架、SDK 与客户端形态,从 Web 到终端、聊天平台与移动端皆可接入。
查看说明协议栈协同
与 MCP(工具与数据)、A2A(智能体协作)互补,专注解决“智能体 ↔ 用户”交互层。
查看说明可扩展事件模型
在标准事件之外支持自定义事件,满足业务特有的交互与数据传输需求。
查看说明面向真实场景
源自真实应用内智能体交互实践,覆盖长任务、非确定性行为与复杂 UI 控制需求。
查看说明
上手路径
四步接入 AG-UI 交互层。
从创建应用到扩展高级能力,逐步构建标准化的智能体用户体验。
- 01
创建应用
使用官方脚手架初始化项目,获得 AG-UI 应用的基础结构与示例。
查看快速开始npx create-ag-ui-app my-agent-app - 02
连接智能体后端
让你的智能体运行时发出 AG-UI 标准事件,并接收兼容输入。
agent → emit AG-UI events (SSE/WebSocket) - 03
在前端订阅事件
客户端消费事件流,渲染流式消息、工具状态与共享状态更新。
client.subscribe(events).render(ui) - 04
扩展交互能力
按需加入生成式 UI、前端工具、人机协同中断与自定义事件。
add: generative UI · HITL · custom events
架构原理
事件流连接智能体与界面。
AG-UI 位于智能体后端与用户应用之间:后端发出标准化事件表达消息、状态、工具与控制信号,前端订阅事件并将其映射为实时、可交互的用户体验。
覆盖消息、状态、工具、控制等核心交互语义。
MCP 提供工具,A2A 连接智能体,AG-UI 连接用户。
通过自定义事件与中间件适配不同框架与业务场景。
执行推理与工具调用,发出 AG-UI 兼容事件并接收输入
订阅事件流,渲染聊天、状态面板与生成式 UI
AG-UI 与 MCP、A2A 协同:MCP 连接工具与数据,A2A 连接智能体之间的协作,AG-UI 连接智能体与最终用户。
客户端与场景
同一协议,适配多种交互入口。
AG-UI 描述的是事件流与交互语义,因此客户端不局限于网页。你可以在浏览器、终端或协作平台中,为用户提供一致的智能体体验。