学习 A2UI 有感

A2UI 是什么？

A2UI（ Agent to UI ）是一种用于代理驱动界面的声明式用户界面协议。 人工智能代理能够生成丰富的交互式用户界面，这些用户界面可以原生渲染于各种平台（ Web 、移动设备、桌面设备），而无需执行任意代码。

概念简要

渐进式渲染

传统方案一般都需要渲染代码接收完毕才能开始渲染 UI ，但 A2UI 可以做到动态渲染 UI

使用 jsonl 格式作为结构化输出语言，配合状态化流式解析 json 库，达到 UI 分段渲染的效果。

声明式组件

用户界面以数据的形式描述，而不是以代码的形式编写

渲染完全依赖前端，可以直接使用自己的组件完成对应数据的渲染。

数据绑定

UI 结构与应用程序状态分离，从而实现响应式更新

组件支持数据绑定。

对比

传统方法：

• LLM 必须一次性生成完美的嵌套结构。
• 难以更新深层嵌套的组件
• 难以进行增量流式传输

A2UI

• 扁平结构，便于 LLM 生成
• 逐步发送组件
• 单条指令更新任何组件
• 结构与数据的清晰分离

消息类型

服务端到客户端

• surfaceUpdate：定义或更新 UI 组件
• dataModelUpdate：更新应用程序状态
• beginRendering：向客户端发出渲染信号
• deleteSurface：移除 UI 表面

客户端到服务端

• aciton : 用户交互行为消息
• dataModelChanged : 更新服务器数据（通常发生在 watchDataModel 为特定路径启用了 onChanged 模式，或者用户操作触发了设置为 onAction 模式的路径的更新时）

示例

餐厅预定

用户： “请预订明天晚上 7 点的两人桌”

1. Agent 定义用户界面结构：

{"surfaceUpdate": {"surfaceId": "booking", "components": [ {"id": "root", "component": {"Column": {"children": {"explicitList": ["header", "guests-field", "submit-btn"]}}}}, {"id": "header", "component": {"Text": {"text": {"literalString": "Confirm Reservation"}, "usageHint": "h1"}}}, {"id": "guests-field", "component": {"TextField": {"label": {"literalString": "Guests"}, "text": {"path": "/reservation/guests"}}}}, {"id": "submit-btn", "component": {"Button": {"child": "submit-text", "action": {"name": "confirm", "context": [{"key": "details", "value": {"path": "/reservation"}}]}}}} ]}} 

1. Agent 发出填充数据：

{"dataModelUpdate": {"surfaceId": "booking", "path": "/reservation", "contents": [ {"key": "datetime", "valueString": "2025-12-16T19:00:00Z"}, {"key": "guests", "valueString": "2"} ]}} 

1. Agent 发出渲染信号：

{"beginRendering": {"surfaceId": "booking", "root": "root"}} 

用户将客人数量修改为“3” → 客户端自动更新 /reservation/guests （尚未向 Agent 发送消息）

1. 用户点击“确认” → 客户端发送包含更新数据的操作：

{"userAction": {"name": "confirm", "surfaceId": "booking", "context": {"details": {"datetime": "2025-12-16T19:00:00Z", "guests": "3"}}}} 

1. Agent 发出清理 UI 信号

{"deleteSurface": {"surfaceId": "booking"}} 

设想/猜测

“下一代 APP/Web”

无固定 UI 布局，全靠交互规则、组件及文档、数据、用户状态来动态驱动，UI 构建全部依赖模型。

服务端的 API 也可能会迎来翻天覆地的变化，感觉传统 API 是不利好 AI 的。