A2UI翻译站点

什么是 A2UI

A2UI（Agent-to-User Interface）是一种 面向 AI 智能体与用户界面之间交互的新型协议，通过声明式 JSON 格式让 AI 智能体描述用户界面（UI）内容，而客户端负责渲染本地组件，实现真正安全、跨平台的富交互 UI。传统的 AI 输出仅限文本、语音或代码，而 A2UI 则使智能体能够以 结构化、可交互的形式向用户展示界面组件（如按钮、表单、图表等），无需执行任意代码，这解决了智能体与应用之间长期存在的“只能聊天、不能交互”的痛点。 a2ui.org

A2UI 当前仍处于 Public Preview 早期阶段（v0.8），采用 Apache 2.0 开源许可，并获得社区贡献者的支持（如 CopilotKit等）。a2ui.org

A2UI 的设计理念与核心价值

安全优先：声明式而非可执行代码

在设计 A2UI 协议时，核心考虑之一是安全性。与传统的 UI 生成方式不同，A2UI 不允许智能体输出包含执行逻辑的代码（如运行任意脚本），而是通过 声明式 JSON 描述界面结构和状态。这样可以防止智能体生成恶意代码，从而避免潜在的 UI 注入攻击和安全风险。atoui.org

声明式 JSON 格式让开发者能够使用预定义组件目录（如 Card、Button、TextField 等）来渲染界面，并通过安全、受控的 UI 元素池提供丰富的交互体验。atoui.org

适用于大模型生成：与 LLM 友好

A2UI 的协议结构对大语言模型（LLM）非常友好，其 扁平的、基于流式 JSONL（JSON Lines）/ JSON 格式可使智能体逐步生成界面组件，而不必在单次输出中构建完整的复杂 UI。这样的设计提升了生成效率和可解释性，同时支持渐进式渲染。atoui.org

相比传统方法，这种协议使得 UI 不是代码片段，而是由 LLM 输出的数据结构，从而与智能体自然语言生成能力无缝结合。atoui.org

跨平台与框架无关的渲染

A2UI 是 框架无关（framework-agnostic） 的协议。智能体输出的 JSON 描述并不绑定具体前端技术栈，这意味着相同的 A2UI 输出可以在 React、Angular、Flutter、Lit、SwiftUI 等平台上用各自本地组件渲染，从而实现跨平台一致性。a2ui.org

这种架构的好处在于：

• 客户端保持风格一致性和品牌控制权

• 智能体只需关注界面逻辑与结构，而不涉足具体渲染实现

• 开发者可快速集成至现有前端项目，无需重构整体 UI 体系 a2ui.org

渐进式渲染与实时交互体验

A2UI 还支持 渐进式 UI 渲染（progressive rendering），即在智能体输出界面描述流的同时，客户端可以立即解析并显示部分内容，而不必等待完整输出。这能显著提升用户交互体验，尤其是在生成大型、复杂界面时。atoui.org

A2UI 协议的工作机制

JSON 消息流与协议层结构

A2UI 的交互模式基于 流式 JSON 消息。智能体通过消息流逐步发送界面组件定义，每个消息都可描述界面的某个部分（如创建表单、更新列表等）。这种设计允许客户端在接收过程中即时渲染，提高响应速度和用户感知性能。a2ui.org

协议规范定义了以下几种主要消息类型：

• beginRendering: 初始化渲染环境

• surfaceUpdate: 更新或添加 UI 组件

• dataModelUpdate: 修改界面绑定数据

• deleteSurface: 删除特定界面区域 a2ui.org

这种消息分离了界面结构和状态数据的概念，在 UI 更新时只需发送变化部分，从而提升性能。a2ui.org

渐进界面构建：从代理到客户端

典型的 A2UI 交互包括以下步骤：

1. 用户输入请求：客户端向智能体发送用户输入（如查找内容）。

2. 智能体生成 A2UI 消息：智能体根据请求生成声明式 UI 组件 JSON 描述。

3. 客户端逐步渲染界面：客户端读取 JSON 流并实时渲染界面组件（如按钮、表格等）。

4. 用户互动反馈：用户点击或提交表单，触发事件传回智能体。

5. 智能体响应变化：智能体根据交互重新生成 UI 消息并发送 —— 实现动态界面更新。 a2ui.org

