安裝 Copilot Agent Kit

Copilot Agent Kit 是一款開源工具包，用於測試與評估 Copilot Studio 代理。 例如，它幫助你定義測試案例、模擬使用者查詢，以及驗證代理回應。 本文提供從 Marketplace 或 GitHub 安裝套件的步驟，以及部署後的步驟與設定選項。

備註

在下載並安裝 Copilot Agent Kit 之前，請確保你符合所有前置條件。

從市集安裝 Copilot 代理套件

如果你偏好從 GitHub 安裝 Copilot Agent Kit，請跳過「從 GitHub 安裝 Copilot Agent Kit」。

從 Marketplace 部署

要從市集部署 Copilot Agent Kit，請依照以下步驟操作：

  1. 到市集裡的 Copilot Agent 套件。
  2. 請選擇立即取得。
  3. 如有必要，請登入。
  4. 在安裝 Copilot 代理套件的檢視中，選擇你想部署 Copilot 代理套件的環境。
  5. 檢閱條款和聲明。 如果您同意，請核取方塊並選取 [安裝]。

Copilot Agent Kit 的安裝工作開始。

部署後步驟（市集）

安裝完成後，請遵循下列部署後步驟：

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

從 GitHub 安裝 Copilot Agent Kit

請依照以下步驟從 GitHub 安裝 Copilot Agent Kit。 如果你偏好從 Marketplace 安裝，請前往 Marketplace 安裝 Copilot Agent Kit。

下載最新的 GitHub 版本

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

安裝 Copilot Agent Kit 管理的 zip 檔

安裝 Copilot Agent Kit 管理解決方案：

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

升級現有的解決方案 （GitHub）

要升級到最新版本的 Copilot Agent Kit，請遵循以下步驟：

  1. 登入Power Apps。
  2. 選擇你想升級 Copilot Agent Kit 的環境。
  3. 前往解決方案。
  4. 選取匯入解決方案。
  5. 選擇 瀏覽。
  6. 選取 CopilotStudioKit*_managed.zip。
  7. 選取 下一步。 Power Apps 已識別此升級為現有的管理解決方案。
  8. 選取 [ 下一步]，確認您要升級現有的解決方案。
  9. 暫時保留 交談 KPI 指標報告 值保持不變。 您可以稍後更新這些值。
  10. 選擇 匯入。

備註

在升級 Copilot Agent Kit 時，你可能會遇到以下錯誤：解決方案「Power CAT Copilot Agent Kit」未能匯入：ImportAsHolding failed with exception：無法從 Entity： cat_CopilotTestRun cat_copilottestrunid 刪除屬性，因為該屬性不是自訂欄位。

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

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

無論你安裝的是 Marketplace 還是 GitHub 的 Copilot Agent Kit，這些設定步驟都適用。

小提示

Copilot Agent Kit 包含設定精靈，可設定連線參考、環境變數及雲端流程。 了解如何使用設定精靈。

設定 SharePoint 同步

以下步驟為可選，僅在你打算使用 SharePoint 同步 功能時才需要。 您可以在使用該功能之前隨時設定這些值。

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

你可以依照這些步驟操作，或使用 Setup Wizard 來設定 SharePoint 連線參考.

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

  1. 安裝本文前述的 Copilot Agent Kit。
  2. 登入Power Apps。
  3. 前往解決方案。
  4. 選取預設解決方案。
  5. 選取 [連線參考]。
  6. 找到 Copilot Agent Kit - SharePoint 連線參考，並打開以便編輯。
  7. 請確定已填寫所有必填欄位，且所選連線有效。 視需要建立與 SharePoint 的新連線。
  8. 選取 [儲存]。

更多資訊：了解如何在 Copilot Agent Kit 中設定代理，包括如何設定新的代理程式以同步檔案。

設定代理程式清單

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

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

  • Copilot Agent Kit - Power Platform for Admins 會取得租戶中的環境清單。 需要 Power Platform 系統管理員層級權限。
  • Copilot Agent Kit - Dataverse 從環境中收集代理資訊。 需要所有環境的系統管理員層級權限。

你可以依照這些步驟操作，或使用 設定精靈 設定代理物品欄的連線參考。

若要使用客服專員庫存功能：

  1. 安裝本文前述的 Copilot Agent Kit。
  2. 登入Power Apps。
  3. 前往解決方案。
  4. 選取預設解決方案。
  5. 選取 [連線參考]。
  6. 找到 Copilot Agent Kit - Power Platform for Admins 連線參考，並打開以便編輯。
  7. 確保所有必填欄位均已填寫且所選連線有效。
  8. 選取 [儲存]。
  9. 找到 Copilot Agent Kit - Dataverse 連線參考，並打開以便編輯。
  10. 確保所有必填欄位均已填寫且所選連線有效。
  11. 選取 [儲存]。

啟用流程

備註

如果你打算使用 SharePoint 同步，請 先設定 SharePoint 同步 ，再啟用相關流程（名稱以 SharePoint 同步開頭）。

要啟用 Copilot Agent Kit 中包含的雲端流程，請依照以下步驟操作，或使用設定精靈。

  1. 安裝本文前述的 Copilot Agent Kit。
  2. 登入Power Automate。
  3. 請確保使用 Copilot Agent Kit 的環境已被選擇。
  4. 選取 [解決方案]。
  5. 選擇 Copilot Agent Kit。
  6. 選取雲端流程。
  7. 請確定所有流程都已啟用 （狀態 = 開啟）。
  8. 依下列順序啟用任何未啟用的流程：
    1. 以 Grandchild 結尾的流程。
    2. 以 Child 結尾的流程。
    3. 其餘的流程可根據需要以任何順序執行。

設立合規中心

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

設定內嵌的交談 KPI 儀錶板

只有在你打算使用內嵌的 對話 KPI 儀表板時，才可依照這些步驟操作。

在步驟中，請記下下列值：

  • 工作區名稱
  • 工作區 GUID
  • 報告名稱
  • 報表 GUID

發佈報表

若要發佈交談 KPI 報告，請遵循以下步驟：

  1. 安裝本文前述的 Copilot Agent Kit。

  2. 從 Power CAT Copilot Agent Kit GitHub 倉庫下載 Conversation.KPIs.zip。

  3. 解壓縮 .zip 檔案的內容。

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

了解如何在 Copilot Agent Kit 中配置客服人員，包括如何為對話 KPI 配置新的客服人員。

存取 Copilot Agent Kit 應用程式

要使用 Copilot Agent Kit 應用程式：

  1. 登入 Power Apps，選擇安裝 Copilot Agent Kit 的環境。
  2. 開啟 應用程式。
  3. 尋找並選擇 Power CAT Copilot Agent 套件。
  4. 選擇 [ 播放]。
  5. （選用） 為應用程式添加書籤 。

分享 Copilot Agent Kit 應用程式

在確認應用程式成功啟動後，擁有者（或安裝套件的系統管理員）需要與團隊分享 Copilot Agent Kit 應用程式。

  1. 登入Power Apps。
  2. 選取應用程式。
  3. 搜尋「Copilot Agent Kit」，找到帶有 Code 類型的那個（不是模型驅動的應用程式）。
  4. 點選三個點（...），然後在應用程式名稱旁選擇 分享 。
  5. 搜尋並新增需要存取權限的使用者或安全群組。
  6. 選擇 分享 以確認。

在 「與您的組織分享 Canvas 應用程式」中了解更多。

下一個步驟

設定使用者和小組

  • Last updated on