调试 WebMCP 工具

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

打开 WebMCP 窗格

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

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

界面概览

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

  • 调用的工具：AI 智能体与网页之间互动的按时间顺序排列的日志。
  • 可用工具：当前有效标签页上检测到的所有 WebMCP 工具的实时列表。

可用工具

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

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

调用的工具

调用的工具日志会永久记录工具互动。 选择日志中的条目后，您可以检查以下详细信息：

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

过滤日志

使用“过滤条件”栏可根据以下条件缩小所调用工具的列表范围：

  • 名称或说明：输入文字以查找与特定名称或用途匹配的工具。
  • 状态类型：按通话的当前状态（例如已完成、出错、已取消或正在进行）过滤通话。
  • 工具类型：选择此项可过滤 HTML 中定义的声明性工具和 JavaScript 中定义的命令性工具。如需查看所有工具类型，请确保这两个过滤条件均未处于有效状态。

手动测试工具

您可以绕过 AI 代理的决策逻辑，单独测试工具的可靠性。这有助于验证函数逻辑，而无需等待特定的代理提示。

  1. 在可用工具列表中，点击要测试的工具。 或者，在调用的工具日志中，将鼠标悬停在某个工具上以显示播放 (➜) 图标，然后点击该图标。系统会打开手动测试区域。

  2. 在手动测试区域中，在输入字段中输入或调整参数。

  3. 点击运行工具。

将鼠标悬停在“调用的工具”列表中的某个项上，以显示“播放”图标并打开预填充的手动测试区域。

排查集成问题

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

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

自动化和智能体

WebMCP 专为智能体网络而设计，可让 AI 智能体发现并与您网站的工具互动。对于智能体辅助开发，Chrome 智能体开发者工具项目提供了一个专用接口，该接口使用此协议来帮助 AI 智能体测试和使用您的 WebMCP 工具。

命令行标志

如需与某些智能体接口互动，您必须明确启用 --categoryWebMCP 标志。

相关资源

如需详细了解 WebMCP 和代理式 Web，请参阅以下资源：