调试 WebMCP 工具

使用 Chrome 开发者工具中的 WebMCP 面板检查、调试和测试您的网站向 AI 智能体公开的客户端 AI 工具。该面板可提供对工具生命周期的完整端到端可见性,包括注册、架构验证和调用历史记录。

打开 WebMCP 窗格

WebMCP 窗格位于 应用面板中。如需打开该窗格,请按以下步骤操作:

  1. 在使用了 WebMCP 工具的网页上打开 Chrome 开发者工具
  2. 点击应用 标签页。
  3. 在边栏的顶层,选择 WebMCP 窗格。
开发者工具“应用”面板,其中“应用”边栏中已选择“WebMCP”窗格。
开发者工具“应用”面板,其中在“应用”边栏中选择了 WebMCP 窗格。

界面概览

WebMCP 面板采用双窗格布局,可帮助您管理和监控工具:

  • 调用的工具 :AI 智能体与网页之间互动的时序日志。
  • 可用工具 :在活动标签页上检测到的所有 WebMCP 工具的实时列表。

可用工具

可用工具 部分会显示工具名称和说明,这些内容会显示给 AI 智能体。它还包含每个工具的调用计数器 ,用于显示在当前会话期间调用工具的次数。

“可用工具”列表,其中显示了调用计数器以及用于过滤的可点击状态图标。
“可用工具”列表,其中显示了调用计数器以及可点击的状态图标,以便进行过滤。

调用的工具

调用的工具 日志提供了工具互动的永久记录。在日志中选择条目后,您可以检查以下详细信息:

  • 状态 :调用结果(已完成、已取消、进行中或错误)。
  • 输入 :智能体预测并发送给工具的确切参数。
  • 输出 :工具提供的返回值或错误消息。

过滤日志

使用过滤条件 栏可根据以下条件缩减调用的工具列表:

  • 名称或说明 :输入文本以查找与特定名称或用途匹配的工具。
  • 状态类型:按当前状态过滤调用,例如已完成错误已取消进行中
  • 工具类型 :选择以过滤在 HTML 中定义的声明式 工具和在 JavaScript 中定义的命令式 工具。如需查看所有工具类型,请确保没有任何过滤条件处于活动状态。

手动测试工具

您可以绕过 AI 智能体的决策逻辑,以独立测试工具的可靠性。这有助于在无需等待特定智能体提示的情况下验证函数逻辑。

  1. 可用工具 列表中,点击要测试的工具。 或者,在调用的工具 日志中,将鼠标悬停在某个工具上以显示播放 (➜) 图标,然后点击该图标。手动测试区域随即打开。注意:如果您从“可用工具”列表中选择了该工具,则手动测试区域中的参数为空。否则,如果您选择了调用的工具,则手动测试区域会打开,并预先填充该会话中的参数。
  2. 在手动测试区域中,在输入字段中输入或调整参数。
  3. 点击 Run tool (运行工具)。
将鼠标悬停在“调用的工具”列表中的某个项上,以显示“播放”图标并打开预填充的手动测试区域。
将鼠标悬停在“调用的工具”列表中的某个项上以显示“播放”图标,并打开预先填充的手动测试区域。

排查集成问题

WebMCP 面板可帮助您诊断常见的集成失败问题:

  • 架构违规 :如果工具参数或返回值与定义的架构不匹配,输出窗格会显示错误消息。
  • 智能体拒绝 :检查可用工具 列表中的调用计数器,了解智能体是否曾考虑将您的工具用于给定的提示。

自动化和智能体

WebMCP 专为智能体网络而设计,AI 智能体可以在其中发现网站的工具并与之互动。对于智能体辅助开发,Chrome DevTools for agents 项目提供了一个专用界面,该界面使用此协议帮助 AI 智能体测试和使用 WebMCP 工具。

命令行标记

某些智能体界面要求您明确启用 --categoryWebMCP 标记。

相关资源

如需详细了解 WebMCP 和智能体网络,请参阅以下资源: