跳到主要内容

开放协议 · 事件驱动 · 实时双向

让智能体
真正融入用户界面。

AG-UI(Agent–User Interaction Protocol)标准化 AI 智能体与前端应用之间的交互方式。 通过统一的事件流,你可以轻松实现流式聊天、共享状态、工具调用、生成式 UI 与人机协同。

协议定位 · Agentic Protocol Stack

~16类标准事件类型

MCP 提供工具,A2A 连接智能体,AG-UI 负责将智能体能力带入面向用户的应用体验。

开放协议 · MIT 许可传输无关(SSE / WebSocket)框架与客户端可互操作

适用于多种语言、框架与客户端形态

事件驱动流式 · 状态 · 工具 · 中断

一套协议覆盖
智能体交互关键能力

  • SSE / WebSocket
  • 流式聊天
  • 共享状态
  • 前端工具调用
  • 后端工具渲染
  • 生成式 UI
  • 人机协同中断
  • 自定义事件

对比

从临时对接到标准化交互。

没有统一协议时,流式输出、状态同步、工具调用与中断往往需要在每个项目里重复拼装。 AG-UI 用一致的事件模型把智能体与界面连接起来,让交互链路更清晰、更易扩展。

agent.run() → AG-UI events → UI 实时更新待演示
交互场景
慢放 40×
播放
方案
显示
临时拼接方案示意0 ms
用户输入自定义协议状态胶水UI 适配渲染

每个框架与前端都要单独适配,流式与状态同步逻辑容易分散且难维护。

额外适配层 多 个

局部协议示意0 ms
用户输入框架事件转换层UI 适配渲染

能解决部分问题,但在工具、状态、中断等能力上仍需额外约定。

额外适配层 多 个

AG-UI 协议示意0 ms
用户输入AG-UI 输入标准事件流客户端处理实时 UI

以统一事件模型连接智能体与界面,天然适配流式输出、工具与人机协同。

额外适配层 0 个

本节为协议价值的可视化示意,用于说明标准事件模型如何减少自定义胶水代码与重复适配。实际收益取决于框架、传输方式与应用架构。了解核心架构 →

临时拼接方案420 ms
局部协议210 ms
AG-UI 协议48 ms

临时拼接局部协议AG-UI交互链路复杂度示意 · 越低越好

核心能力

构建智能体应用所需的交互构建块。

从流式聊天到共享状态、从工具调用到人机协同,AG-UI 将复杂的智能体交互抽象为可组合、可扩展的标准能力。

  • 实时流式交互

    基于事件流传输 token、步骤与中间结果,让多轮智能体会话保持即时响应与可感知进展。

    查看说明
  • 双向状态同步

    在智能体与应用之间共享类型化状态,通过增量事件同步变更,支撑协作式体验。

    查看说明
  • 生成式 UI

    将模型输出映射为稳定组件或声明式 UI 意图,在灵活表达与应用可控之间取得平衡。

    查看说明
  • 工具调用可视化

    统一呈现后端工具执行与前端动作交接,让长链路任务的过程与结果一目了然。

    查看说明
  • 人机协同中断

    在关键节点暂停、批准、编辑或重试,在不丢失状态的前提下引入人工判断。

    查看说明
  • 广泛生态集成

    对接多种智能体框架、SDK 与客户端形态,从 Web 到终端、聊天平台与移动端皆可接入。

    查看说明
  • 协议栈协同

    与 MCP(工具与数据)、A2A(智能体协作)互补,专注解决“智能体 ↔ 用户”交互层。

    查看说明
  • 可扩展事件模型

    在标准事件之外支持自定义事件,满足业务特有的交互与数据传输需求。

    查看说明
  • 面向真实场景

    源自真实应用内智能体交互实践,覆盖长任务、非确定性行为与复杂 UI 控制需求。

    查看说明

开发体验

从脚手架到事件流,一条清晰路径。

无论你是接入现有智能体框架,还是为自研后端与客户端实现协议支持,AG-UI 都提供了统一的交互语义与上手方式。

  • 脚手架快速起步 使用 create-ag-ui-app 在几秒内创建可运行的 AG-UI 应用骨架。
  • 事件驱动连接 后端发出标准事件,前端实时消费并渲染聊天、状态与工具进展。
  • 可组合能力 按需引入生成式 UI、共享状态、子智能体与人机协同中断等构建块。
  • 多端与多框架 同一协议可连接不同智能体框架,并服务于 Web、终端与聊天平台客户端。
~ terminal
$ 
示例会话 · AG-UI 应用开发流程

生态互操作

