目录

常见问题

在工作台调试Agent时,如何获取本次对话用于问题定位的sessionId?

a. 打开浏览器调试台,活动栏中选择网络;b. 调测智能体;c. 点击名称为“run”的请求,选择“消息”,取出第一条数据中的sessionId、interactionId。若有多条run运行记录,可以根据运行时间判断。

如何查看Agent历史版本

点击Agent编排页右上角【版本记录】图标可查看版本记录,点击某个版本可以查看该版本Agent编排情况。注意:查看历史版本时不可编辑Agent信息,可先切回当前或回退至此版本进行编辑。

Agent如何回退到历史版本

点击Agent编排页右上角【版本记录】图标,选择历史版本,点击右下角【回退至此版本】将该历史版本覆盖当前Agent的草稿态版本。

回退原则:

1. 因历史版本关联插件、工作流、卡片或知识库可能会发生变化,资源相关配置可能发生变化;

  • 若资源已更新版本,回退后将自动关联资源的最新版本。
  • 若资源已下架或删除,回退后将自动删除Agent与资源的关联关系。

2. 除插件/工作流/知识库/卡片外,其他配置均可以完全还原。

发起的智能体上架/升级、下架申请被驳回时,如何查看审核意见?

可通过智能体编排页面的【版本记录】查看。

以智能体上架审核不通过为例,开发者点击智能体进入智能体编排页面,点击页面右上方【保存】左侧【版本记录】图标。即可通过对应版本审核结果处查阅审核意见。

智能体选择隐私托管的隐私协议后,有错误提示?

智能体关联托管的隐私协议后,平台会自动检测智能体编排涉及隐私相关项与选择的隐私协议中隐私相关项是否一致,若不一致会提示开发者补充,可通过点击“查看更新后的隐私协议”查看具体问题项。

点击“查看更新后的隐私协议”后,可以通过“编辑原文”在原协议中补充,也可以点击“继续使用”新建一个“修改后(自动生成)”的协议,然后点击“生成协议”更新或生成新协议供智能体上架时关联。

平台创建的隐私协议已修改并保存,上架后选择的仍是旧版隐私协议?

协议生成后,若发生编辑,需再次点击“生成协议”完成协议更新。

创建端A2A模式Agent平台要求

端A2A面向HarmonyOS应用。开始前,应用需要按平台要求在 HarmonyOS开发者中心 上架并完成端侧部署。

找不到应用怎么办

确认登录账号和应用属于同一个开发者团队,并检查团队权限和 HarmonyOS开发者中心 应用归属。

小艺列表里找不到Agent

“保存”只更新草稿。要在手机上看到最新配置,还需要发布真机测试。真机测试发布按钮是界面右上角的小手机图标。确认真机测试版本已发布、当前账号在已启用用户组中,并检查15天测试有效期。

使用端A2A模式时列表有Agent,但对话没有回复

先看HiLog。没有onData时检查Bundle/Module/Ability映射与发布状态;有onData时检查协议解析、APPAgent调用和响应格式。

创作端A2A模式时修改AgentCard后还是旧内容

修改了agent_config.json后,点击“重新导入”。如果换了APP,点击“重新选择”。重新导入AgentCard,点击保存,然后重新发布真机测试。

创作端A2A模式时修改了APP包名

同步更新APP配置、签名配置和AgentCard的bundleName,重新构建安装并重新发布。

端A2A模式下应用服务名称该填什么

填写module.json5中type=agent的ExtensionAbility name,不是智能体展示名称。

端A2A模式开启了文件或位置能力仍不能使用

同时检查APP权限声明、运行时授权、平台端插件权限,以及A2A消息是否真的处理对应输入类型。

使用端A2A模式时权限要同时配置

在平台勾选权限后,APP 仍要声明并向用户申请相应权限。只添加实际需要的权限。