核心概念¶
本节解释 A2UI 的基本架构。理解这些概念将帮助你构建有效的智能体驱动界面。
全局视图¶
A2UI 围绕三个核心思想构建:
- 流式消息:UI 更新作为 JSON 消息序列从智能体流向客户端
- 声明式组件:UI 被描述为数据,而不是编程为代码
- 数据绑定:UI 结构与应用状态分离,支持响应式更新
关键主题¶
数据流¶
消息如何从智能体传递到渲染的 UI。包括餐厅预订流程的完整生命周期示例、传输选项(SSE、WebSockets、A2A)、渐进式渲染和错误处理。
组件结构¶
A2UI 的邻接列表模型用于表示组件层次结构。了解为什么扁平列表优于嵌套树、如何使用静态与动态子元素以及增量更新的最佳实践。
数据绑定¶
组件如何使用 JSON Pointer 路径连接到应用状态。涵盖响应式组件、动态列表、输入绑定以及使 A2UI 强大的结构与状态分离。
消息类型¶
A2UI 使用四种消息类型:
surfaceUpdate:定义或更新 UI 组件dataModelUpdate:更新应用状态beginRendering:向客户端发出渲染信号deleteSurface:移除 UI 界面
有关完整的技术细节,请参见消息参考。