在 Azure AI 搜尋中偵錯會話
偵錯會話是一種可視化編輯器，可在 Azure 入口網站 中使用現有的技能集，公開單一擴充文件的結構和內容，因為索引器和技能集會在會話期間產生。 因為您正在使用即時檔，會話是互動式的 - 您可以識別錯誤、修改和叫用技能執行，以及即時驗證結果。 如果您的變更解決問題，您可以將這些變更認可到已發佈的技能集，以全域套用修正程式。
偵錯會話的運作方式
當您啟動會話時，搜尋服務會建立技能集、索引器和數據源的複本，其中包含用來測試技能集的單一檔。 所有工作階段狀態都會儲存至 Azure AI 搜尋服務 在您提供的 Azure 儲存體 帳戶中建立的新 Blob 容器。 產生的容器名稱具有 「ms-az-cognitive-search-debugsession」 前置詞。 需要前置詞，因為它可降低意外將會話數據匯出至帳戶中另一個容器的機會。
擴充檔與技能集的快取複本會載入至可視化編輯器，讓您可以檢查擴充檔的內容和元數據，並能夠檢查每個文件節點並編輯技能集定義的任何層面。 系統會快取會話內所做的任何變更。 除非您認可這些變更，否則這些變更不會影響已發佈的技能集。 認可變更將會覆寫生產技能集。
如果擴充管線沒有任何錯誤，偵錯會話可用來累加擴充檔、測試及驗證每個變更，再認可變更。
管理偵錯會話狀態
您可以使用 [開始] 按鈕重新執行偵錯會話，或使用 [取消] 按鈕取消進行中的會話。
AI 擴充索引標籤 > [技能圖表]
可視化編輯器會組織成索引卷標和窗格。 本節介紹可視化編輯器的元件。
Skill Graph 提供技能集的視覺階層，以及其從上到下的執行順序。 相依於其他技能輸出的技能在圖表中的位置較低。 階層中相同層級的技能可以平行執行。 圖形中技能的色彩編碼卷標會指出技能集 （TEXT 或 VISION） 中執行的技能類型。
選取圖形中的技能將會在右窗格中顯示該技能實例的詳細數據，包括其定義、錯誤或警告，以及執行歷程記錄。 Skill Graph 可讓您選取要偵錯或增強的技能。 右側的詳細數據窗格是您編輯和探索的位置。
[技能詳細數據] 窗格
當您在 Skill Graph 中選取物件時，相鄰窗格會在索引標籤式配置中提供互動式工作區域。 您可以在上一個螢幕快照中找到詳細資料窗格的圖例。
技能詳細數據包括下列區域：
- 技能 設定 顯示技能定義的格式化版本。
- 技能 JSON 編輯器 會顯示定義的原始 JSON 檔。
- 執行會顯示每次執行技能時所對應的數據。
- 錯誤和警告 會顯示會話啟動或重新整理時產生的訊息。
在 [執行] 或 [技能] 設定 上</>，選取符號以開啟用於檢視和編輯技能輸入和輸出表達式的表達式評估工具。
Skill 設定 中的巢狀輸入控件可用來建立投影的複雜圖形、複雜類型欄位的輸出字段對應，或技能的輸入。 搭配表達式評估工具使用時，巢狀輸入提供簡單的測試和驗證表達式產生器。
[執行] 窗格
技能可以在單一檔的技能集中執行多次。 例如，OCR 技能會針對從單一檔擷取的每個影像執行一次。 [執行] 窗格會顯示技能的執行歷程記錄，以更深入地查看技能的每個叫用。
執行歷程記錄可讓您追蹤產生特定擴充的技能。 按兩下技能輸入會巡覽至產生該輸入的技能，並提供類似堆疊追蹤的功能。 這可識別可能表現在下游技能中之問題的根本原因。
當您使用自定義技能對錯誤進行偵錯時，可以選擇在執行歷程記錄中產生技能調用的要求。
AI 擴充索引標籤 > 擴充數據結構
[ 擴充的數據結構] 窗格會透過技能集顯示檔的擴充，詳細說明每個擴充的內容和原始技能。 表達式評估工具也可以用來檢視每個擴充的內容。
運算式評估工具
表達式評估工具 可讓您快速查看任何路徑的值。 它允許在更新技能或投影的任何輸入或內容之前，編輯路徑並測試結果。
您可以從任何顯示 </> 符號的節點或項目開啟視窗，包括擴充樹狀結構中相依性圖形或節點的一部分。
表達式評估工具可讓您完整互動存取，以測試技能內容、輸入和檢查輸出。
下一步
既然您已了解偵錯會話的元素，請在現有的技能集上啟動您的第一個偵錯會話。