共用方式為


安裝 Copilot Studio 套件

Copilot Studio Kit 是一個開放原始碼工具包,用於測試和評估 Copilot Studio 代理程式。 例如,它允許您定義測試用例、模擬用戶查詢和驗證代理響應。 本文提供從 MarketplaceGitHub 安裝套件的步驟,以及部署後的步驟與設定選項。

備註

在下載並安裝 Copilot Studio 套件之前,請確定符合所有 先決條件

從市集安裝 Copilot Studio Kit

如果您偏好從 GitHub 安裝 Copilot Studio Kit,請跳至從 GitHub 安裝 Copilot Studio Kit

從 Marketplace 部署

要從 Marketplace 部署 Copilot Studio Kit,請遵循以下步驟:

  1. 請前往 市集中的 Copilot Studio 套件。
  2. 請選取立即取得
  3. 如有必要,請登入。
  4. 安裝 Copilot Studio 套件 檢視中,選取您要部署 Copilot Studio 套件的環境。
  5. 檢閱條款和聲明。 如果您同意,請核取方塊並選取 [安裝]。

Copilot Studio Kit 的安裝開始。

部署後步驟(市集)

安裝完成後,請遵循下列部署後步驟:

  1. 登入 Power Apps
  2. 移至解決方案
  3. 選取預設解決方案
  4. 選取 [連線參考]。
  5. 找到 Copilot Studio Kit - Dataverse 並將其開啟進行編輯。
  6. 請確定已填入所有必填欄位,且所選連線有效。 視需要建立與 Dataverse 的新連線。
  7. 選取 [儲存]。
  8. 請遵循 進一步的選用設定步驟

從 GitHub 安裝 Copilot Studio Kit

請依照下列步驟從 GitHub 安裝 Copilot Studio Kit。 如果你偏好從市集安裝,請前往市 集安裝 Copilot Studio Kit

下載最新的 GitHub 版本

下載最新版本 Power CAT Copilot Studio 套件受管理的解決方案。

安裝 CopilotStudioKit 受控 zip 檔案

若要安裝 Copilot Studio Kit 受控解決方案:

  1. 登入 Power Apps
  2. 選取您要安裝 Copilot Studio Kit 的環境。
  3. 移至解決方案
  4. 選取匯入解決方案
  5. 選擇瀏覽
  6. 選取 CopilotStudioKit*_managed.zip 檔案。
  7. 選取 下一步
  8. 檢閱解決方案資訊之後,選取 [ 下一步]。
  9. 如果出現提示,請建立必要的連線,然後選取 匯入。
  10. 暫時保留 交談 KPI 指標報告 值保持不變。 您可以稍後更新這些值。
  11. 等待匯入作業完成。

升級現有的解決方案 (GitHub)

如果您安裝了舊版的 Copilot Studio 套件,並想要升級至最新版本,請依照下列步驟操作:

  1. 登入 Power Apps
  2. 選取您要升級 Copilot Studio Kit 的環境。
  3. 移至解決方案
  4. 選取匯入解決方案
  5. 選擇瀏覽
  6. 選取 CopilotStudioKit*_managed.zip
  7. 選取 下一步。 Power Apps 認識到此升級是現有的受控解決方案。
  8. 選取 [ 下一步],確認您要升級現有的解決方案。
  9. 暫時保留 交談 KPI 指標報告 值保持不變。 您可以稍後更新這些值。
  10. 選擇 匯入

備註

升級 Copilot Studio 套件時,您可能會遇到以下錯誤:「解決方案「Power CAT Copilot Studio Kit」匯入失敗:ImportAsHolding 失敗,例外狀況:無法從實體中刪除屬性:cat_copilottestrunid:cat_CopilotTestRun,因為屬性不是自訂欄位。

此問題是已知的,正在調查中。 因應措施是,請先準備好升級,再進行套用。 如需詳細資訊,請參閱升級或更新解決方案。

進一步和選擇性的配置步驟

無論你是從 Marketplace 還是 GitHub 安裝 Copilot Studio Kit,這些設定步驟都適用。

小提示

Copilot Studio Kit 包含設定精靈,用來設定連線參考、環境變數及雲端流程。 了解更多關於 使用設定精靈的資訊。

設定 SharePoint 同步處理

下列步驟是選擇性的,只有在您打算使用 SharePoint 同步 處理功能時才需要。 您可以在使用該功能之前隨時設定這些值。

