AG‑UI：用于代理与用户交互的开放协议

它是什么 – AG‑UI（代理与用户交互）是一个轻量级、基于事件的协议，用于标准化 AI 代理与面向用户的应用程序之间的通信。它定义了一小组约 16 种事件类型，代理可以发出这些事件，以及一些简单的输入形状，应用程序可以发送回这些输入。中间件层处理传输（SSE、WebSockets、webhooks 等）和宽松的格式匹配，使得将任何后端代理插入任何前端 UI 变得容易。

为什么重要 – 现代 AI 代理（LangChain、CrewAI、Microsoft Agent Framework 等）擅长推理，但将它们集成到实时用户界面中仍然是临时性的。AG‑UI 位于新兴代理协议栈的 代理到人类 层（MCP 提供工具，A2A 让代理相互通信，AG‑UI 将代理连接到人）。通过提供通用契约，开发人员可以重用 UI 组件、共享状态，并交换代理而无需重写粘合代码。

主要特性

• 实时流式聊天 – 代理将部分响应作为事件推送。
• 双向状态同步 – UI 和代理保持共享状态模型的最新状态。
• 生成式 UI 消息 – 代理可以描述客户端即时渲染的 UI 元素（表单、表格等）。
• 上下文丰富 – 事件可以携带额外的用户上下文（位置、最近操作等）以获得更丰富的响应。
• 工具集成钩子 – 前端库可以公开代理可以调用的工具（例如文件上传）。
• 人在回路 – 用户可以干预、编辑或批准代理操作。

支持的生态系统 – 该项目提供了参考 HTTP 实现和默认连接器，以及多种语言的 SDK（Kotlin、Go、Dart、Java、Rust、Ruby、C++、.NET 等）。第一方集成包括 CopilotKit、LangChain、CrewAI、Microsoft Agent Framework、Google ADK、AWS Strands、LlamaIndex 等。社区适配器适用于 Claude SDK、Langroid、Cloudflare Agents 等。

入门 – 最简单的入口是 CLI 启动器：

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

这会搭建一个最小应用，使用该协议将代理后端连接到 Web UI。AG‑UI Dojo (https://dojo.ag-ui.com) 展示了每个构建块的简短示例（50-200 行），文档提供了应用程序和框架集成的快速入门指南。

典型用例

1. 代理后端（例如 LangChain 图）发出 message、stateUpdate、toolCall 事件。
2. AG‑UI 中间件 将这些转换为标准事件负载，并通过 WebSocket 流式传输。
3. 前端客户端（React、React‑Native、终端、Slack 等）接收事件，渲染聊天 UI，更新共享状态，并可以将用户输入作为 AG‑UI 兼容请求发送回。
4. 循环继续，在产品内实现交互式、上下文感知的 AI 体验。

社区与治理 – 该项目采用 MIT 许可证，拥有活跃的 Discord、双周工作组和公开路线图（GitHub Projects）。欢迎通过常规拉取请求流程和详细的 CONTRIBUTING 指南贡献。

---

TL;DR – AG‑UI 是一个真实的、开源的协议，标准化了 AI 代理与用户界面之间的通信，提供实时聊天、状态同步和生成式 UI 功能，支持多种语言和框架。