跳到主要内容
返回时间线
ag-ui-protocol/ag-ui来源发表:

AG-UI 1.0 冻结规范:智能体与界面的连接改由一条双向事件流承担

核心概要

AG-UI 发布 1.0 版本,把 AI 智能体与用户界面之间的连接固定为一条双向事件流:智能体发出带类型的事件,任何客户端都能渲染,不必再为每个框架单独接线。此前智能体并不符合请求/响应模型,它们边流式输出、边调用工具、更新共享状态、暂停等待人工,各家框架做法互不相同。1.0 的规范已冻结并由 JSON Schema 支撑,TypeScript、Python 和 .NET 三个 SDK 由该 Schema 生成,且与 0.x 双向兼容。

Source-provided article image: ag-ui-protocol / ag-ui
GitHub Trending

深度剖析

智能体与前端应用之间的连接现在由一份开放、轻量、基于事件的协议统一描述,同一智能体可以驱动网页应用、移动应用、终端或 Slack。 智能体不符合请求/响应模型:它们流式输出词元、在回复中途调用工具、更新共享状态、暂停等待人工、派生下级智能体,而每个框架的实现方式都不一样。 AG-UI 用一条双向事件流取代这些定制接线,智能体发出带类型的事件,任何客户端都能渲染,不论智能体由哪个框架构建。

协议以一条 HTTP 端点承载一次运行:端点接收 RunAgentInput,并以流的形式回传事件。 事件编码器按请求头中的 accept 选择内容类型,运行开始、文本消息开始、文本内容、文本消息结束、运行结束等事件依次编码后写入流式响应。 示例中一个约 30 行的 Python 智能体服务端配合 TypeScript 客户端,客户端打印出流式返回的 Hello from AG-UI!;把服务端换成任何受支持的框架,客户端无需改动。

1.0 的规范已冻结,并由 JSON Schema 支撑,TypeScript、Python 和 .NET 三个 SDK 由该 Schema 生成。 1.0 在两个方向上保持向后兼容:0.x 的智能体可与 1.0 的客户端配合,反之亦然。 命令行工具 create-ag-ui-app 可搭建前端,前端采用 Next.js 上的 CopilotKit 或终端客户端,并接到所选智能体框架;生成的模板调用 OpenAI,运行前需设置密钥。

启示与展望

已展示的范围是协议规范本身、由 JSON Schema 生成的 TypeScript、Python 与 .NET SDK、双向兼容声明,以及一个约 30 行的 Python 服务端加 TypeScript 客户端的最小示例。

材料称 AG-UI 已被 Google、Microsoft、Amazon 和 Oracle 采用,并内置于多数智能体框架,但所列框架清单在材料中未完整给出;双向兼容与 SDK 生成均以发布方声明形式出现,材料未给出对应的兼容性测试结果。