HarmonyOS 鸿蒙Next中智能体+端插件，通过语音指令，唤起元服务方案

HarmonyOS 鸿蒙Next中智能体+端插件，通过语音指令，唤起元服务方案 当前配置情况：1，我在AGC的元服务项目中配置了元服务链接

2、在小艺开放平台中，创建了一个智能体，该智能体关联此元服务。

在智能体中添加了一个自定义的端插件，该端插件前台执行，但是我在配置applink方式的时候，系统提示cke_7362.png。

使用标准实现和deeplink，也无法实现拉起。

3、我的端插件工具已经上架，智能体是使用真机测试进行的。元服务通过DevEco Studio的debug安装在手机中。在小艺中，我找到了我的智能体（开发中状态的），发起指令后，回复已执行，但是没有拉起元服务。

还有什么地方需要注意的吗


更多关于HarmonyOS 鸿蒙Next中智能体+端插件，通过语音指令，唤起元服务方案的实战教程也可以访问 https://www.itying.com/category-93-b0.html

8 回复

尊敬的开发者，您好：
App Linking通过域名校验机制确认链接归属的应用身份，涉及三处关键配置的关联关系：

  1. 应用包名（bundleName）：在AppScope/app.json5中定义，是应用的唯一标识。
  2. 域名服务器上的applinking.json配置文件：其中的appIdentifier字段填写的是应用/元服务的App ID，与bundleName一一对应。
  3. AGC控制台的应用链接配置：在AppGallery Connect中为应用创建的关联网址域名。

这三个应用身份信息不一致时，校验发现不匹配就会报错。
您可以依次排查您所要链接到的元服务的上述配置是否和您在插件侧的配置相同，您也可以结合 不羁的木木 开发者的回复进行问题排查。

更多关于HarmonyOS 鸿蒙Next中智能体+端插件，通过语音指令，唤起元服务方案的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


小艺智能体拉起的必须是已发布或至少为测试发布（Beta）版本的元服务，临时 Debug 签名的包不会被系统正确匹配。

  • 无论是拉起方应用还是被拉起的元服务，至少有一方的签名必须是调试签名，才能通过权限管控。但这里的关键是，智能体的匹配机制依赖于小艺开放平台中配置的应用信息（如包名、APP ID），而 Debug 签名会导致运行时 APP ID 随机生成，与平台上配置的正式 APP ID 不一致，从而匹配失败。

https://developer.huawei.com/consumer/cn/doc/atomic-guides/reusable-runtime-state-develop

从你描述的现象看，我觉得问题大概率不在端插件，而是在 元服务、AppLink、智能体三者的关联关系 上。

尤其是截图里的报错：

应用包名和 AppLink 链接不匹配，请检查

这个提示基本已经指向 AppLink 校验失败了。

排查建议如下：

  1. 确认 AGC 配置的 AppLink 是否属于当前元服务

AppLink 中配置的域名、路径必须和当前元服务对应。

常见问题是：

  • 配的是另外一个项目的 AppLink
  • 复制了正式环境链接，但当前安装的是测试版元服务
  • AppLink 对应的是 App，而不是元服务

重点核对：

  • AGC 元服务项目 bundleName
  • DevEco 工程中的 bundleName
  • 小艺开放平台关联的元服务 bundleName

三处必须一致。

建议确认：

  • 元服务是否已上传 AGC
  • 是否已完成元服务配置同步
  • 是否已生成正式的 AppLink

从你目前的信息来看，我最怀疑的是：

  1. AppLink 对应的 bundleName 和当前元服务 bundleName 不一致（截图已经提示这个问题）
  2. 小艺绑定的是 AGC 元服务，而手机安装的是本地 Debug 元服务
  3. 端插件返回了成功结果，但没有返回正确的拉起指令

建议先把以下信息核对一遍：

  • DevEco 工程中的 bundleName
  • AGC 元服务项目 bundleName
  • 小艺开放平台关联的元服务 ID
  • AppLink 完整链接

这几个地方只要有一个不一致，就会出现你现在这种“已执行但没拉起”的现象。

希望能帮到你~~~

期待解决

看着像是applink链接没有配置正确

Dubug断点没有选对？，

在HarmonyOS Next中，智能体通过意图框架注册语音指令，端插件作为系统级监听模块捕获语音输入。语音识别后，意图分发器匹配元服务（Atomic Service）的意图标签，直接唤起对应元服务。元服务以ArkUI卡片形式呈现，实现即用即走。全程基于OpenHarmony分布式能力与AI子系统，无需Java或C语言。

在 HarmonyOS Next 智能体+端插件唤起元服务的方案中，遇到“已执行但未拉起”的典型排查点如下：

  • 端插件的 Want 构造必须精确：端插件执行后需通过 startAbility 拉起元服务，Want 中 action 通常为 ohos.want.action.viewData，uri 要与元服务在 module.json5 中注册的 scheme 完全一致（例如 store://detail）。此外需设置 bundleName 和 abilityName，确保 abilityName 正确指向元服务的入口 EntryAbility。

  • 元服务的 deeplink 注册：检查元服务的 module.json5，skills 中必须包含与端插件 Want 匹配的 actions 和 uris，且 scheme 需与端插件 uri 一致。若用 applink 方式，要确认 AGC 元服务关联的链接与 domain 配置有效。

  • 调试环境签名一致：通过 DevEco Studio 直接安装的元服务属于调试版本，其签名与端插件（已上架）使用的正式签名可能不同。真机测试时需确保端插件能拉起本机已安装的调试元服务，可尝试在端插件中将 bundleName 设为元服务的包名，不依赖 applink，直接通过包名+Ability 名拉起。

  • 小艺平台智能体配置：检查智能体意图与端插件的关联是否正确，确认语音指令能命中对应的意图。端插件配置的 applinkUrl 模板需能生成有效的 uri；若提示报错（如图片所示），通常为模板格式错误或未与端插件代码同步。

  • 权限与前台限制：端插件前台执行时，确保拉起元服务的操作在主线程或合法上下文执行，避免因后台限制无法正常 startAbility。

以上几点逐一核对，通常可定位拉起失败原因。

回到顶部