安裝 Copilot Agent 套件

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

Note

下載並安裝 Copilot Agent 套件之前，請先確認您已符合所有先決條件。

從 Marketplace 安裝 Copilot Agent 套件

如果您偏好從 GitHub 安裝 Copilot Agent 套件，請跳至從 GitHub 安裝 Copilot Agent 套件。

從 Marketplace 部署

若要從 Marketplace 部署 Copilot Agent 套件，請遵循以下步驟：

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

會開始安裝 Copilot Agent 套件。

部署後步驟（市集）

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

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

從 GitHub 安裝 Copilot Agent 套件

請依循以下步驟從 GitHub 安裝 Copilot Agent 套件。 如果您偏好從 Marketplace 安裝，請移至從 Marketplace 安裝 Copilot Agent 套件。

下載最新的 GitHub 版本

下載 Power CAT Copilot 代理程式套件的受控解決方案最新版本。

安裝 Copilot Agent Kit 的受管理 ZIP 檔案

若要安裝 Copilot Agent Kit 受控解決方案：

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

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

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

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

Note

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

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

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

無論您是從 Marketplace 還是 GitHub 安裝 Copilot Agent 套件，這些設定步驟都適用。

小提示

Copilot Agent 套件包含一個設定精靈，可用來設定連線參考、環境變數及雲端流程。 在使用設定精靈中，了解詳細資訊。

設定 SharePoint 同步

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

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

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

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

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

更多資訊：了解如何在 Copilot Agent 套件中設定 Agent，包括如何設定新 Agent 以進行檔案同步。

設定代理程式清單

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

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

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

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

連線參考設定完成後，你可以在代理庫存中設定環境範圍、代理類型、環境群組、庫存選項，以及同步排程。 在 設定代理程式清單中深入瞭解。

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

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

啟用流程

Note

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

若要啟用 Copilot Agent 套件所包含的雲端流程，請依循以下步驟操作或使用設定精靈。

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

設立合規中心

若要設定合規性中心，請依循設定和配置 Copilot Agent 套件合規性中心中的步驟。 合規中心需要代理物品清單。

設定內嵌的交談 KPI 儀錶板

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

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

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

發佈報表

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

  1. 安裝本文先前描述的 Copilot Agent 套件。

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

了解如何在 Copilot Agent 套件中設定代理程式，包括如何為對話 KPI 設定新的代理程式。

存取 Copilot Agent Kit 應用程式

若要存取 Copilot Agent 套件應用程式：

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

分享 Copilot Agent Kit 應用程式

在驗證應用程式成功啟動後，擁有者 (或安裝套件的系統管理員) 需要與團隊共用 Copilot Agent 套件應用程式。

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

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

後續步驟

設定使用者和小組

  • 上次更新時間：