
# 管理多智能体
#### 费用说明
不同套餐包允许创建的**应用数量限制** 不同，具体可参考[计费说明](https://support.huaweicloud.com/price-agentarts/agentarts_08_0002.html)。
#### 导入导出多智能体应用
AgentArts支持将多智能体应用从一个环境中导出，导入至另一个环境中，无需用户重复构建，快速完成多智能体应用跨环境构建或复用。
适用的业务场景如下：
- 从测试环境导出多智能体，导入到生产环境中部署。
- 在不同的开发环境之间迁移多智能体应用。
- 将多智能体应用下载到本地进行代码归档。
- 作为模板提供给其他客户进行复用。
 
- [导出多智能体应用]
  已[创建并配置多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0106.html)或已[导入多智能体应用]。
  1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
  
  2. 在左侧导航栏，选择"开发中心 \> 智能体管理"。
  
  3. 选择"多智能体"页签，单击"导出"，勾选待导出的多智能体应用左侧复选框，单击"导出"；或将鼠标移动至目标智能体，单击"更多 \> 导出"。 
     系统弹出"导出"弹框，如[图1]所示，"结果列"显示"成功"表示导出成功。
     图1导出多智能体应用   
     ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949978.png "点击放大")
     
     
  
  4. 单击浏览器右上角的下载图标，可查看导出文件。 
     导出文件为JSONL格式。建议下载后检查文件大小是否合理，并确认文件能否正常打开。
     ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
     - **包含内容** ：导出的文件包含多智能体应用的**配置信息** 及其**关联资源**（如插件、MCP服务、工作流、子智能体的配置）。导入时，系统将自动尝试还原这些依赖资源及其关联关系。
     
     - **不包含内容** ：导出内容**不包含知识库**。请在导入应用后，手动迁移知识库并重新进行关联。
     
     - **导出失败**：如果应用关联的某个特定资源导出失败，导出的文件中将不包含该资源，但应用的其他部分仍会正常导出。失败原因可在应用卡片的操作列中查看。
      
     
     
   
- [导入多智能体应用]
  
  已有从其他AgentArts环境导出的多智能体应用的JSONL格式文件。
  ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/warning_3.0-zh-cn.png)
  如果导入的多智能体应用名称与当前环境中已有的应用名称相同，导入后将**覆盖** 原有多智能体应用的配置，且**不可恢复**。
  建议在导入前确认名称是否冲突，或先导出备份原有应用。
  如果当前环境的应用数量已接近套餐上限，请先清理无用应用或升级套餐后再执行导入。
  1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
  
  2. 在左侧导航栏，选择"开发中心 \> 智能体管理"。
  
  3. 选择"多智能体"页签，单击"导入"。
  
  4. 在"导入"页面，单击"选择文件"，选择本地已准备好的文件，勾选需要导入的内容，单击"导入"。
  
  5. 导入后，可在[图2]所示的结果列查看状态。
     
     - **导入成功**：结果列显示"成功"。可进入多智能体配置页面，检查各项配置是否已正确还原。
     
     - **需配置鉴权**：如果关联的插件、MCP服务或模型供应商缺乏认证信息，操作列将显示"配置鉴权"。请单击"配置鉴权"，在弹窗中完成鉴权配置。
     
     - **导入失败** ：如果应用关联的某个特定资源（如插件、MCP服务、知识库、工作流等）导入失败，应用本身仍会导入成功，但该资源将不会被导入。失败原因可在操作列中查看。
       图2导入多智能体应用   
       ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389727.png "点击放大")
       图3导入多智能体成功   
       ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549621.png "点击放大") 
     
     
     
     
   
#### 多智能体相关操作
在多智能体应用卡片列表中，支持的其他操作请参考[表1]。
 表1相关操作 
| 操作            | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|
| 编辑多智能体应用信息    | 单击待编辑的多智能体应用卡片，进入"多智能体配置"页面，在名称右侧单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389743.png)，可以编辑多智能体应用的名称、描述、图标。 如果配置的子智能体有新版本，在对应的卡片上单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790118.png)，升级新版本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 渠道管理          | 鼠标移动至已发布的多智能体应用卡片上，单击"渠道管理"，进入渠道管理页面，具体发布操作请参见[部署多智能体应用为API](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0108.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 查看版本历史记录      | 鼠标移动至已发布的多智能体应用卡片上，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389735.png)，查看版本历史记录。 在版本历史记录中，可以执行如下操作。 - 复制版本：在"版本ID"右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549605.png)，可以复制发布的版本ID。  - 还原版本：单击"还原版本"，可以还原到此版本。 注意： 还原后，当前多智能体应用配置将不再保留，建议还原前先提交当前版本作为备份。   - 删除版本：单击"删除"，可以删除此发布版本。                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 获取多智能体应用的调用路径 | 鼠标移动至待获取调用路径的多智能体应用卡片上，单击"调用路径"，在"调用路径"页面，单击"复制路径"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 复制多智能体应用的ID   | 鼠标移动至待复制ID的多智能体应用卡片上，单击"复制ID"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 删除多智能体应用      | 警告： 如果该多智能体已被引用，删除时将展示引用关系。删除会导致引用方运行异常，且不可恢复。 鼠标移动至待删除的多智能体应用卡片上，单击"更多 \> 删除"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 查看智能体运行时数据    | - 在"智能体运行时"页面，通过搜索智能体ID搜索查看智能体运行时数据。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。  2. 在左侧导航选择"部署运行 \> 智能体运行时"，在搜索框中输入上方已获取的ID进行搜索。  3. 单击搜索到的智能体名称，进入详情页面查看智能体运行时数据。    - 在"运营运维 \> 观测 \> 智能体运行分析"页面，通过搜索智能体ID查看智能体运行时数据。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。  2. 在左侧导航选择"运营运维 \> 观测 \> 智能体运行分析"，在搜索框中输入上方已获取的ID进行搜索。  3. 单击搜索到的智能体名称，进入详情页面查看智能体运行时数据。     |
   
#### 常见问题
- **Q1：导入显示成功，但应用运行时报错，如何排查？**
  导入操作仅还原了应用配置结构与关联关系，实际运行还需目标环境中的依赖资源就绪。请按以下顺序检查：
  1. 鉴权配置：进入配置页，检查关联的插件、MCP服务、模型供应商是否提示"未配置鉴权"。如有，请重新输入有效的API Key。
  
  2. 知识库关联：导出的文件不包含知识库。请确认目标环境中已存在对应的知识库，并在"知识库"组件中重新选择绑定。
  
  3. 依赖状态：资产广场的资源无法导出和导入，需要检查导入环境是否需要重新关联。
  
  4. 版本差异：确认导入的模型类型在目标环境中是否可用。
   

- **Q2：导入/导出结果列表中，某些应用显示"失败"或"部分失败"，如何处理？**
  - **导出失败**：通常是因为原环境中的关联资源已被删除、权限过期或版本不兼容。请单击"操作列"查看具体失败原因，修复原应用资源后再次尝试导出。
  
  - **导入失败**：通常是因为导入文件中的某些组件（如特定插件）在当前环境中不存在。应用主体仍会导入成功，缺失的资源需在导入后手动重新配置。
   
- **Q3：为什么导入后的插件、MCP显示"未配置鉴权"？**
  这是出于安全与跨环境隔离的设计。导出的JSONL文件默认不包含API Key等敏感鉴权信息，以防止凭据明文泄露。此外，不同环境的密钥相互独立，无法直接复用。
  处理方式：导入成功后，请进入多智能体编辑页面，找到对应的插件或MCP，手动配置目标环境对应的鉴权信息。
  
 
