logo
积分中心
让 Agent 不只返回文字:AgentUIExtensionAbility 自定义卡片展示实践
头像 程序员小葵 2026-11-10 17:06:18    发布
0 浏览 0 收藏

把智能体结果变成可交互的应用服务卡片,提升小艺场景下的任务完成体验

如果智能体每次都只返回一段文字,很多业务场景的体验其实并不理想。

例如,旅行 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 来说,这意味着智能体不只是回答问题,还可以把业务结果以更适合用户操作的形式呈现出来。


©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS
地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255