导入导出多智能体应用

费用说明

套餐包允许创建的应用数量，具体可参考计费说明。

如果当前环境的应用数量已接近套餐上限，请先清理无用应用或升级套餐后再执行导入。

前提条件

已开通AgentArts服务。

导出多智能体应用

已创建并配置多智能体或已导入多智能体应用。

1. 登录AgentArts智能体平台。
2. 选择“多智能体”页签，单击“导出”，勾选待导出的多智能体应用左侧复选框，单击“导出”；或鼠标移动至目标智能体，单击“更多 > 导出”。
   系统弹出“导出”弹框，如图1所示，“结果列”显示“成功”表示导出成功。

   图1 导出多智能体应用
   

3. 单击浏览器右上角的下载图标，可查看导出文件。

   导出文件为JSONL格式。建议下载后检查文件大小是否合理，并确认文件能否正常打开。

   

   • 包含内容：导出的文件包含多智能体应用的配置信息及其关联资源（如插件、MCP 服务、工作流、子智能体的配置）。导入时，系统将自动尝试还原这些依赖资源及其关联关系。
   • 不包含内容：导出内容不包含知识库。请在导入应用后，手动迁移知识库并重新进行关联。
   • 导出失败：如果应用关联的某个特定资源导出失败，导出的文件中将不包含该资源，但应用的其他部分仍会正常导出。失败原因可在应用卡片的操作列中查看。

导入多智能体应用

已有从其他AgentArts环境导出的多智能体应用的JSONL格式文件。

如果导入的多智能体应用名称与当前环境中已有的应用名称相同，导入后将覆盖原有多智能体应用的配置，且不可恢复。

建议在导入前确认名称是否冲突，或先导出备份原有应用。

1. 登录AgentArts智能体平台。
2. 选择“多智能体”页签，单击“导入”。
3. 在“导入”页面，单击“选择文件”，选择本地已准备好的文件，勾选需要导入的内容，单击“导入”。
4. 导入后，可在图3所示的结果列查看状态。
   • 导入成功：结果列显示“成功”。可进入多智能体配置页面，检查各项配置是否已正确还原。
   • 需配置鉴权：如果关联的插件、MCP 服务或模型供应商缺乏认证信息，操作列将显示“配置鉴权”。请单击“配置鉴权”，在弹窗中完成鉴权配置。
   • 导入失败：如果应用关联的某个特定资源（如插件、MCP 服务、知识库、工作流等）导入失败，应用本身仍会导入成功，但该资源将不会被导入。失败原因可在操作列中查看。
     图2 导入多智能体应用
     
     图3 导入多智能体成功
     

常见问题

• Q1：导入显示成功，但应用运行时报错，如何排查？

  导入操作仅还原了应用配置结构与关联关系，实际运行还需目标环境中的依赖资源就绪。请按以下顺序检查：

  1. 鉴权配置：进入配置页，检查关联的插件、MCP服务、模型供应商是否提示“未配置鉴权”。如有，请重新输入有效的API Key。
  2. 知识库关联：导出的文件不包含知识库。请确认目标环境中已存在对应的知识库，并在“知识库”组件中重新选择绑定。
  3. 依赖状态：资产广场的资源无法导出和导入，需要检查一下导入环境是否需要重新关联。
  4. 版本差异：确认导入的模型类型在目标环境中是否可用。

• Q2：导入/导出结果列表中，某些应用显示“失败”或“部分失败”，如何处理？
  • 导出失败：通常是因为原环境中的关联资源已被删除、权限过期或版本不兼容。请点击“操作列”查看具体失败原因，修复原应用资源后再次尝试导出。
  • 导入失败：通常是因为导入文件中的某些组件（如特定插件）在当前环境中不存在。应用主体仍会导入成功，缺失的资源需在导入后手动重新配置。
• Q3：为什么导入后的插件、MCP显示“未配置鉴权”？

  这是出于安全与跨环境隔离的设计。导出的JSONL文件默认不包含API Key等敏感鉴权信息，以防止凭据明文泄露。此外，不同环境的密钥相互独立，无法直接复用。

  处理方式：导入成功后，请进入多智能体编辑页面，找到对应的插件或MCP，手动配置目标环境对应的鉴权信息。