程序员小葵
2026-11-10 17:08:14 发布如果一个 APP 已经拥有自己的端侧智能体,开发者可能希望用户不仅能在 APP 内使用它,也能通过小艺调用它。
这时,可以研究小艺开放平台的端 A2A 接入方案。
官方文档明确指出,端 A2A 的目标之一,是让开发者复用已有 HarmonyOS APP 内的 Agent 能力,而不需要重写已有 Agent。其核心是增加一层接入适配。
端 A2A 需要哪些工程文件?
根据官方接入指导,端 A2A 的关键部分包括:
- AgentExtensionAbility:负责与小艺进行 A2A 协议通信。
- agent_config.json:声明 Agent 的能力、技能和元信息。
- 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 之间的职责边界。
相关推荐
33
0
28
0
程序人生下半场
0
0
22
0
程序员小葵
我还没有写个人简介......
帖子
提问
粉丝
端 A2A 接入不是重新开发 Agent:用 AgentExtensionAbility 连接小艺
2026-11-10 17:08:14 发布让 Agent 不只返回文字:AgentUIExtensionAbility 自定义卡片展示实践
2026-11-10 17:06:18 发布


京公网安备:11010502051901号