將 SharePoint 的連線指向來源 SharePoint 網站。 將 Dataverse URL 指向目標自訂 Agent 用於內容同步的 Dataverse 執行個體。

你可以依照這些步驟操作,或使用 設定精靈 設定 SharePoint 連線參考。

若要使用 SharePoint 同步處理功能:

  1. 安裝本文稍早所述的 Copilot Studio Kit。
  2. 登入 Power Apps
  3. 移至解決方案
  4. 選取預設解決方案
  5. 選取 [連線參考]。
  6. 找到 Copilot Studio 套件 - SharePoint 連線參考並開啟它進行編輯。
  7. 請確定已填寫所有必填欄位,且所選連線有效。 視需要建立與 SharePoint 的新連線。
  8. 選取 [儲存]。

其他資訊:了解如何 在 Copilot Studio Kit 中設定代理程式,包括如何 設定新的代理程式以進行檔案同步處理。

設定代理程式清單

下列步驟是選用的,只有在您計劃使用 代理清查 功能時才需要。 您可以在使用該功能之前隨時設定這些值。

解決方案中的連線參考會控制客服專員的可見度。 雖然您可以使用其他帳戶,但請使用這些權限來取得完整的可見度。

  • 「Copilot Studio Kit - 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 套件 - Dataverse 連線參考並開啟它進行編輯。
  10. 確保所有必填欄位均已填寫且所選連線有效。
  11. 選取 [儲存]。

啟用使用量計量

若要 在代理程式庫存中啟用選用的使用量度,請完成下列步驟:

  1. 請確定在您的環境中允許使用連接器 HTTP With Microsoft Entra ID(預先授權)
  2. Power CAT Copilot Studio Kit GitHub 存放庫匯入 AgentInventoryUsage*_managed.zip 檔案。
  3. 在匯入程序期間,使用授權主機 URL 建立連線: https://licensing.powerplatform.microsoft.com/

螢幕擷取畫面顯示將授權伺服器 URL 設定為具有 Microsoft Entra ID 連接器的 HTTP 基礎資源 URL。

啟用流程

備註

如果您打算使用 SharePoint 同步處理,請先 設定 SharePoint 同步處理 ,再啟用相關流程 (名稱以 Sharepoint 同步處理開頭)。

要啟用 Copilot Studio Kit 內建的雲端流程,請 依照以下步驟操作或使用 設定精靈

  1. 安裝本文稍早所述的 Copilot Studio Kit。
  2. 登入 Power Automate
  3. 請確定已選取具有 Copilot Studio 套件的環境。
  4. 選取 [解決方案]。
  5. 選取 Copilot Studio 套件
  6. 選取雲端流程
  7. 請確定所有流程都已啟用 (狀態 = 開啟)。
  8. 依下列順序啟用任何未啟用的流程:
    1. 下下層結尾的流程。
    2. Child 結尾的流程。
    3. 其餘的流程可根據需要以任何順序執行。

設立合規中心

要設定 合規中心,請依照 「設定與設定 Copilot Studio 套件合規中心」中的步驟操作。 合規中心需要代理物品清單。

設定內嵌的交談 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 應用程式中開啟 交談 KPIs.pbit 檔案。

  5. 在出現的對話方塊中輸入 Dataverse URL 作為 環境 URL ,然後選取 載入 (例如, org3c23948.crm.dynamics.com不帶 https:// 前置詞)。

    如果對話方塊未出現,請在首頁>中輸入> 編輯參數

  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 Kit 的環境。
  2. 選取解決方案>預設解決方案
  3. 選取環境變數
  4. 尋找並選取 交談 KPI 報告
  5. [預設值] 中的預留位置取代為您在發佈程式期間記下的 工作區名稱工作區 GUID報表名稱報表 GUID 值。
  6. 選取 [儲存]。

其他資訊:瞭解如何在 Copilot Studio Kit 中設定客服專員,包括如何 為交談 KPI 設定新的客服專員

存取 Copilot Studio Kit 應用程式

若要存取 Copilot Studio Kit 應用程式:

  1. 登入 Power Apps 並選取您安裝 Copilot Studio Kit 的環境。
  2. 移至應用程式
  3. 尋找並選取 Power CAT Copilot Studio 套件
  4. 選擇 [ 播放]。
  5. (選用) 為應用程式添加書籤

後續步驟