一个协议,连接多种框架与客户端。

AG-UI 让智能体后端与用户界面解耦:后端可以来自不同框架或自研实现,前端可以是 Web、终端或聊天平台客户端,只要遵循同一事件与交互语义即可协作。

  • 框架接入。 LangGraph、CrewAI、Microsoft Agent Framework、Google ADK、Mastra 等已提供集成或支持。
  • 多端客户端。 同一智能体可服务于 Web 应用、终端工具与 Slack / Teams 等聊天平台。
  • 示例可验证。 在 AG-UI Dojo 中查看不同框架与特性的实时演示与源码思路。
  • 开放扩展。 在标准事件之上通过自定义事件与中间件适配业务需求。
AG-UI 与 A2UI 有什么不同?收起说明
名称相近,定位不同A2UI 是一种生成式 UI 规范,关注智能体如何交付 UI 组件;AG-UI 是 Agent ↔ User Interaction 协议,关注智能体前端与后端之间的实时交互连接。两者可以协同使用。
开放生态https://github.com/ag-ui-protocol/ag-ui
  • 框架LangGraph / CrewAI / ADK后端
  • 协议AG-UI Events交互层
  • 客户端Web / CLI / Chat前端
同一协议语义 · 多种实现与运行环境了解协议

可观测与可控

把智能体过程变成可理解的交互。

面向用户的智能体不仅要“给出答案”,还要展示进展、解释状态、处理工具结果并在必要时请求确认。 AG-UI 的事件模型为这些体验提供了统一基础。

交互要素

并发事件流 4
每流负载 128
时间流速 6×
空闲窗口
操作
会话进行中模拟时间 00:00
事件吞吐512
基础开销15
空闲窗口0 / 60 s
交互活动 · 最近 2 分钟峰值 512
  • 00:00会话已建立,等待用户输入与智能体事件

本面板为交互可观测性的示意演示,用于说明事件流、状态与中断如何共同构成可控体验。协议细节请参阅事件机制 与 核心能力。

上手路径

四步接入 AG-UI 交互层。

从创建应用到扩展高级能力,逐步构建标准化的智能体用户体验。

  1. 01

    创建应用

    使用官方脚手架初始化项目,获得 AG-UI 应用的基础结构与示例。

    npx create-ag-ui-app my-agent-app
    查看快速开始
  2. 02

    连接智能体后端

    让你的智能体运行时发出 AG-UI 标准事件,并接收兼容输入。

    agent → emit AG-UI events (SSE/WebSocket)
  3. 03

    在前端订阅事件

    客户端消费事件流,渲染流式消息、工具状态与共享状态更新。

    client.subscribe(events).render(ui)
  4. 04

    扩展交互能力

    按需加入生成式 UI、前端工具、人机协同中断与自定义事件。

    add: generative UI · HITL · custom events

查看完整快速开始指南

架构原理

事件流连接智能体与界面。

AG-UI 位于智能体后端与用户应用之间:后端发出标准化事件表达消息、状态、工具与控制信号,前端订阅事件并将其映射为实时、可交互的用户体验。

~16类
标准事件类型

覆盖消息、状态、工具、控制等核心交互语义。

3层
协议栈协同

MCP 提供工具,A2A 连接智能体,AG-UI 连接用户。

∞
可扩展能力

通过自定义事件与中间件适配不同框架与业务场景。

阅读核心架构文档

智能体后端 · Agent Runtime

执行推理与工具调用,发出 AG-UI 兼容事件并接收输入

SSE / WebSocket
浏览器客户端

订阅事件流,渲染聊天、状态面板与生成式 UI

AG-UI 输入智能体执行标准事件客户端状态UI 渲染

AG-UI 与 MCP、A2A 协同:MCP 连接工具与数据,A2A 连接智能体之间的协作,AG-UI 连接智能体与最终用户。

客户端与场景

同一协议,适配多种交互入口。

AG-UI 描述的是事件流与交互语义,因此客户端不局限于网页。你可以在浏览器、终端或协作平台中,为用户提供一致的智能体体验。

开始构建你的 AG-UI 应用

使用脚手架创建项目,连接兼容 AG-UI 的智能体后端,在前端订阅标准事件流,即可获得实时聊天、状态同步与工具交互能力。

npx create-ag-ui-app my-agent-app

从概念到落地,一站式阅读。

本站基于 AG-UI 官方 README 与文档简介整理,提供协议概述、核心架构、事件机制、能力构建块、生态集成与 SDK 客户端等中文内容,帮助你快速理解并接入 AG-UI。

Type to search…

↑↓ navigate↵ selectEsc close