偵錯 WebMCP 工具

使用 Chrome 開發人員工具中的 WebMCP 面板,檢查、偵錯及測試網站向 AI 代理程式公開的用戶端 AI 工具。這個面板可提供工具生命週期的完整端對端檢視畫面,包括註冊、結構定義驗證和叫用記錄。

開啟 WebMCP 窗格

「WebMCP」WebMCP窗格位於「Application」面板中。如要開啟,請按照下列步驟操作:

  1. 在採用 WebMCP 工具的網頁上開啟 Chrome 開發人員工具
  2. 按一下「應用程式」分頁標籤。
  3. 在側欄的頂層,選取「WebMCP」WebMCP窗格。
開發人員工具的「應用程式」面板,應用程式側欄中已選取「WebMCP」窗格。
開發人員工具的「應用程式」面板,且「應用程式」側欄中已選取「WebMCP」窗格。

介面總覽

「WebMCP」WebMCP面板採用雙窗格版面配置,可協助您管理及監控工具:

  • 已叫用的工具:AI 代理與網頁互動的時序記錄。
  • 可用工具:系統在有效分頁中偵測到的所有 WebMCP 工具即時清單。

可用的工具

「可用工具」部分會顯示工具名稱和說明,這些資訊會提供給 AI 代理。此外,每個工具也包含叫用計數器,顯示目前工作階段中工具的呼叫次數。

「可用工具」清單,顯示可點選的狀態圖示,用於篩選叫用計數器。
「可用工具」清單,顯示叫用計數器,以及可點選的狀態圖示,方便篩選。

叫用的工具

「Invoked tools」記錄會持續記錄工具互動。 選取記錄中的項目後,即可檢查下列詳細資料:

  • 狀態:呼叫結果 (已完成、已取消、處理中或錯誤)。
  • 輸入:代理預測並傳送至工具的確切參數。
  • 輸出:工具提供的傳回值或錯誤訊息。

篩選記錄

使用「篩選器」列,依下列條件縮小叫用工具的清單範圍:

  • 名稱或說明:輸入文字,找出符合特定名稱或用途的工具。
  • 狀態類型:依通話的目前狀態篩選,例如「已完成」、「錯誤」、「已取消」或「處理中」
  • 工具類型:選取要篩選的宣告式工具 (定義於 HTML) 和命令式工具 (定義於 JavaScript)。如要查看所有工具類型,請確認沒有啟用任何篩選器。

手動測試工具

您可以略過 AI 代理程式的決策邏輯,獨立測試工具的可靠性。這項功能有助於驗證函式邏輯,不必等待特定代理程式提示。

  1. 在「可用工具」清單中,按一下要測試的工具。 或者,在「Invoked Tools」(叫用的工具) 記錄中,將游標懸停在工具上,顯示「播放」(➜) 圖示,然後按一下該圖示。手動測試區域隨即開啟。注意:如果您從「可用工具」清單中選取工具,手動測試區域中的參數會是空白。否則,如果您選取已叫用的工具,手動測試區就會開啟,並預先填入該工作階段的參數。
  2. 在手動測試區域中,於輸入欄位中輸入或調整參數。
  3. 按一下「執行工具」
將游標懸停在「叫用的工具」清單中的項目上,顯示「播放」圖示,並開啟預先填入的手動測試區域。
將游標懸停在「已叫用的工具」清單中的項目上,即可顯示「Play」圖示,並開啟預先填入的手動測試區域。

排解整合問題

「WebMCP」WebMCP面板可協助您診斷常見的整合失敗問題:

  • 結構定義違規:如果工具參數或回傳值不符合定義的結構定義,輸出窗格就會顯示錯誤訊息。
  • 代理程式拒絕:查看「Available Tools」(可用工具) 清單中的叫用計數器,確認代理程式是否曾考慮將您的工具用於特定提示。

自動化與代理

WebMCP 專為代理式網路設計,AI 代理可探索及使用網站工具。如要進行代理程式輔助開發,Chrome 代理程式開發人員工具專案提供專用介面,可使用這個通訊協定協助 AI 代理程式測試及使用 WebMCP 工具。

指令列旗標

部分代理程式介面需要您明確啟用 --categoryWebMCP 標記。

相關資源

如要進一步瞭解 WebMCP 和代理程式網路,請參閱下列資源: