測試您的代理程式

當您在 Copilot Studio 中設計代理程式時，您可以使用測試代理程式窗格來查看代理程式如何引導客戶完成交談。

為了協助您尋找和修正未預期的行為，您可以在各主題間進行追蹤，逐步引導您進行代理程式交談，並移至製作畫布中的對應節點。

Web 應用程式

使用測試您的代理程式窗格，以使用者身分瀏覽您的代理程式交談。 這是個好方法，可確保您的主題正常運作並讓交談如預期那樣流暢。

預覽交談

1. 如果測試您的代理程式窗格被隱藏，請透過選擇任意頁面頂部的測試將其開啟。

   

2. 在測試您的代理程式窗格底部的欄位中，輸入一些文字。 如果文字類似於主題的觸發字詞，則該主題會開始。

3. 在測試您的代理程式窗格中選擇代理程式回應。 這會將您引導至傳送回覆的主題和節點。 已觸發的節點會具有彩色核取標記和彩色底部邊框。

   

   當您繼續在活動主題中進行交談時，請注意，觸發的每個節點都標有核取方塊和下邊框，並位於畫布的中心。

4. 如果您想自動追蹤整個交談 (當交談從一個主題移動到另一個主題時)，請開啟測試您的代理程式窗格頂部的追蹤。

   

5. 繼續交談，直到其按預期進行並讓您感到滿意為止。

您可以在與測試代理程式互動時隨時更新主題。 只需儲存您的主題即可套用變更並繼續與您的代理程式交談。

儲存主題時，並不會自動清除您的交談。 如果您在任何時候想要清除測試代理程式的交談並重新開始，請選擇重設圖示。

測試變數值

您可以在測試代理程式時觀察變數的值。

1. 選擇輔助工具列上的變數以打開變數窗格。

   

2. 切換到測試索引標籤並展開所需的變數類別。

   在繼續測試交談時，您可以監視正在使用的變數的值。

   

3. 若要檢查變數屬性，請選擇所需的變數。 此時將顯示變數屬性面板。

   

有關使用「變數」窗格測試槽填入的資訊，請參閱在代理程式中使用實體和槽填入。

儲存交談快照集

在測試代理程式時，您可以擷取交談內容和診斷資料，並將其儲存為文件。 然後，您可以分析資料來解決問題，例如代理程式未按您預期的方式回應。

警告

快照檔案包含您的所有代理程式內容，其中可能包含敏感資訊。

1. 在測試您的代理程式窗格的頂部，選擇「更多」圖示 (...)，然後選擇儲存快照。

   

   將顯示一則訊息，通知您快照檔案可能包含敏感資訊。

2. 選擇儲存將代理程式內容和工作階段診斷資訊儲存在名為 botContent.zip 的 .zip 檔案中。

   botContent.zip 封存包含兩個檔案：

   • dialog.json 包含交談診斷，包括錯誤的詳細描述。
   • botContent.yml 包含代理程式的主題和其他內容，包括實體和變數。

管理連線

如果您的代理程式需要使用者連線，若要管理測試聊天使用的連接，請選擇測試窗格頂部的更多圖示 (...)，然後選擇管理連線。

傳統

在測試機器人窗格中測試主題

使用測試機器人窗格，以使用者身分瀏覽 Bot 交談。 這是個好方法，可確保您的主題正常運作並讓交談如預期那樣流暢。

1. 如果測試機器人窗格已隱藏，請選取側邊面板底部的測試您的機器人來開啟。

   

2. 選取測試機器人窗格頂端的重設圖示可清除先前的交談。

   重設可以更輕鬆地跟隨目前主題的流程，而不會因先前的交談而混淆。

   

3. 出現輸入您的訊息提示時，輸入主題的其中一個觸發字詞。

透過主題的交談路徑進行追蹤

觸發字詞開始交談。 測試機器人窗格會顯示 Bot 的回覆，以及您指定的使用者回覆選項。

1. 繼續進行交談，測試其流程是否如您在主題中設計時預期的那樣順暢。

2. 您隨時可以返回主題的製作畫布，以修訂其交談路徑。 將變更儲存至主題時，測試聊天窗格會自動重新整理。

儲存交談快照集

在測試機器人時，您可以擷取交談內容和診斷資料，並將其另存為檔案。 然後再分析資料來協助疑難排解問題，例如機器人未依預期的方式進行回應。

警告

快照集檔案包含所有的 Bot 內容，其中可能包含敏感性資訊。

1. 在測試機器人窗格頂端，選取更多圖示 (⋮)，然後選取儲存快照集。

   

   將顯示一則訊息，通知您快照檔案可能包含敏感資訊。

2. 選擇儲存，將機器人內容和交談診斷儲存在名為 DSAT.zip 的.zip 封存中。

   DSAT.zip 封存包含兩個檔案：

   • dialog.json 包含交談診斷，包括錯誤的詳細描述。
   • botContent.json 包含機器人的主題及其他內容，包括實體和變數。

Teams

在測試機器人窗格中測試主題

1. 如果測試機器人窗格被隱藏，請透過在導覽功能表中選擇測試您的聊天機器人將其開啟。

   

2. 在測試機器人窗格的頂端選取重設可清除先前的交談。 清除先前的交談可讓您更容易查看想要查看的主題流程，而不被先前的交談困擾。

   

3. 在測試機器人窗格底部的輸入您的訊息提示字元，輸入主題的觸發字詞。

   觸發字詞會開始主題的交談，而測試機器人窗格會顯示您指定的機器人回覆和使用者回覆選項。

4. 繼續進行交談，測試它是否按照主題中的設計方式流動。

5. 在測試機器人窗格中選取回覆，這會引導您進入交談編輯器中該主題的回覆。 製作畫布會以綠色顯示醒目提示的節點。

   

您隨時可以返回主題的製作畫布，以修正它的交談路徑。 當您將變更儲存至主題時，測試聊天窗格會自動自行重新整理。

透過主題的交談路徑進行追蹤

在您微調機器人時，在主題間進行追蹤非常有用，因此您可以逐步瀏覽交談路徑。

1. 如果測試機器人窗格被隱藏，請透過在導覽功能表中選擇測試您的聊天機器人將其開啟。

   

2. 在測試機器人窗格的頂端，將逐一追蹤主題設為開啟。

   

3. 為想要檢查的主題輸入觸發字詞，然後繼續測試交談。

4. 當您在測試機器人窗格中瀏覽交談時，製作畫布會醒目提示交談路徑中的目前位置。 製作畫布會以綠色顯示醒目提示的節點。

5. 若要在製作畫布中瀏覽至交談路徑的先前位置，請在測試機器人窗格中選取它。

如果測試您的機器人窗格中的交談路徑從一個主題移至另一個主題，製作畫布就會重新整理並移至適當的醒目提示節點。

注意

透過報告問題幫助我們改進 Copilot Studio。 使用測試窗格頂端附近的「旗標」圖示將交談 ID 提交給 Microsoft。 ID 是 Microsoft 用來解決交談中問題的唯一識別碼。 當您回報問題時，並不會傳送其他資訊，例如對話快照檔案中儲存的訊息。 所有收集的資訊都是匿名的，並將用來協助改善副手品質。