
随着AI的快速发展正在重塑技术生态,协议的演进速度尤为迅猛。一个令人头疼的问题浮现了:不同的AI智能体和前端应用之间就像说着不同语言的人,无法顺畅交流。开发者们需要为每个智能体单独编写接口,维护成本高昂,用户体验也参差不齐。

正是在这样的背景下,2025年5月,以开发AI集成工具包CopilotKit而闻名的技术团队,正式开源发布了AG-UI (Agent-User Interaction Protocol)。其核心使命直击痛点:为AI智能体(Agent)与用户界面(UI Application)之间的实时、双向、结构化通信,制定一个专门为智能体与用户交互而设计的开放标准。
MCP 和 A2A 为 AI 智能体与工具、其他智能体之间的交互奠定标准之后,AG-UI 进一步填补了智能体与用户前端交互的空白。
什么是AG-UI协议?

AG-UI协议,全称Agent-User Interaction Protocol(智能体用户交互协议),是一个轻量级、事件驱动的开放协议。它充当了后端AI智能体和全栈应用之间的桥梁,是智能体与用户相遇的地方。
简单来说,AG-UI就像是一个"翻译官",让不同的AI智能体都能用统一的"语言"与前端应用对话。无论你的智能体使用什么框架开发,通过AG-UI协议,它都能与用户界面实现流畅的实时交互。
AG-UI协议的核心特性
1. 事件驱动架构
AG-UI采用事件驱动的设计理念,通过标准HTTP或可选的二进制通道流式传输单一序列的JSON事件。这些事件包括:
- 消息事件:处理对话内容
- 工具调用事件:执行特定功能
- 状态补丁事件:更新应用状态
- 生命周期信号:管理会话流程
2. 双向交互能力
与传统的单向通信不同,AG-UI支持真正的双向交互。智能体不仅能向用户发送信息,还能接收用户的实时反馈,实现真正的协作式工作流程。
3. 传输方式灵活
AG-UI不强制要求特定的传输方式,支持多种通信机制:
- Server-Sent Events (SSE)
- WebSockets
- Webhooks
- 其他自定义传输方式
这种灵活性让开发者能够根据自己的架构需求选择最适合的通信方式。
4. 兼容性强
AG-UI设计时充分考虑了兼容性问题。现有的智能体框架不需要完全重写,只需要让事件格式兼容AG-UI即可。这大大降低了迁移成本。
AG-UI 与 A2A、MCP 的关系
AG-UI专注于智能体与用户的交互层,它不与A2A(智能体到智能体协议)和MCP(模型上下文协议)等协议竞争。 实际上,这些协议是互补的:
- AG-UI:专注于智能体与用户的深度协作,将智能体引入前端应用
- MCP:标准化工具调用和上下文处理
- A2A:促进智能体之间的通信和协作
一个智能体可以同时使用这三种协议:用MCP调用工具,用A2A与其他智能体通信,用AG-UI与用户协作。
接入使用 AG-UI

目前官方提供了两种语言的SDK 接入使用:
Python SDK:
js
pip install ag-ui-protocol
TS SDK
js
npm install @ag-ui/core
AG-UI提供了完整的开发工具链
- 详细的文档和示例
- 多种编程语言的SDK
- 调试和故障排除工具
- 与Cursor等开发工具的集成
AG-UI
AG-UI 整体架构 以及传输机制

事件流执行流程

AG-UI Chat 场景

最后
AG-UI不仅仅是一个协议,它是智能系统与人类交互的新兴标准。对于开发者来说,AG-UI提供了一个简洁、可扩展、优雅的基础,用于创建高质量、交互性强、可控制的智能体应用。对于用户来说,这意味着更流畅、更自然、更智能的AI交互体验。 随着AI技术的不断发展,智能体将越来越多地融入我们的日常工作和生活中。或许未来都是Agent 应用了,不是当下我们传统的App 多个分支输出端了,任何变的很简单。
AG-UI doc: