使用解决方案导出和导入代理

可以使用解决方案导出和导入代理,以便在多个环境之间移动代理。

首先,创建自定义解决方案并将代理添加到其中。 然后,使用代理导出解决方案,并将其导入到另一个环境中。 您还可以使用代理升级或更新解决方案,以及从托管代理中删除非托管层。

有关 Copilot Studio 中解决方案资源管理器的更多详细信息,请参阅在 Copilot Studio 中查看和管理解决方案一文。

备注

导出代理时,您无法导出主题级别或节点级别的注释

先决条件

须知事项

  • 导出代理时,您无法导出主题级别或节点级别的注释

  • 从解决方案删除代理不会从解决方案中删除其组件。 您应该单独删除组件。

    警告

    不要直接从解决方案中删除非托管代理组件,例如代理主题,除非您还从解决方案中删除了代理。

    您只应在 Copilot Studio UI 的标准创作过程中对主题进行更改。 直接从解决方案删除或更改代理的组件将导致导出和导入失败。

  • 您无法导出托管解决方案。 在创建解决方案时,默认情况下解决方案为非托管解决方案。 如果将其更改为托管解决方案,则无法导出该解决方案。 您需要创建新的解决方案。

  • 无法导出包含任何主题名称中带有句点 (.) 的代理的解决方案。

创建自定义解决方案并添加代理

  1. 执行在 Copilot Studio 中创建和管理解决方案中的步骤创建新解决方案。

  2. 您创建的解决方案应自动打开。 如果没有,请在解决方案列表中选择它。

  3. 选择添加现有代理,然后选择代理,然后再次选择代理

  4. 添加现有助手列表中,选择要导出的一个或多个代理,然后选择添加

备注

对于经典聊天机器人:

如果您要使用技能,通过选择从此解决方案中删除来删除技能的环境变量当前值

显示“从此解决方案中删除”按钮的屏幕截图。

从解决方案删除代理不会从解决方案中删除其组件。 您必须单独清除这些组件。

将组件添加到自定义解决方案中的代理

如果在 Copilot Studio 中将主题或流等组件添加到代理,则还必须在导出之前将它们添加到非托管解决方案中的代理中。

  1. 打开包含代理的解决方案。
  2. 对象窗格中,在代理下找到您的代理。
  3. 选择命令 (),再选择高级,然后选择添加所需对象

您还应该查看 Power Apps 文档中的说明和要求,以将现有组件添加到解决方案

导出包含代理的解决方案

通过将包含代理的解决方案从一个环境导出和导入到另一个环境来导出和导入代理。

按照 Power Apps 文档中的说明和要求导出解决方案

重要提示

如果您的代理有大量组件(例如,超过 250 个主题或超过 100 个实体),请参阅使用经典体验导出

导入包含代理的解决方案

按照 Power Apps 文档中的说明和要求导入解决方案

如果导入失败,请选择下载日志文件以下载 XML 文件,其中包含有关导致导入失败的原因的详细信息。 导入失败的最常见原因是解决方案不包含一些必需的组件。

  1. 再次配置用户身份验证

  2. 对象窗格中,选择代理。 然后选择代理的名称以打开代理。

重要提示

  • 您必须先发布新导入的代理,然后才能共享。
  • 您的代理的图标最多可能需要 24 小时出现在各处。

在 Teams 中导出和导入代理

在 Microsoft Teams 中,您可以使用 Power Apps Teams 应用在各个团队之间导出和导入代理。

例如,如果从 Teams 团队(团队 A)导出工作代理,然后将其导入团队 B,则不必为团队 B 从头开始构建它。

按照从 Dataverse for Teams 导出自定义项中的说明进行操作。

选择要导出的自定义项时,选择要导出的代理。 您可以使用侧窗格上的筛选器仅为特定团队显示代理。

代理将被保存到计算机上的下载文件夹中。

若要在 Teams 中导入,请按照将自定义项导入 Dataverse for Teams 中的说明进行操作。

您的代理将显示在 Teams 的 Copilot Studio 应用中,位于您将其导入的团队下方。