用途
A2UI(Agent-to-User Interface)是 Google 开源的协议,使 AI 智能体能够通过声明式 JSON 而非可执行代码生成丰富、可交互的用户界面。它解决多智能体系统在跨信任边界时安全传输 UI 的核心问题:智能体使用一组预先批准的扁平组件描述 UI 意图,客户端在 Web、移动端和桌面端原生渲染。该格式针对 LLM 生成做了优化,支持流式输出、增量更新,并且渲染方式与具体框架无关。
本技能在以下情况下触发:用户想构建生成 A2UI JSON 响应的智能体;需要为 A2UI 搭建客户端渲染器(Lit、React、Angular、Flutter);正在处理 A2UI 消息类型(surfaceUpdate、createSurface 等);想创建或定制 A2UI 组件目录;需要实现组件与数据模型之间的数据绑定;正在将 A2UI 与 A2A 协议或 AG UI 传输集成;想处理客户端到服务端的动作(按钮点击、表单提交);正在构建自定义组件或扩展基础目录。不适用于与智能体生成界面无关的一般 UI 框架问题,以及不涉及 UI 渲染的 A2A 协议问题。
主要能力
- 覆盖 A2UI 两个规范版本:v0.8(稳定版,使用 surfaceUpdate/dataModelUpdate/beginRendering、嵌套组件语法、literalString 包装)与 v0.9(草案版,使用 createSurface/updateComponents/updateDataModel、扁平组件语法、直接字符串、必须提供 catalogId)。
- 邻接表模型:使用带 ID 引用的扁平组件列表而非嵌套树,便于 LLM 增量生成并支持渐进渲染。每个组件包含 id、type 和属性。
- 表面(Surface):以 surfaceId 标识的 UI 容器,组件与数据模型按表面划分作用域,一个表面在其生命周期内锁定到一个目录。
- 数据绑定:组件通过 JSON Pointer 路径(RFC 6901)连接应用状态,数据模型与 UI 结构分离以支持响应式更新;输入组件(TextField、CheckBox)支持双向绑定。
- 目录(Catalogs):用 JSON Schema 文件定义智能体可使用的组件、函数和主题;基础目录提供标准组件,生产应用可定义匹配自身设计系统的自定义目录。
- 支持用模板与 dataBinding 渲染动态列表,模板内路径作用于每个数组项。
- 支持客户端到服务端动作,按钮可携带来自数据模型的上下文派发事件,并可通过检查条件自动禁用按钮。
- 提供 Lit 渲染器集成示例、自定义目录构建工具、错误处理与常见陷阱说明。
使用方式
环境变量:GEMINI_API_KEY=your-gemini-api-key
智能体侧安装(Python 与 Google ADK):
pip install google-adk
adk create my_agent
客户端安装:
# Lit(Web Components)
npm install @a2ui/web-lib lit @lit-labs/signals
# React
npm install @a2ui/react @a2ui/web-lib
# Angular
npm install @a2ui/angular @a2ui/web-lib
# Flutter
flutter pub add flutter_genui
快速开始(完整演示):
git clone https://github.com/google/a2ui.git
cd a2ui
export GEMINI_API_KEY="your_key"
cd samples/client/lit
npm install
npm run demo:all
技能激活时首次响应以 🧢 表情开头。技能附带 references/ 目录,包含 components.md(组件完整参考)、messages.md(v0.8 与 v0.9 消息格式)、catalogs-and-actions.md(目录架构、协商与客户端到服务端动作)、renderer-guide.md(自定义渲染器实现清单),仅在任务需要时加载以节省上下文。首次激活还会检查已安装的伴随技能,与 frontmatter 中 recommended_skills 比对,缺失时提示安装:npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>。
适用场景
适用于构建由智能体动态生成界面的应用、需要在不可信智能体与客户端之间安全传递 UI 的多智能体系统、以及需要跨 Web/移动/桌面框架统一渲染的方案。
限制
v0.8 与 v0.9 语法互不兼容,混用会在多数渲染器上静默失败;v0.8 必须在接收 beginRendering 后才渲染;表面创建后目录不可更改;JSON Pointer 路径必须先在数据模型中存在;子组件只能以字符串 ID 引用。具体功能、收费与效果以官方资料为准,本技能资料未提供相关价格信息。