AG-UI
Agent-User Interaction Protocol
Agent-用户交互协议 · 让 Agent 从黑盒变成实时协作者
- 定义
- AG-UI（Agent-User Interaction Protocol）是AI领域的专业术语。每个 Agent 框架都在自造流式通信格式，前端团队疲于对接。
最后更新：2026-03-29
什么是AG-UI？
每个 Agent 框架都在自造流式通信格式，前端团队疲于对接。AG-UI 定义了一套 16 种结构化事件（生命周期、文本流、工具调用、状态同步），通过 HTTP+SSE 在 Agent 后端和前端之间建立标准化的实时事件流。2025 年 5 月由 CopilotKit 首发，Microsoft、Oracle 已宣布集成。
- 16 种标准事件覆盖完整交互：生命周期、文本消息、工具调用、状态管理
- 双向实时同步——Agent 推送进度，前端回传用户操作，全程保持一致
- Microsoft Agent Framework 和 Oracle Agent Spec 已采纳，生态快速扩展
AG-UI详解
AI Agent 的前端集成长期缺乏标准：每个框架自定义流式格式，前端团队为每个 Agent 重写对接逻辑。AG-UI 通过事件驱动架构解决这个问题，定义了 RunStarted/RunFinished（生命周期）、TextMessageContent（文本流）、ToolCallStart/ToolCallEnd（工具调用）、StateSnapshot/StateDelta（状态同步）等 16 种事件类型，加上 Raw 和 Custom 扩展点。协议基于 HTTP POST + SSE 传输，也支持可选的二进制通道。与 A2UI 的关系是：AG-UI 管「传输和同步」，A2UI 管「UI 长什么样」。当前已被 Microsoft Agent Framework、Oracle Agent Spec、AG2 等采纳，成为 Agent 前端集成的事实标准。
公式提示
Agent 后端 → 发射结构化事件流（SSE） → AG-UI 协议层 → 前端消费事件并渲染/回传交互
AG-UI的应用场景
正式定义
一种开源的、事件驱动的轻量协议，标准化 AI Agent 后端与用户前端应用之间的实时双向通信。
应用场景
- Agent 应用中实时展示工具调用进度、中间结果和状态变化
- 跨框架复用同一套前端组件——无论后端用 LangGraph、CrewAI 还是自研 Agent
- MCP Apps 在宿主应用中运行时，通过 AG-UI 保持 Agent、UI 和应用三方状态同步
常见误区
- AG-UI 不定义 UI 长什么样——那是 A2UI 的职责；AG-UI 只管事件传输和状态同步
- AG-UI 不是聊天协议——它覆盖工具调用、状态管理等远超文本对话的交互场景
实际案例
📌 Microsoft Agent Framework 集成
Microsoft 在其 Agent Framework 中采纳 AG-UI，开发者可用标准事件流将 Azure AI Agent 的工具调用进度、状态更新实时推送到前端，无需自建流式通信层。
📌 MCP Apps + AG-UI
CopilotKit 通过 AG-UI 驱动 MCP Apps 集成，MCP Server 输出的交互式 UI 在宿主应用中运行时，工具生命周期、用户交互和 Agent 状态通过 AG-UI 事件流保持三方同步。
AG-UI的参考来源
关于AG-UI的常见问题
- AG-UI 和 A2UI 有什么区别
- AG-UI 管传输层——定义 Agent 和前端之间的事件流格式和同步机制；A2UI 管表现层——定义 UI 组件长什么样。两者配合使用，AG-UI 传输 A2UI 描述的界面。
- AG-UI 有哪些事件类型
- 共 16 种，分四类：生命周期（RunStarted/Finished/Error）、文本消息（Start/Content/End）、工具调用（Start/Args/End/Result）、状态管理（Snapshot/Delta），加上 Raw 和 Custom 扩展。
- AG-UI 支持哪些 Agent 框架
- 框架无关，LangGraph、CrewAI、AG2、Microsoft Agent Framework、Oracle Agent Spec 等均已支持或集成。