AG-UI 解读:让前端不必为每个 AI Agent 框架重写一次

开源协议 AG-UI 尝试用类型化事件流连接 AI Agent 与前端应用,减少不同框架带来的重复适配成本。

分类:AI编程

从聊天框到复杂 Agent,前端需要新的接口层

掘金“一天一个开源项目”第 262 篇介绍了 ag-ui-protocol 下的 AG-UI。该项目关注的是 AI Agent 进入前端应用时的对接问题。相比传统聊天界面的一次请求、一次响应,Agent 的运行过程要复杂得多:文字可能逐字流式输出,过程中调用工具,更新共享状态,等待用户确认,甚至调度子 Agent。

如果缺少统一约定,这些能力往往由不同 Agent 框架各自实现,前端需要为每一种框架编写适配逻辑;一旦更换框架,界面层也要重写。AG-UI 的思路是把这一层标准化:Agent 输出类型化事件流,客户端按照统一约定渲染。这样,同一个 Agent 可以接入网页、手机应用、终端,甚至 Slack,而不必重新对接前端。

AG-UI 是什么:开放事件协议,而不是界面描述规范

根据 README,AG-UI 是一个开放、轻量、基于事件的协议,用于把 AI Agent 与面向用户的应用连接起来。项目采用 MIT 协议,由 CopilotKit 创建,并与社区公开开发。当前版本为 AG-UI 1.0,README 称其为稳定、冻结的规范,背后有 JSON Schema 支撑,并保持双向向后兼容:0.x 的 Agent 可以配 1.0 的客户端,反过来也可以。

素材特别区分了 AG-UI 与 A2UI、MCP Apps、Open-JSON-UI 的关系。后者被视为生成式 UI 的规格,描述 Agent 想展示什么界面;AG-UI 则是运行时协议,负责在 Agent 和应用之间传输这些内容以及其他事件。用更直白的话说,前者回答“说什么”,AG-UI 回答“怎么传”。

README 还把 AG-UI 放进与 MCP、A2A 并列的组合中。三者被描述为互补:一个 Agent 可能同时使用三者,AG-UI 也可以放在涉及 MCP 或 A2A 的 Agent 前面。

31 种事件、状态同步与人工介入

AG-UI 的核心模型围绕事件展开。README 称,AG-UI 1.0 定义了 31 种事件,分为八个族。掘金文章还核对到,除 REASONING_MESSAGE_* 这类通配写法外,表格列出了 27 个事件名;若按通配展开,总数对应 31。

一次典型运行可能由多个事件组成。例如,Agent 回答问题并中途调用工具时,事件顺序可能从 RUN_STARTED 开始,经过 TEXT_MESSAGE_START、TEXT_MESSAGE_CONTENT、TEXT_MESSAGE_END,再进入 TOOL_CALL_START、TOOL_CALL_ARGS、TOOL_CALL_END、TOOL_CALL_RESULT,最后继续输出文本并以 RUN_FINISHED 结束。前端不需要知道后端使用 LangGraph 还是 CrewAI,只要能识别这些事件,就可以把文字逐字显示、把工具调用展示为卡片,并同步状态变化。

  • 共享状态:STATE_SNAPSHOT 提供完整状态,STATE_DELTA 只发送变化部分,格式为 JSON Patch。
  • 人工介入:一次运行可以以 interrupt 结局结束,用户批准、修改或拒绝后,再发起下一次运行继续流程。
  • 传输绑定:规范定义了 HTTP 加 SSE,以及 HTTP 加 Protobuf 两种绑定;README 也提到可通过中间件适配其他事件来源,但规范绑定只列出 SSE 和 Protobuf。

开发者如何上手,以及它对行业的意义

素材给出的上手路径比较直接:可以先查看 Dojo 演示站,了解不同能力的展示方式;再阅读规范中的事件定义。动手时,可以用 npx create-ag-ui-app@latest 生成脚手架,也可以按 README 启动一个最小 Python FastAPI 服务端,再用 TypeScript 客户端连接。TypeScript 客户端需要 Node.js 20+。服务端接收 RunAgentInput,通过 EventEncoder 和 StreamingResponse 输出事件;客户端使用 HttpAgent,通过 onRunStartedEvent、onTextMessageContentEvent 等回调接收事件。

项目还提到,官方 SDK 由规范生成,社区 SDK 覆盖 Kotlin、Go、Java、Dart、Rust、Ruby、C++、Swift。README 称,AG-UI 被 Google、Microsoft、Amazon、Oracle 等采用,并内置在大多数 Agent 框架里;仓库 integrations 目录中也能看到 langgraph、crew-ai、mastra、microsoft-agent-framework、openai-agents、claude-agent-sdk、vercel-ai-sdk 等子目录。不过,素材作者也提醒,具体集成完成度仍需查看对应文档。

对 AI 应用开发而言,AG-UI 的意义在于把前端适配层从具体 Agent 框架中拆开。当输出、工具调用、状态变更和用户中断都能以统一事件流表达时,前端组件更有机会复用,框架切换成本也可能下降。对开发者而言,理解这些事件如何在一次运行中流动,是判断该协议是否适合自己场景的第一步。

原创文章,作者:点点,如若转载,请注明出处:https://www.dian8dian.com/agui-jie-du-rang-qian-duan-bu-bi-wei-mei-ge-ai-agent-kuang

Like (0)
点点的头像点点
Previous 1天前
Next 1天前

相关推荐