安装 Copilot Studio 工具包

Copilot Studio Kit 是一个开源工具包，用于测试和评估 Copilot Studio 代理。 例如，它可帮助你定义测试用例、模拟用户查询和验证代理响应。 本文提供了从 MarketplaceorGitHub 安装工具包的分步说明，以及部署后步骤和配置选项。

注释

在下载并安装Copilot Studio工具包之前，请确保已满足所有先决条件。

从市场安装 Copilot Studio 工具包

如果想要从 GitHub 安装 Copilot Studio Kit，请跳到从 GitHub 安装 Copilot Studio Kit。

从应用市场部署

若要从市场部署Copilot Studio工具包，请执行以下步骤：

  1. 导航到 Marketplace 中的 Copilot Studio Kit。
  2. 选择立即获取。
  3. 如有必要，请登录。
  4. 在 “安装 Copilot Studio 工具包 ”视图中，选择要在其中部署 Copilot Studio 工具包的环境。
  5. 检查术语和语句。 如果同意，请选中这些框，然后选择“ 安装”。

开始安装 Copilot Studio 工具包。

部署后步骤（应用市场）

安装完成后，请按照以下部署后步骤进行操作：

  1. 登录到 Power Apps。
  2. 转到解决方案。
  3. 选择默认解决方案。
  4. 选择 “连接引用”。
  5. 找到 Copilot Studio Kit - Dataverse 并打开它进行编辑。
  6. 请确保填写所有必填字段，并且所选连接有效。 根据需要创建新的到 Dataverse 的连接。
  7. 选择“保存”。
  8. 按照 进一步和可选的配置步骤进行。

从 GitHub 安装Copilot Studio工具包

按照以下步骤从 GitHub 安装 Copilot Studio Kit。 如果想要从市场安装，请转到 marketplace 中的 Install Copilot Studio Kit。

下载最新的 GitHub 版本

下载 Power CAT Copilot Studio Kit 的 托管解决方案的 最新版本。

安装 CopilotStudioKit 管理的 zip 文件

若要安装Copilot Studio工具包托管解决方案，请执行以下操作：

  1. 登录到 Power Apps。
  2. 选择要安装 Copilot Studio 工具包的环境。
  3. 转到解决方案。
  4. 选择 导入解决方案。
  5. 选择浏览。
  6. 选择 CopilotStudioKit*_managed.zip 文件。
  7. 选择下一步。
  8. 查看解决方案信息后，选择“ 下一步”。
  9. 如果出现提示，请创建所需的 连接，然后选择“ 导入”。
  10. 暂时将对话关键绩效指标报告的值保持不变。 稍后可以更新这些值。
  11. 等待导入作完成。

升级现有解决方案（GitHub）

如果安装了 Copilot Studio Kit 的早期版本，并且想要升级到最新版本，请执行以下步骤：

  1. 登录到 Power Apps。
  2. 选择要升级Copilot Studio 工具包的环境。
  3. 转到解决方案。
  4. 选择 导入解决方案。
  5. 选择浏览。
  6. 选择 CopilotStudioKit*_managed.zip。
  7. 选择下一步。 Power Apps 认识到此升级是现有的托管解决方案。
  8. 选择“ 下一步”确认要升级现有解决方案。
  9. 暂时将对话关键绩效指标报告的值保持不变。 稍后可以更新这些值。
  10. 选择“ 导入”。

注释

升级 Copilot Studio 工具包时，可能会遇到以下错误：解决方案“Power CAT Copilot Studio Kit”无法导入：ImportAsHolding 失败，出现异常：无法从实体 cat_CopilotTestRun 中删除属性 cat_copilottestrunid，因为该属性不是自定义字段。

此问题已知且正在调查中。 作为一种应对方法，在应用升级之前准备升级。 在 升级或更新解决方案中了解详细信息。

进一步和可选配置步骤

无论是从市场安装Copilot Studio 工具包还是GitHub，这些配置步骤都适用。

提示

Copilot Studio工具包包括设置向导，用于配置连接引用、环境变量和云流。 了解更多关于 使用设置向导的信息。

配置SharePoint同步

仅当计划使用 SharePoint 同步 功能时，以下步骤是可选的，并且是必需的。 您可以在使用该功能之前随时设置这些值。

请将 SharePoint 连接指向源 SharePoint 站点。 将 Dataverse URL 指向同步内容的目标自定义智能体的 Dataverse 实例。

可以按照以下步骤或使用 Setup 向导配置SharePoint连接引用.

若要使用SharePoint同步功能，请执行以下操作：

  1. 安装本文前面所述的Copilot Studio Kit。
  2. 登录到 Power Apps。
  3. 转到解决方案。
  4. 选择默认解决方案。
  5. 选择 “连接引用”。
  6. 找到 Copilot Studio Kit - SharePoint 连接引用并打开它进行编辑。
  7. 确保填写所有必填字段，并且所选连接有效。 根据需要创建与 SharePoint 的新连接。
  8. 选择“保存”。

更多信息：了解如何在 Copilot Studio Kit 中配置代理，包括如何配置用于文件同步的新代理。

配置代理清单

仅当计划使用 代理清单 功能时，以下步骤是可选的，并且是必需的。 您可以在使用该功能之前随时设置这些值。

解决方案中的连接引用控制代理的可见性。 虽然可以使用其他帐户，但使用这些权限来获得完全可见性。

  • Copilot Studio 工具包 - Power Platform for Admins 提取租户中的环境列表。 需要 Power Platform 管理员级别权限。
  • Copilot Studio Kit - Dataverse 从环境中收集代理信息。 要求对所有环境拥有系统管理员级权限。

