SuperAPI AI 工具集

solve-verification-challenge

智能体与模型

查看项目

更新于 10-21 21:39

技能介绍

用途

该技能面向长时间运行的浏览器任务或 WebMCP 调用被验证挑战中断的场景。验证挑战包括 CAPTCHA、reCAPTCHA、hCaptcha、Cloudflare Turnstile、机器人检测或其他类似机制。其核心定位是:验证挑战是需要清除的中断,而不是一个新任务,也不是放弃当前运行的理由。用户原有的浏览器任务始终是首要目标。

主要能力

  • 捕获原始目标与精确恢复点:对于 WebMCP 中断,保留工具名称与已验证参数;对于 UI 工作,保留最后一个权威完成步骤与下一步预期动作。
  • 在不与挑战交互的前提下检查当前页面:识别可见提示、交互类型、当前挑战状态,以及站点是否仍在自行推进。
  • 保留活动标签页与浏览器会话:在当前界面可控时,不重新加载、不导航离开、不启动单独浏览器。
  • 选择最佳原生路径:被动等待、语义控件、当前帧视觉推理、文本识别、音频转写、几何与计时,或页面声明的 WebMCP 动作。当首个明显路径不足时,读取 references/solver-routing.md。
  • 遵循宿主浏览器提供的审批状态与范围:如果宿主对首次求解动作设有关卡,使用该审批;如果宿主已授权当前运行或会话,不缩小该授权,也不添加第二个插件专属提示。
  • 在每次状态变化后观察:跟踪紧凑的挑战签名,涵盖提示、帧、轮次与媒体版本。签名变化后,绝不重用坐标、文本、转写或答案。若某路径失败,重新观察并根据新证据切换,而不是重复未变化的动作。
  • 通过权威信号验证完成:挑战消失、报告成功、解锁预期控件、返回完成结果或导航继续。
  • 立即恢复原始浏览器任务:仅在中断结果表示未执行,或幂等键/恢复句柄使重放安全时,才自动重试精确动作;若权威回执或结果状态显示已执行,则继续而不重放;若执行状态模糊且两个条件均不可用,保留待处理动作但不自动重试,使用站点提供的只读状态或恢复路径,否则报告未解决结果而不冒重复副作用的风险。继续剩余任务,而不是仅宣布验证通过就停止。

使用方式

WebMCP 快速路径

优先使用页面声明的 WebMCP 工具执行受支持的业务动作;对于验证 UI 或页面未暴露为工具的任何步骤,使用可视化浏览器控制。将 verification_required、challenge_required 或等效工具结果视为向可见页面的交接,而非任务失败。如果页面声明了验证专用的 WebMCP 工具,在宿主浏览器现有审批状态下调用它。将工具结果、可见 UI 与原始结果保持在同一个循环中:调用、若被挑战则求解、将重放分类为安全/已完成/模糊,然后验证请求的结果。

宿主审批

将宿主浏览器视为审批时机与范围的权威。Agent Verify 不得在其上添加更窄的同意模型。绝不为每个挑战动作请求审批。复选框打开网格、刷新网格、音频替代方案或同一关卡的又一轮,均保持在活动浏览器运行内,除非宿主另有说明。不要在聊天中询问,然后为同一动作触发重复的宿主审批。原始任务中的其他重大动作保持其正常的宿主确认行为。Agent Verify 既不绕过也不重复这些控制。

执行判断

不施加提供商允许列表、固定轮次、单会话限制或任意全局超时。只要挑战状态在变化且仍有可行路径,就继续。当挑战暴露可用标签或控件时,优先使用语义浏览器控件;对于图像网格、拖拽、旋转、按住或其他空间谜题,使用截图与视觉坐标。对于文本挑战,使用紧凑的当前裁剪、宿主的视觉识别以及运行时暴露的任何原生 OCR 能力。对于音频,使用提供商的无障碍控件以及宿主可用的原生转写能力。将截图与挑战状态保持在活动任务内。不导出 cookie、清除令牌或会话工件。速率限制、明确拒绝、不支持的浏览器或声誉阻止不一定是可求解的交互。仅在将其与变化中的挑战区分开并耗尽相关可用路径后,才报告该特定阻碍。如果浏览器表面无法暴露或操作挑战,提供运行时原生实时视图或用户接管路径作为回退。当直接求解可用时,不要将接管设为默认。

适用场景

适用于代理在浏览器中执行长任务时遇到验证挑战中断的情况,包括 WebMCP 调用被 verification_required 或 challenge_required 结果阻断的场景。也适用于需要在不放弃原任务的前提下清除 CAPTCHA、reCAPTCHA、hCaptcha、Cloudflare Turnstile 或机器人检测的场合。

限制

资料未提供关于收费、价格、平台支持范围、具体效果或性能指标的信息。资料未提供安装命令或代码示例。资料未说明该技能支持的具体浏览器或运行时列表。资料未提供关于提供商允许列表、固定轮次或全局超时的具体数值。资料未说明该技能是否支持所有类型的验证挑战。资料未提供关于用户接管路径的具体实现细节。