SuperAPI AI 工具集

a2ui

智能体与模型

查看项目

更新于 10-16 09:31

技能介绍

用途:该技能帮助生成符合 A2UI(Agent to UI)协议 0.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 中配置 font 与 primaryColor。标准目录含 16 个组件:布局类 Row、Column、List、Card、Tabs、Modal、Divider;展示类 Text(支持简单 Markdown)、Image、Icon、Video、AudioPlayer;输入类 Button、TextField、CheckBox、DateTimeInput、MultipleChoice、Slider。Row/Column 内可用 weight 做弹性布局。

使用方式:基本流程为先 surfaceUpdate 定义组件,再 dataModelUpdate 填充数据,最后 beginRendering 触发渲染。用户交互时客户端发送 userAction(含 name、surfaceId、sourceComponentId、timestamp、context);错误通过 error 消息上报。

适用场景:构建表单、列表、模态框、预约等由智能体驱动的界面,支持多 surface 与渐进式渲染。

限制与建议:组件 ID 需在 surface 内唯一;用 JSON Pointer 格式路径;UI 结构与动态值分离;流程结束用 deleteSurface 清理。具体 API 集成、目录协商等细节暂未提供。