新一代 AI agent（AI 代理）在汇总、数据迁移和调度等后端任务自动化方面取得了重大进展。虽然效果显著，但这些代理通常是在幕后运行——由预定义的工作流触发并返回结果，无需用户参与。然而，随着人工智能应用的交互性越来越强，人们明显需要能直接与用户实时协作的代理。
AG-UI（Agent-User Interaction Protocol，代理与用户交互协议）是一个开放的事件驱动协议，旨在满足这一需求。它在后端 AI agent 和前端应用程序之间建立了一个结构化通信层，通过结构化 JSON 事件流实现实时交互。通过将这种交换正式化，AG-UI 促进了人工智能系统的发展，这些系统不仅是自主的，而且是用户感知和响应的。
从MCP到A2A再到AG-UI：代理协议的演变
AG-UI的研发历程是不断迭代的。首先是MCP（模型上下文协议），它实现了跨模块化组件的结构化通信。随后，A2A（代理到代理）协议实现了专用 AI 代理之间的协同工作。
AG-UI 完善了这一切：它是第一个明确连接后端 AI 代理和前端用户界面的协议。对于那些试图将后端 LLM 工作流转变为动态、交互式、以人为本的应用程序的开发人员来说，这恰恰弥补了他们所缺少的一层。
为什么我们需要 AG-UI？
到目前为止，大多数人工智能代理都充当着后端工作者的角色——高效却不可见。像 LangChain、LangGraph、CrewAI 和 Mastra 这样的工具越来越多地被用于协调复杂的工作流程，然而交互层仍然碎片化且临时性很强。自定义 WebSocket 格式、JSON hack 或诸如“Thought:\nAction:”之类的即时工程技巧已成为常态。
然而，当构建像Cursor这样的交互式代理（在编码环境中与用户并肩工作）时，复杂性就会急剧上升。开发人员面临着几个难题：
- Streaming UI：LLM 以增量方式产生输出，因此用户需要逐个查看响应。
- 工具编排：代理必须与 API 交互、运行代码，有时还必须暂停以获得人工反馈，而不会阻塞或丢失上下文。
- 共享可变状态：对于代码库或数据表之类的东西，您不能每次都重新发送完整的对象；您需要结构化的差异。
- 并发与控制：用户可能会发送多个查询或中途取消操作。线程和运行状态必须得到清晰的管理。
- 安全性和合规性：企业级解决方案需要 CORS 支持、授权标头、审计日志以及客户端和服务器职责的明确分离。
- 框架异构性：每个代理工具（LangGraph、CrewAI、Mastra）都使用自己的接口，这会减慢前端开发的速度。
AG-UI 带来的优势
AG-UI提供统一的解决方案。它是一种轻量级事件流协议，使用标准 HTTP（包含服务器发送事件，简称 SSE）将代理后端连接到任何前端。您只需向代理端点发送单个 POST 消息，即可实时监听结构化事件流。
每个事件都有：
- 类型：例如 TEXT_MESSAGE_CONTENT、TOOL_CALL_START、STATE_DELTA
- 最小类型有效载荷
该协议支持：
- 实时代币流
- 工具使用进度
- 状态差异和补丁
- 错误和生命周期事件
- 多代理切换
开发者体验：即插即用的 AI 代理
AG-UI 附带 TypeScript 和 Python 语言的 SDK，旨在与几乎任何后端（OpenAI、Ollama、LangGraph 或自定义代理）集成。您可以使用其快速入门指南和 Playground在几分钟内上手。
使用 AG-UI：
- 前端和后端组件变得可以互换
- 您可以使用 CopilotKit 组件插入 React UI，无需任何后端修改
- 将 GPT-4 替换为本地 Llama，无需更改 UI
- 通过相同的协议混合搭配代理工具（LangGraph、CrewAI、Mastra）
AG-UI 在设计时也考虑到了性能：使用 HTTP 上的纯 JSON 来实现兼容性，或者在需要时升级到二进制序列化器以获得更高的速度。
AG-UI 的功能
AG-UI不仅仅是一个开发者工具，它更是实现更丰富 AI 用户体验的催化剂。通过标准化代理和应用程序之间的接口，它使开发者能够：
- 使用更少的自定义适配器更快地构建
- 提供更流畅、更具交互性的用户体验
- 使用一致的日志调试和重放代理行为
- 通过自由交换组件避免供应商锁定
例如，由 LangGraph 提供支持的协作代理现在可以在 React UI 中分享其实时计划。基于 Mastra 的助手可以在执行代码前暂停并请求用户确认。AG2 和 A2A 代理可以无缝切换上下文，同时让用户始终了解情况。
结论
AG-UI是面向用户的实时 AI 的一大进步。随着基于 LLM 的代理在复杂性和功能上的不断增长，对简洁、可扩展且开放的通信协议的需求也愈发迫切。AG-UI 正是为此而生——它为构建不仅能行动，还能交互的代理提供了现代标准。
无论您是构建自动 copilots 还是轻量级助手，AG-UI 都能为前端代理界面带来结构、速度和灵活性。
体验地址：https://pxl.to/8pquvz6
本文来自作者投稿，版权归原作者所有。如需转载，请注明出处：https://www.nxrte.com/jishu/58024.html
