使用 AI 智能体调试 WebMCP 工具

Matthias Rohmer
Matthias Rohmer
José Luis Zapata
José Luis Zapata

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”之类的说明)。