使用 AI 智能体调试 WebMCP 工具

WebMCP 是一项拟议的 Web 标准,旨在让网站将其功能公开为可由 AI 智能体调用的结构化工具。借助面向智能体的 Chrome 开发者工具,您的编码智能体可以直接与这些工具互动,帮助您分析网站并就如何让网站做好 WebMCP 准备提供建议。

通过使用适用于智能体的开发者工具,您可以验证应用是否正确公开了 WebMCP 工具,测试这些工具的执行情况,并确定 AI 智能体可以从您网站上公开的哪些额外功能中受益。借助 Modern Web Guidance 中包含的智能体技能,您可以在网站上实现 WebMCP。

使用 WebMCP 时,请注意以下几点:

  • 实验性标志:WebMCP 类别默认处于非活跃状态。使用 --categoryExperimentalWebmcp 标志。如需详细了解如何参与,请参阅 WebMCP 源试用。
  • 浏览器要求:此功能需要 Chrome 149 及更高版本,且已启用 WebMCP 功能。这意味着,您测试的网站已加入 WebMCP 源试用,或者您已在本地 Chrome 浏览器中手动启用相应的 WebMCP 标志。
  • 目标受众群体区分:虽然 DevTools MCP 服务器是一项面向开发者的调试功能,但任何使用浏览器代理与网站互动的人都可以调用 WebMCP 工具。面向智能体的开发者工具可帮助您构建和测试这些面向用户的 WebMCP 工具。

测试和调试 WebMCP 工具的应用场景

您可以通过多种方式使用 WebMCP。 每个网站各不相同,每套 WebMCP 工具也是如此。按照我们的框架,了解如何为您的网站或 Web 应用定义和构建实用工具。

例如,如果您有一个旅行社网站,其中包含可帮助用户代理完成相关操作的工具,那么您可以使用以下示例提示搭配开发者工具,让代理测试您的工具是否按预期运行。

指示智能体列出并执行 WebMCP 工具,以简化测试和开发流程。

注意:代理执行步骤是潜在行为的示例。由于代理有很多不同的类型,并且代理是不确定的,因此您可能会看到不同的结果。

验证 WebMCP 工具曝光情况

为网站添加 WebMCP 支持后,您可以让编码代理验证工具是否已正确向浏览器公开,以及其输入架构是否已明确定义。

提示示例:

Implement a 'book_flight' WebMCP tool to this page to help agents book flights. Verify that it's correctly registered and ready for AI agents to use.

智能体执行示例:智能体检测到需要检查公开的工具,并自主调用 list_webmcp_tools 工具。它会解析输出,确认您的工具是否已成功注册,并验证架构是否格式正确。

调试 WebMCP 工具执行

确认当 AI 使用特定输入调用 WebMCP 工具时,该工具的内部逻辑是否按预期运行。您可以指示智能体执行该工具并监控应用的响应。

提示示例:

Try using the 'add_to_cart' tool on this page to add product 12345. Let me know if it succeeds or if the application throws any errors.

智能体执行示例:您的智能体识别出测试特定操作的 intent。它可自主确定正确的输入架构,使用 execute_webmcp_tool 高效运转该架构,并监控应用响应(包括检查控制台日志),以报告成功状态或调试任何失败情况。

排查架构清晰度问题

如果 AI 智能体反复未能正确调用 WebMCP 工具,通常是因为 JSON 架构不明确。您可以让智能体从 LLM 的角度审核架构,并提出改进建议。

提示示例:

My 'schedule_meeting' tool is failing to parse the various date formats sent by different AI agents. Can you review the tool's schema and suggest how I can improve the descriptions or constraints so agents know exactly which format is required?

代理执行示例:您的代理会提取公开的 WebMCP 工具,并分析 inputSchema 中是否存在“schedule_meeting”。它会发现日期参数缺少明确的说明或格式限制,并建议您在代码中实现更正后的 JSON 架构(例如,添加“Date in YYYY-MM-DD format”之类的说明)。