logo
积分中心
端 A2A 接入不是重新开发 Agent:用 AgentExtensionAbility 连接小艺
头像 程序员小葵 2026-11-10 17:08:14    发布
0 浏览 0 收藏

如果一个 APP 已经拥有自己的端侧智能体,开发者可能希望用户不仅能在 APP 内使用它,也能通过小艺调用它。

这时,可以研究小艺开放平台的端 A2A 接入方案。

官方文档明确指出,端 A2A 的目标之一,是让开发者复用已有 HarmonyOS APP 内的 Agent 能力,而不需要重写已有 Agent。其核心是增加一层接入适配。

端 A2A 需要哪些工程文件?

根据官方接入指导,端 A2A 的关键部分包括:

  1. AgentExtensionAbility:负责与小艺进行 A2A 协议通信。
  2. agent_config.json:声明 Agent 的能力、技能和元信息。
  3. module.json5:注册 AgentExtensionAbility,并通过 metadata 关联配置文件。

其中,AgentExtensionAbility 是必需的;如果需要以自定义卡片形式展示结果,还可以按需实现 AgentUIExtensionAbility。

先创建 AgentExtensionAbility

在 DevEco Studio 中,可以通过:

New → Extension Ability → Agent

创建 Agent 扩展组件。IDE 会自动生成对应工程文件。

在代码层面,AgentExtensionAbility 是一个扩展组件,负责处理服务创建、销毁、连接、断开以及数据通信等生命周期。

官方 API 从 API version 24 开始支持,并且仅适用于 Stage 模型。

agent_config.json 是 Agent 的能力名片

AgentCard 用来描述 Agent 能做什么。系统通过配置文件识别 Agent 的能力,再决定如何进行路由。

因此,配置文件不能只写一个名称。

开发者需要根据实际业务描述 Agent 的能力、技能、元信息等,并确保配置与真实实现保持一致。

不要让接入层替代业务层

推荐的工程结构是:

小艺

|

v

AgentExtensionAbility

|

v

A2A协议适配层

|

v

APP已有Agent

|

v

应用业务服务

A2A 适配层负责协议接入,原有 Agent 负责任务处理,业务服务负责真正的数据读取和业务执行。

这样做可以避免把所有逻辑都塞进 ExtensionAbility,降低后期维护成本。

接入前需要确认版本和设备

官方端 A2A 快速接入指导要求应用已有可供用户交互的 Agent,并说明手机侧运行和测试需要满足相应 API 版本要求。API 24 和 API 26 的创建方式存在差异。

技术价值: 对已经有端侧智能体的 APP 来说,端 A2A 是值得研究的能力开放路径。开发者需要重点理解 AgentExtensionAbility、AgentCard 和原有 Agent 之间的职责边界。


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

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255