在 Microsoft 365 Copilot 中使用開發人員模式來測試和偵錯代理程式

測試是開發 Microsoft 365 Copilot 宣告式代理程式流程的重要部分。 您可以使用 Copilot Studio 中的開發人員模式來測試您的代理程式,並驗證 Copilot 協調器是否以及如何選取您的知識來源以用於回應指定的提示。

在 Copilot 中使用開發人員模式

若要在 Copilot 中啟用開發人員模式,請輸入 -developer on。 若要停用開發人員模式,請輸入 -developer off。

Microsoft 365 Copilot 工作階段的螢幕擷取畫面,使用者已輸入 '-developer on' 以成功啟用開發人員模式

啟用開發人員模式時,每當協調器在您的企業知識 (資料) 、功能或技能 (動作或外掛程式) 代理程式中專門搜尋以回應提示時,就會傳回包含偵錯資訊的卡片。 偵錯資訊卡包含下列欄位:

  • 代理程式中繼資料: 代理程式和交談的識別碼。
  • 功能:為代理設定的功能清單。
  • 動作:為代理程式設定的動作清單
    • 相符的函數:執行階段應用程式索引查閱中相符的函數狀態
    • 已選取要執行的函數:根據協調器推理選取要叫用的函數狀態
  • 執行: 針對提示,已執行功能和動作的清單
    • 已執行功能:已執行功能的狀態和回應統計資料。
    • 已執行的動作: 動作的要求和回應執行狀態。

代理程式中繼資料區段

Microsoft 365 Copilot 工作階段的螢幕擷取畫面,其中 Copilot 已傳回卡片,其中包含顯示代理程式中繼資料的偵錯資訊

代理中繼資料提供有關代理和當前偵錯工作階段的重要詳細資料,包括:

  • 代理程式識別碼 - 代理程式的唯一識別碼,包括標題識別碼和資訊清單識別碼。
  • 代理程式版本 — 目前使用中的代理程式版本號碼。
  • 交談識別碼 - 識別進行中的聊天工作階段或交談。
  • 要求識別碼 - 識別交談中的特定提示。

注意

代理程式識別碼中的前置詞表示代理程式的散發方式:

  • U_ 表示使用者範圍 (側載) 代理程式。
  • T_ 表示 (發佈至租用戶商店或組織目錄) 的租用戶範圍代理程式。
  • P_ 表示可公開使用的代理程式。

如需相關的發佈指導方針,請參閱:

代理程式功能

Microsoft 365 Copilot 工作階段的螢幕擷取畫面,其中 Copilot 已傳回卡片,其中包含顯示已設定代理程式功能的偵錯資訊

代理程式功能區段顯示代理程式的設定功能,定義其可存取知識來源的範圍。

重要

如果 [代理程式功能] 區段指出已啟用 WebSearch ,這僅表示代理程式已啟用此功能。 它不反映 Allow web search in Copilot 系統管理員可用來停用其組織的 Web 搜尋的雲端原則設定。 如需詳細資訊,請參閱在 Microsoft 365 系統管理中心管理 Microsoft 365 Copilot 案例。

代理程式動作

Microsoft 365 Copilot 工作階段的螢幕擷取畫面,其中 Copilot 已傳回卡片,其中包含顯示已設定代理程式動作的偵錯資訊

代理程式動作會顯示動作 ID 和版本號碼、動作的設定函數,以及其符合和選取狀態。

已啟用任何動作的卡片

如果未啟用任何動作,則 [動作] 區段會指出未啟用任何動作。

功能不相符的卡片

如果指定提示未傳回相符的函數,這可能表示提示未明確提及動作名稱。

執行詳細資料

[已執行的詳細資料] 區段會顯示是否以及針對提示執行了哪些已設定的功能或動作,以及執行詳細資料和狀態。

功能執行詳細資料

Microsoft 365 Copilot 工作階段的螢幕擷取畫面,其中 Copilot 已傳回卡片,其中包含顯示已執行功能的偵錯資訊

功能執行詳細資料會顯示已執行的功能及其狀態。 每個功能可能有不同的執行詳細資料,例如使用的搜尋文字、功能的回應和/或傳回的結果數目。

動作執行詳細資料

Microsoft 365 Copilot 工作階段的螢幕擷取畫面,其中 Copilot 傳回了一張卡片,其中包含顯示已執行動作的偵錯資訊

動作執行詳細資料包括函數及其狀態,以及延遲、請求端點 (請求資訊、HTTP 方法、請求標頭) 和回應。

已選取任何執行函數的卡片

如果沒有任何動作函數符合提示的搜尋意圖,偵錯資訊卡片會報告 [ 沒有選取任何要執行的函數]。 這可能是因為資訊清單中的命令描述在語義上與指定提示的搜尋意圖無關。

如果 Copilot 先前已成功比對並執行您的函數,這可能表示節流。

空白或失敗的卡片 無函數執行詳細資料

對於非訊息擴充功能外掛程式,如果有失敗或沒有函式執行詳細資料,則表示在代理程式嘗試將參數指派給外掛程式的所選函式期間發生失敗。 如果失敗是一致的,很可能是因為動作或參數描述不清楚、主機 URL 無效,或 Open API 定義的其他問題。

對於訊息擴充功能外掛程式,最佳做法是針對 9 秒內的回應進行最佳化。 如需詳細資訊,請檢閱訊息擴充外掛程式的 技術需求 。

目前,Copilot 執行外掛程式 API 的逾時限制設定為 10 秒。

疑難排解失敗

以下是偵錯代理程式時可能會遇到的常見失敗,以及失敗的可能原因。

沒有偵錯卡

如果 Orchestrator 不需要您的 Microsoft 365 資料或技能來回應提示,則不會傳回偵錯資訊卡片。

在容量節流的情況下,也不會傳回偵錯卡,您通常會看到錯誤訊息,稍後再試一次。

回報問題

使用 [大拇指向上] 或 [大拇指向下] 按鈕,回報與代理程式的任何意見反應或問題。 在您的報表中包含 #extensibility 標籤。

Microsoft 365 Copilot 豎起大拇指或拇指朝下意見反應選項的螢幕擷取畫面

在文字方塊中輸入訊息,包括 #extensibility 標籤。

文字方塊中 Microsoft 365 Copilot 意見反應的螢幕擷取畫面