Google 产品中的 A2UI
产品支持速度与协议演进速度不同。建设集成前必须核对宿主 Renderer 版本、注册路径和预览条款。

支持矩阵
| 产品 | 已核验角色 | 重要限制 |
|---|---|---|
| Gemini Enterprise | 为注册 A2A Agent 提供内置原生 Renderer | 当前文档说明仅支持 v0.8;托管 ADK 注册路径不等同于 A2A 的 A2UI 路径 |
| Google Chat | 使用 ADK 与 Vertex AI Agent Engine 的 Workspace Add-on 快速入门 | Early Stage Public Preview |
| ADK Web | 能够渲染 A2UI Agent Part 的开发者 UI | 当前文档集成基于 v0.8 Basic Catalog |
| Opal | 以 A2UI 驱动 AI Mini-app 动态界面 | 产品抽象高于公开 Wire Protocol |
| Flutter GenUI | 底层使用 A2UI 的跨平台原生 Renderer | 应用负责 Transport,必须核对 Package 与协议兼容性 |
Gemini Enterprise
Gemini Enterprise 会把自身支持的 Catalog 发给 A2A Agent,校验返回的 A2UI,并使用宿主设计系统渲染。生产关键是版本协商:宿主只声明 v0.8 时不能发送 v0.9.1 消息。
只展示用户有权限执行的操作。删除、支付等高影响动作应在生成 Surface 之外二次确认,敏感凭证不能进入 A2UI Data Model。
Google Chat
官方 Quickstart 把 Chat App 连接到部署在 Vertex AI Agent Engine 的 ADK Agent,可作为异步进度、工具数据和自适应卡片的部署参考。由于仍处预览阶段,应锁定依赖并保留文本或普通卡片降级路径。
实施清单
- 记录宿主声明的准确 Renderer 版本。
- 生成 UI 前协商 A2UI 与 Transport 能力。
- 对发送给模型的 Catalog 和示例进行版本管理。
- 保留文本降级与错误恢复路径。
- 在真实宿主中测试键盘、读屏、小屏、慢网和不支持组件的行为。