这种模型使得智能体输出界面更加灵活、可交互，并促进 UI 与 AI 双向通信。atoui.org

A2UI 的核心功能与优势

安全与声明式设计

A2UI 不是可执行代码，而是 纯粹的数据描述格式。客户端负责渲染界面，避免了智能体在客户端执行不受信任的代码，从而大幅降低了 UI 注入攻击等安全风险。atoui.org

这是当前复杂 AI 应用中非常重要的考量，尤其是在面向业务生产系统的场景里。atoui.org

可扩展与开源

A2UI 本身采取 Apache 2.0 许可证开源，可被社区自由使用、修改和扩展。协议核心规范和各种实现（如针对 Angular、Flutter 的渲染器）都在官方文档和社区仓库中发布。a2ui.org

开发者可根据自身项目需求扩展组件目录，并定义自己的 UI 样式体系。a2ui.org

面向多角色的实用性

A2UI 的目标受众主要包括以下三类：

• 宿主应用开发者（Frontend）：构建多代理平台、企业助手或跨平台应用，并为智能体生成 UI 渲染层。a2ui.org

• 代理开发者（Backend/AI）：设计智能体，使其输出 A2UI 格式的 UI 组件 JSON，用于表单、仪表板等界面交互。a2ui.org

• 平台构建者（SDK/框架 作者）：构建支持 A2UI 的 SDK，以便各种客户端应用使用同一协议渲染 UI。a2ui.org

这意味着 A2UI 不仅仅是一个协议，它还是构建智能代理 UI 生态的一部分。a2ui.org

A2UI 的应用场景

交互式智能代理

在 AI 驱动的智能助手中，A2UI 能让用户不再被文本交互所限制，而是生成丰富表单、可视化组件、数据列表等 UI 界面，使 AI 更像一个可操作的应用。ai-bot.cn

例如，在聊天界面中，智能体可以直接展示一个带有按钮和输入框的表单，而不是让用户通过文本反复确认。ai-bot.cn

复杂任务与业务工作流

在流程自动化和业务系统中，A2UI 允许智能体生成任务指引界面，如数据筛选、确认对话框、结果表格等，从而提升效率，减少重复手工操作。ai-bot.cn

跨设备、跨平台应用

无论是在 Web、移动还是桌面应用上，A2UI 输出皆可与各自原生组件渲染机制集成，使得构建统一体验的智能代理应用成为可能。a2ui.org

如何开始使用 A2UI

集成客户端渲染器

开发者可以选择与应用匹配的渲染器，例如：

• Web：Lit、Angular

• Mobile/Desktop：FlutterGenUI SDK

• React：（计划于 2026 年推出） a2ui.org

安装相应渲染器，并连接到智能体消息流，就可开始构建代理驱动的界面。a2ui.org

常见问题（FAQ）

Q1: 什么是 A2UI？
A1: A2UI 是一种开源的声明式 UI 协议，让 AI 智能体通过结构化 JSON 描述生成交互式用户界面，解决传统文本或语音交互的限制。a2ui.org

Q2: A2UI 安全性如何？
A2: A2UI 采用声明式数据格式，而不是可执行代码，因此智能体无法注入任意客户端代码，从而提高安全性。atoui.org

Q3: 它适合哪些人使用？
A3: A2UI 主要面向宿主应用前端开发者、智能体后端开发者和平台/框架构建者。a2ui.org

Q4: A2UI 如何与现有 UI 框架集成？
A4: 通过使用提供的渲染器（如 Angular、FlutterGenUI 等），开发者可将 A2UI 输出的 JSON 转换为本地组件。a2ui.org

Q5: 是否支持多个平台？
A5: 是的，A2UI 设计为框架无关，因此输出可跨平台集成到 Web、移动和桌面应用。a2ui.org

Q6: 什么时候 A2UI 会全面稳定发布？
A6: 当前稳定版本为 v0.8，仍在迭代中，预计后续版本将进一步完善 API 和工具生态。a2ui.org

结语

A2UI 代表了 AI 与用户界面交互的新范式，通过开放协议使大语言模型不仅能生成文本和代码，还能“说 UI”，即以声明式结构描述动态、交互式界面，为智能代理和下一代应用开发打开全新路径。无论是智能助手、业务流程自动化，还是跨设备应用，A2UI 都提供了一个高效、安全、跨平台的方案。a2ui.org