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