已註冊的 WebMCP 工具

註冊工具是網站向 AI 代理程式公開的特定功能 (例如「預訂座位」或「加入購物車」)。

已註冊的 WebMCP 工具稽核方式

這項稽核僅供參考，Lighthouse 會列出使用宣告式或命令式 API 在網頁上註冊的所有 WebMCP 工具。如果未註冊任何工具，結果清單就會空白。

如果註冊的工具超過 40 個，Lighthouse 會發出警告。如果納入過多工具，可能會耗用模型脈絡權杖、增加延遲時間，並提高代理程式混淆的風險，導致代理程式不知道該使用哪項工具。

如何修正

您可以使用 Declarative API 或 Imperative API 註冊工具：

  • 宣告式 API：直接在 <form> 元素中新增 toolname 和 tooldescription 屬性。
  • 命令式 API：使用 JavaScript 透過 document.modelContext.registerTool 註冊工具。

最佳做法

  • 使用包含具體動作的名稱 (例如 toolname="book_appointment")。
  • 提供詳細說明，解釋工具的作用和代理應使用工具的時機。
  • 請避免一次註冊超過 40 個工具。只有在工具對目前的網頁狀態有幫助時才註冊，不再需要時則取消註冊。
  • 如要瞭解詳情，請參閱 WebMCP 說明文件。