程序员小葵
2026-11-10 17:06:18 发布把智能体结果变成可交互的应用服务卡片,提升小艺场景下的任务完成体验
如果智能体每次都只返回一段文字,很多业务场景的体验其实并不理想。
例如,旅行 APP 的智能体完成景点推荐后,用户希望看到景点图片、位置和操作入口;音乐 APP 的智能体推荐歌曲后,用户可能希望直接看到播放卡片。
这时,开发者可以研究端 A2A 接入中的 AgentUIExtensionAbility。
官方文档明确说明,AgentExtensionAbility 负责 A2A 协议通信;AgentUIExtensionAbility 则用于向小艺返回自定义 UI 卡片内容,仅在需要卡片展示时按需实现。
先区分通信组件和 UI 组件
两者的职责不同:
| 组件 | 主要职责 |
| AgentExtensionAbility | 接收小艺发来的消息,处理 A2A 协议通信 |
| AgentUIExtensionAbility | 为智能体结果提供自定义 UI 卡片 |
这意味着开发者不应该把业务请求处理和卡片 UI 构建混在一个组件里。
设计一个旅行推荐卡片
假设旅行 Agent 返回三个景点,可以先定义业务数据:
interface Attraction {
id: string;
name: string;
description: string;
address: string;
}
Agent 处理完成后,得到结构化的景点信息,再由 UI 组件根据官方支持的卡片机制进行展示。
需要注意,这里的 Attraction 是应用自定义业务类型,不是 AgentUIExtensionAbility 的官方返回协议。
卡片不只是展示结果
卡片可以围绕用户下一步操作设计。
例如:
- 查看景点详情。
- 添加到行程。
- 查看路线。
- 收藏景点。
但这些交互操作必须对应应用真实存在的业务能力,不能只在卡片上放一个按钮,却没有对应的业务处理逻辑。
设计卡片时注意状态
推荐结果可能会发生变化。
例如,用户调整出行日期后,原有推荐可能不再适用。因此,卡片需要明确数据更新时间和任务状态,避免展示过期内容。
对于涉及预订、支付等操作,卡片也应展示明确的确认信息,不能直接将推荐结果变成不可逆的业务操作。
真机验证交互体验
开发者需要在真实设备上验证卡片的呈现效果、交互响应、内容过长时的布局、加载失败和任务取消等场景。
技术价值: AgentUIExtensionAbility 让应用智能体的输出有机会从纯文本走向结构化交互。对内容、旅游、电商和服务类 APP 来说,这意味着智能体不只是回答问题,还可以把业务结果以更适合用户操作的形式呈现出来。
相关推荐
33
0
22
0
15
0
程序员小葵
我还没有写个人简介......
帖子
提问
粉丝
端 A2A 接入不是重新开发 Agent:用 AgentExtensionAbility 连接小艺
2026-11-10 17:08:14 发布让 Agent 不只返回文字:AgentUIExtensionAbility 自定义卡片展示实践
2026-11-10 17:06:18 发布


京公网安备:11010502051901号