秘訣
推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。
測試是開發 Microsoft 365 Copilot Chat 宣告式代理程式流程的重要部分。 您可以在測試代理程式時使用 開發人員模式 ,以驗證 Copilot 協調器是否以及如何選取您的知識來源以用於回應指定的提示。
此外,您可以使用 Microsoft 365 Agents Toolkit 中的 [預覽您的應用程式] (F5) 功能,在本機開發環境中測試您的代理程式。 此功能提供一種互動式方式,可直接從開發介面驗證行為並疑難排解問題。
在 Copilot Chat 和代理程式工具組中使用開發人員模式
您可以在 Visual Studio Code 中的 Agents Toolkit 中,透過選取 [Agents Toolkit] 窗格中的 [預覽應用程式] (F5) 來測試您的代理程式。 這會在您的代理程式以瀏覽器為基礎的 Copilot Chat 體驗中啟動,讓您能夠快速驗證其回應提示的行為方式。
在 Microsoft 365 Copilot Chat 中選取代理程式後,請輸入以-developer on啟用開發人員模式。 若要停用開發人員模式,請輸入 -developer off。
啟用開發人員模式時,每當協調器在您的企業 (知識中搜尋資料) 、功能或技能 () 代理程式中的動作或外掛程式時,就會傳回包含偵錯資訊的卡片。 在 Agent Toolkit 中,此偵錯資訊會顯示在 偵錯面板 中,並包含下列欄位:
- 代理程式中繼資料:代理程式和交談的識別碼
- 功能:為代理程式設定的功能清單,以及其執行狀態和回應統計資料,如果執行) (
-
動作:為代理程式設定的動作清單
- 相符的函數:執行階段應用程式索引查閱中相符的函數狀態
- 已選取要執行的函數:根據協調器推理選取要叫用的函數狀態
代理程式中繼資料區段
代理中繼資料提供有關代理和當前偵錯工作階段的重要詳細資料,包括:
- 摘要 - 已設定知識來源及其使用統計資料的高階概觀
- 代理程式識別碼 - 代理程式的唯一識別碼,包括標題識別碼和資訊清單識別碼
- 代理程式版本 – 目前使用中的代理程式版本號碼
- 交談識別碼 - 進行中的聊天工作階段或交談的識別碼
- 要求識別碼 - 交談中特定提示的識別碼
代理程式功能
代理程式功能區段顯示代理程式的已設定功能,定義其可存取知識來源的範圍。 針對提示所使用的每個功能,提供下列詳細資料。
- 執行狀態 — 指出在協調流程期間是否使用此功能
- 診斷記錄檔 — 可下載的 .txt 檔案,包含詳細的執行結果,包括成功或失敗訊息,有助於進行疑難排解和驗證
代理程式動作
「代理程式動作」區段提供有關代理程式的動作 (功能或外掛程式) 在協調流程期間如何處理的詳細見解。 此資訊分為三個關鍵區域: 動作元資料、 函數比對和選擇,以及 執行詳細資訊。
動作中繼資料
此區段顯示有關為代理程式註冊的動作的一般資訊。 此資訊包括 動作識別碼 (動作) 的唯一識別碼,以及) 使用中的動作定義版本 (版本 號碼 。
函數比對和選擇
此部分顯示協調器如何解譯使用者提示,以及是否有任何函式被視為與執行相關:
相符的函數 — 在執行階段應用程式索引查詢期間,在語意上符合使用者提示的函數。 如果指定提示未傳回相符的函數,則提示可能未明確提及動作名稱。
選取執行的函數 — 根據協調器的推理和與提示的相關性選擇要叫用的函數。 如果未啟用任何動作,則 [動作] 區段會指出未啟用任何動作。
執行詳細資料
動作執行詳細資料包括函數及其狀態,以及延遲、請求端點 (請求資訊、HTTP 方法、請求標頭) 和回應。
疑難排解失敗
以下是偵錯代理程式時可能會遇到的常見失敗,以及失敗的可能原因。
沒有偵錯資訊
啟動代理程式後,請檢查在偵錯面板中與瀏覽器的連線是否已標示為成功。 如果沒有,請嘗試在 Visual Studio Code 中再次按 F5 以啟動新的工作階段。
如果連線成功,但您沒有看到偵錯資訊,可能是因為協調器不需要您的 Microsoft 365 資料或技能來回應。 在此情況下,不會傳回偵錯資訊卡。
在容量節流的情況下,也不會傳回偵錯資訊,您通常會看到錯誤訊息,稍後再試一次。
偵錯資訊 未 選取任何執行的函數
如果沒有任何動作函數符合提示的搜尋意圖,偵錯資訊卡片會報告 [ 沒有選取任何要執行的函數]。 原因可能是資訊清單中的命令描述在語義上與指定提示的搜尋意圖無關。
如果 Copilot 先前已成功比對並執行您的函數,則要求可能會受到節流。
偵錯資訊為空白或失敗 無函數執行詳細資料
對於 API 外掛程式,如果有失敗或沒有函式執行詳細資訊,則表示在代理程式嘗試將參數指派給外掛程式的所選函式時發生失敗。 如果失敗是一致的,很可能是因為動作或參數描述不清楚、主機 URL 無效,或 Open API 定義的其他問題。
對於訊息擴充功能外掛程式,最佳做法是針對 9 秒內的回應進行最佳化。 如需詳細資訊,請檢閱訊息擴充外掛程式的 技術需求 。
目前,Copilot 執行外掛程式 API 的逾時限制設定為 10 秒。
回報問題
使用 [大拇指向上] 或 [大拇指向下] 按鈕,回報與代理程式的任何意見反應或問題。 在您的報表中包含 #extensibility 該標籤。