用途:帮助生成符合 A2UI(Agent to UI)协议 v0.8 的代码,用于构建 AI 代理可流式推送到客户端的富交互界面。标准目录 ID 为 https://github.com/google/A2UI/blob/main/specification/0.8/json/standard_catalog_definition.json。
主要能力:使用四类 JSONL 消息——surfaceUpdate(定义/更新组件)、dataModelUpdate(填充/更新状态)、beginRendering(触发渲染)、deleteSurface(移除界面)。组件采用邻接表模型,用扁平列表加 ID 引用而非嵌套树。数据绑定(BoundValue)支持三种模式:仅 literalString 静态值、仅 path 动态绑定、两者同时提供作为初始化简写。beginRendering 中可通过 styles 配置 font、primaryColor(#RRGGBB)等样式。标准目录组件分布局(Row、Column、List、Card、Tabs、Modal、Divider)、展示(Text、Image、Icon、Video、AudioPlayer)、输入(Button、TextField、CheckBox、DateTimeInput、MultipleChoice、Slider);Row/Column 内可用 weight 做弹性布局。
使用方式:先 surfaceUpdate 定义组件,再 dataModelUpdate 填充数据,最后 beginRendering 触发渲染。用户交互时客户端发送 userAction(含 name、surfaceId、sourceComponentId、timestamp、context),错误通过 error 消息上报。最佳实践包括组件 ID 唯一、保持扁平结构、分离 UI 结构与动态值、path 使用 JSON Pointer 格式、在必要组件定义后发送 beginRendering、流程结束时用 deleteSurface 清理。
适用场景:代理驱动的表单、列表、弹窗及多界面区域、流式渐进渲染等。限制:目标为 A2UI 协议 v0.8;其余收费、价格、平台等暂未提供。