// 01 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 交互包括以下步骤：
用户输入请求：客户端向智能体发送用户输入（如查找内容）。
智能体生成 A2UI 消息：智能体根据请求生成声明式 UI 组件 JSON 描述。
客户端逐步渲染界面：客户端读取 JSON 流并实时渲染界面组件（如按钮、表格等）。
用户互动反馈：用户点击或提交表单，触发事件传回智能体。
智能体响应变化：智能体根据交互重新生成 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