你可以按照这些步骤进行，或者使用 设置向导 配置代理库存连接参考。

请执行以下操作以使用代理库存功能：

  1. 安装本文前面所述的Copilot Studio Kit。
  2. 登录到 Power Apps。
  3. 转到解决方案。
  4. 选择默认解决方案。
  5. 选择 “连接引用”。
  6. 找到 Copilot Studio Kit - Power Platform for Admins 连接引用，然后打开它进行编辑。
  7. 确保填写所有必填字段，并且所选连接有效。
  8. 选择“保存”。
  9. 找到 Copilot Studio Kit - Dataverse 连接引用并打开它进行编辑。
  10. 确保填写所有必填字段，并且所选连接有效。
  11. 选择“保存”。

启用使用情况指标

若要 在代理清单中启用可选的使用情况指标，请完成以下步骤：

  1. 确保在环境中允许使用 HTTP 与 Microsoft Entra ID（预授权） 的连接器。
  2. 从 Power CAT Copilot Studio Kit GitHub 存储库导入 _AgentInventoryUsage*managed.zip 文件。
  3. 在导入过程中，使用许可主机 URL 创建连接： https://licensing.powerplatform.microsoft.com/

显示使用 Microsoft Entra ID 连接器将许可主机 URL 配置为 HTTP 的基本资源 URL 的屏幕截图。

启用流

注释

如果计划使用 SharePoint 同步，请在启用相关流之前 配置 SharePoint 同步 （名称以 SharePoint 同步开头）。

若要启用 Copilot Studio 工具包中包含的云流，请按照以下步骤或使用 Setup Wizard。

  1. 安装本文前面所述的Copilot Studio Kit。
  2. 登录到 Power Automate。
  3. 确保选择了包含 Copilot Studio 工具包的环境。
  4. 选择解决方案。
  5. 选择 Copilot Studio 工具包。
  6. 选择云端流。
  7. 确保所有流都已启用（状态 = 启用）。
  8. 按照以下顺序启用所有未启用的流：
    1. 以 Grandchild 结尾的流。
    2. 以 Child 结尾的流。
    3. 根据需要执行其余的流，顺序不限。

建立合规中心

若要设置 Compliance Hub，请按照 设置和配置 Copilot Studio Kit Compliance Hub中的步骤。 合规中心需要代理资产库存。

配置嵌入式对话 KPI 仪表板

仅当计划使用嵌入式 对话 KPI 仪表板时，才遵循以下步骤。

在步骤中，记下以下值：

  • 工作区名称
  • 工作区 GUID
  • 报告名称
  • 报表 GUID

发布报表

若要发布对话 KPI 报告，请执行以下操作：

  1. 安装本文前面所述的Copilot Studio Kit。

  2. 从 Power CAT Copilot Studio Kit GitHub 存储库下载 Conversation.KPIs.zip。

  3. 提取 .zip 文件的内容。

  4. 在 Power BI Desktop 应用程序中打开 Conversation KPI.pbit 文件。

  5. 在出现的对话框中输入 Dataverse URL 作为 环境 URL，然后选择“加载”（例如，org3c23948.crm.dynamics.com，没有 https:// 前缀）。

    如果未显示对话框，请在主>>中输入环境 URL。

  6. 根据需要刷新数据并登录。

  7. 保存并发布到工作区。

  8. 记下报表名称和工作区名称。

  9. 登录到 Power BI。

  10. 打开已发布的报表，并在 URL 中记录 工作区 GUID 和 报表 GUID 。

    如果发布到“我的工作区”，则工作区 GUID 为 00000000-0000-0000-0000-000000000000。

  11. 选择这三个点（...），然后选择 “查看语义模型”。

  12. 打开 文件>设置。

  13. 检查 数据源凭据 是否没有问题。 登录以修复任何问题。

  14. 转到 “刷新 ”并设置刷新计划。

更新报表环境变量

若要设置嵌入式对话 KPI 仪表板，请使用正确的标识符更新相关环境变量。 你可以按照这些步骤做，或者使用 设置向导。

  1. 登录到 Power Apps ，并选择安装 Copilot Studio 工具包的环境。
  2. 选择解决方案>默认解决方案。
  3. 选择环境变量。
  4. 查找并选择对话 KPI 报告。
  5. 将默认值中的占位符替换为在发布过程中记下的工作区名称、工作区 GUID、报表名称和报表 GUID 值。
  6. 选择“保存”。

了解如何在 Copilot Studio Kit 中配置代理，包括如何为对话 KPI 配置新代理。

访问 Copilot Studio Kit 应用

若要访问Copilot Studio工具包应用，请执行以下操作：

  1. 登录到 Power Apps ，并选择安装 Copilot Studio 工具包的环境。
  2. 转到 “应用”。
  3. 查找并选择 Power CAT Copilot Studio 工具包。
  4. 选择播放。
  5. （可选） 为应用添加书签 。

共享Copilot Studio工具包应用

验证应用是否成功启动后，安装工具包的所有者（或系统管理员）需要与团队共享Copilot Studio工具包应用。

  1. 登录到 Power Apps。
  2. 选择应用。
  3. 搜索“Copilot Studio工具包”，找到类型为Code（而不是模型驱动应用）的工具包。
  4. 选择三个点（...），然后选择应用名称旁边的 “共享 ”。
  5. 搜索并添加需要访问权限的用户或安全组。
  6. 选择 “共享 ”进行确认。

在 与组织共享画布应用中了解详细信息。

后续步骤

配置用户和团队

  • Last updated on