A2UI 概念总览

宏观图景

A2UI 围绕三个核心理念构建：

1. 流式消息：UI 更新作为从 Agent 到客户端的 JSON 消息序列流动。
2. 声明式组件：UI 被描述为数据，而不是被编程为代码。
3. 数据绑定：UI 结构与应用状态分离，支持响应式更新。

关键主题

数据流

消息如何从 Agent 传输到渲染的 UI。包括餐厅预订流程的完整生命周期示例、传输选项（SSE, WebSockets, A2A）、渐进式渲染和错误处理。

组件结构

A2UI 用于表示组件层级的邻接表模型。了解为什么对于生成式 UI 平面列表优于嵌套树，如何使用静态与动态子级，以及增量更新的最佳实践。

数据绑定

组件如何使用 JSON 指针 路径连接到应用状态。涵盖响应式组件、动态列表、输入绑定以及使 A2UI 强大的结构与状态分离。

消息类型

A2UI v0.9.1 使用四种服务端到客户端生命周期消息：

• createSurface：创建 Surface 并选择 Catalog
• updateComponents：定义或替换组件
• updateDataModel：设置或删除数据模型值
• deleteSurface：移除 UI Surface

有关完整的详细技术信息，请参阅消息参考。

准备开始？

理解了概念后，深入实际实现：