若要測試自訂 Copilot Studio 代理程式，請建立 代理程式組態 記錄，其中包含連線到代理程式並執行測試所需的資訊。
支援下列組態型別：
- 測試自動化： 允許批量測試自定義代理。
- 對話 KPI： 解析所選自定義代理的對話記錄並生成對話 KPI（關鍵績效指標）記錄。
- 檔案同步：允許選擇性地將內容從 SharePoint 位置同步到自訂代理知識庫作為檔案。
您可以在單一代理程式組態記錄中支援多種組態類型。 在「代理程式組態」檢視中，您只會看到相關的組態區段。
建立新的代理程式組態記錄
移至 Agent。
建立 新的 代理程式組態記錄。
輸入 所有 組態型別所需的下列資訊：
欄位名稱 為必填項目 Description 名稱 Yes 代理程式組態的名稱。 名稱不必與您目標的客服專員相符。 組態型別 Yes 選取一或多個組態型別。 請遵循您選取的每個組態型別所遵循的組態步驟。
設定測試自動化的新代理程式
從組態型別中選取測試自動化。
除了 基本組態之外，還提供下列資訊：
欄位名稱 為必填項目 Description 區域 Yes 部署代理程式的區域。 需要以適當的 Direct Line API 端點為目標。 令牌端點 視情況而定 如果未使用或強制執行 通道安全性 ，請使用電子郵件應用程式通道中可用的 權杖端點 。 通道安全 視情況而定 如果已啟用 Web 和 Direct Line 通道安全性 ，請啟用此選項，以確保可以取得權杖以換取秘密。
注意：如果已啟用使用者驗證，則需要啟用信道安全。秘密地點 視情況而定 核取 [通道安全性] 時，請選擇儲存 Direct Line 通道密碼的位置。 Dataverse 會將秘密儲存在安全資料行中，而 Azure 金鑰保存庫則使用秘密類型的環境變數，並將秘密儲存在 Azure 金鑰保存庫中。 祕密 視情況而定 當選取 Dataverse 作為 秘密位置時，此欄會儲存 Direct Line 通道秘密。 環境變數 視情況而定 選取 [金鑰保存庫 ] 作為 [秘密位置] 時，此資料行會儲存連結至 Azure 金鑰保存庫秘密之秘密類型環境變數的結構描述名稱。 請遵循 在 Azure 金鑰保存庫中設定秘密中的步驟。 使用者驗證 視情況而定 如果需要使用者驗證，請選取 Entra ID v2。 若要使用 Microsoft 驗證，請遵循設定 Copilot Studio Kit 測試的 Microsoft 驗證中的步驟
注意：如果啟用了使用者身份驗證，則需要啟用通道安全。用戶端識別碼 視情況而定 輸入為啟用自訂代理程式的一般使用者驗證而建立的應用程式的應用程式 （用戶端） ID。 深入瞭解使用 Microsoft Entra ID 設定使用者驗證。 租用戶標識碼 視情況而定 輸入為啟用自訂 Agent 的終端使用者驗證而建立之應用程式的租用戶識別碼。 秘密位置 （使用者驗證） 視情況而定 選取 「使用者驗證」 時，選擇您要儲存用戶端密碼的位置。 Dataverse 會將秘密儲存在安全資料行中，而金鑰保存庫需要秘密類型的環境變數，並將秘密儲存在 Azure 金鑰保存庫中。 用戶端祕密 視情況而定 輸入您在 啟用驗證支援時建立的用戶端密碼。 例如： KitAuthApp secret。Scope 視情況而定 輸入您在 啟用驗證支援時建立的自訂範圍。 使用完整範圍 URI 格式;例如： api://1234-4567/scope.name。使用 Azure Application Insights 擴充 視情況而定 啟用此選項，以使用 Azure Application Insights 遙測資料來擴充生成式答案測試的測試結果。
注意：若要擴充 Application Insights 的測試結果，您必須在同一租用戶中註冊應用程式與 Application Insights 資源。 Application Insights 資源和應用程式可以與您正在測試的自訂 Agent 位於不同的租用戶中。 深入瞭解 如何註冊應用程式，並取得 Application Insights 資源的必要資訊。 請確定自訂代理程式已設定為將遙測傳送至 Application Insights 資源，且符合 Copilot Studio Kit 中的代理程式設定。 深入瞭解如何 將自訂代理程式連線到 Application Insights。App Insights 用戶端識別碼 視情況而定 輸入具有從 Application Insights 資源讀取資料許可權的應用程式 （用戶端） 識別碼。 App Insights 應用程式識別碼 視情況而定 輸入 Application Insights 資源的 AppId 。 請參閱 尋找 AppId 的步驟。 App Insights 秘密位置 視情況而定 選擇儲存 Application Insights 應用程式秘密的位置。 Dataverse 會將秘密儲存在安全資料行中，而 Azure 金鑰保存庫需要秘密類型的環境變數，並將秘密儲存在 Azure 金鑰保存庫中。 App Insights 租用戶識別碼 視情況而定 輸入 Application Insights 資源和應用程式的租用戶識別碼。 App Insights 密鑰 視情況而定 當選取 Dataverse 作為 秘密位置時，此資料行會儲存 App Insights 應用程式秘密。 App Insights 環境變數 視情況而定 選取 Key Vault 作為 秘密位置時，此資料行會儲存連結至 App Insights 應用程式秘密之類型秘密環境變數的結構描述名稱。 豐富對話記錄 否 啟用此選項，可使用儲存在 Dataverse 中的交談記錄中的資料來擴充測試結果。
注意： 若要讓 Copilot Studio Kit 從其他 Power Platform 環境擷取交談記錄，您在設定解決方案時使用的 Microsoft Dataverse 連線必須具備對目標環境中資料表記錄的ConversationTranscript存取權。 您只能以相同租用戶內的環境為目標。Dataverse URL 視情況而定 啟用使用 交談文字記錄擴充 時，請輸入 Dataverse 環境的 URL （例如 https://org123.crm.dynamics.com）。 您可以在 Copilot Studio 的設定 （
）中選取工作階段詳細資料來取得 URL。 尋找執行個體 URL。複製完整文字記錄 否 啟用「 使用交談文字記錄擴充 」時，此選項會將完整的「交談文字記錄」JSON 複製為測試結果記錄的附件，以供進一步分析。 分析生成的答案 否 當您啟用此選項時，大型語言模型 （LLM） 會分析 AI 產生的測試。 它會將回應與範例答案或驗證指示進行比較。 生成式 AI 提供商 視情況而定 啟用「 分析產生的答案 」時，請指定用於分析的 LLM 模型。
注意：目前僅支援 AI Builder。選取 [儲存]。
為對話 KPI 配置新的代理程式
從組態型別中選取交談 KPI。
除了 基本組態之外，還提供下列資訊：
欄位名稱 為必填項目 Description Dataverse URL Yes 交談文字記錄與 Agent 所在位置的 Dataverse URL。 例如： https://organizationname.crm.dynamics.comAgent 識別碼 Yes 您目前選作目標之自訂 Agent 的機器人識別碼。 您可以在 Copilot Studio 的 設定 （ ） 中選取 工作階段詳細資料，找到此值。 尋找 Copilot ID。複製完整文字記錄 否 如果您想要檢查文字記錄視覺化檢視中的交談 (交談 KPI 記錄上的文字記錄索引標籤)，則為必要項目。 啟用時，會複製交談的完整文字記錄，並與 KPI 記錄相關聯。 追蹤變數 否 您最多可以指定五個自訂變數來追蹤對話 （例如，自訂 Net Promoter Score 或 NPS）。 格式為 JSON 陣列。
範例：[ Activity. Channel, Activity.Type ]代理程式元件 否 唯讀欄位，填入指定代理程式的元件，例如主題、知識來源等。 選取 [儲存]。
設定新的代理程式以進行檔案同步處理
從組態型別中選取檔案同步。
除了基本組態之外，還輸入下列資訊：
欄位名稱 為必填項目 Description 客服專員 ID （機器人 ID） Yes 您目前選作目標之自訂 Agent 的機器人識別碼。 您可以在 Copilot Studio 的 設定 （ ） 中選取 工作階段詳細資料，以找到此識別碼。 尋找 Copilot ID。Dataverse URL Yes 自訂 Agent 位置所在 Dataverse URL，內容與之進行同步處理。 例如： https://organizationnname.crm.dynamics.com。 在 Copilot Studio 中從工作階段詳細資料取得 URL。 尋找執行個體 URL。新增至少一個 檔案索引子組態 ，並輸入下列資訊：
欄位名稱 為必填項目 Description 名稱 Yes 檔案索引子組態的名稱。 例如：人力資源文件。 Agent 設定 Yes 此記錄所屬的代理程式組態。 如果您透過代理程式配置視圖建立新記錄，則會自動填入此值。 網站位址 Yes 您要從中同步處理內容的 SharePoint 網站位址。 例如： https://organizationname.sharepoint.com/sites/sitename程式庫名稱 Yes 您正在從中同步內容的 SharePoint 網站的文件庫。 範例：文件 包含巢狀項目 Yes 指定內容同步是否限制在您指定的確切位置 （否），或該位置的子項目是否也包含在同步處理中 （是，預設）。 將條目限制為資料夾 否 選擇性地在文件庫中指定要同步處理的資料夾。 範例：/HR-documents SharePoint 檔案篩選查詢 否 選擇性地指定選取要同步化的檔案時要使用的篩選器。 保留空白，不進行額外的篩選。 範例：PublicContent eq 'true' 包含 SharePoint 頁面 否 選擇性地在同步處理中包含 SharePoint 頁面。 SharePoint 頁面篩選查詢 否 選擇性地指定選取要同步化的頁面時要使用的篩選器。 保留空白，不進行額外的篩選。 範例：PublicContent eq 'true' 或者，您可以從命令列選取 [驗證連線] 來驗證檔案索引子設定。
選取 [儲存]。
