AI Agent 浏览器任务遇到安全验证时，如何设计暂停与人工复核流程

环境栈笔记

409人浏览 · 2026-05-31 20:31:24

环境栈笔记 · 2026-05-31 20:31:24 发布

I Agent 浏览器任务在真实运行中，最需要谨慎处理的一类异常是安全验证。

它和普通 timeout、选择器失效、页面加载慢不同。

安全验证通常意味着平台认为当前登录环境、网络环境或操作行为需要确认。这个时候继续自动点击、刷新、重试，往往会让问题更难排查。

更稳妥的做法是：识别验证状态，暂停任务，保存现场证据，进入人工复核。

1. 为什么安全验证不能当成普通失败

很多自动化任务失败后会进入统一 retry 流程：

```text
task failed -> retry -> retry -> retry
```

这对临时网络抖动可能有效，但对安全验证并不合适。

安全验证的本质不是“页面没加载出来”，而是“当前任务现场需要人工确认”。

如果继续自动重试，可能出现几个问题：

问题	影响
连续刷新验证页	让验证触发更频繁
自动重复提交	增加账号风控风险
覆盖现场截图	后续无法复盘
错误归类为 timeout	排查方向被带偏
继续执行后续步骤	在不可信状态下产生错误结果

所以安全验证应该是一个明确的失败类型，而不是普通异常。

2. 建议增加 security_verification_required

可以在失败分类中单独增加：

failure_type	含义	处理建议
security_verification_required	页面要求安全验证	暂停任务，人工完成官方验证
session_invalid	会话不可用	检查 Cookie、LocalStorage、IndexedDB
env_mismatch	环境不匹配	检查 Profile、Proxy、时区、语言
page_changed	页面结构变化	保存截图，确认是否改版
action_timeout	操作超时	检查网络、等待策略、页面加载
agent_uncertain	Agent 判断不确定	保存证据，进入人工复核

任务识别到 `security_verification_required` 后，不应该进入普通重试队列。

3. 识别安全验证时需要保存什么

安全验证出现时，最重要的是保留现场。

建议保存：

字段	说明
run_id	单次运行 ID
job_id	任务 ID
workspace_id	工作区 ID
profile_id	Profile ID
current_url	当前页面 URL
page_title	页面标题
screenshot	当前页面截图
detected_text	页面中识别到的提示文本
failure_type	security_verification_required
reason	Agent 或脚本判断理由
created_at	记录时间

这些字段能回答一个关键问题：

任务是在什么环境、什么页面、什么提示下被暂停的？

4. EnvironmentSnapshot 也要一起保存

安全验证往往和环境变化有关。

因此除了页面截图，还建议保存环境快照：

检查对象	建议记录	排查重点
Profile	profile_id、browser_version、extensions_hash	是否换过浏览器环境
Session	cookie_status、local_storage_status、indexeddb_status	登录态是否稳定
Proxy	proxy_id、region、exit_type	网络出口是否切换
Browser	timezone、language、user_agent_version	是否与账号环境一致
WebRTC	policy、observed_state	是否暴露异常网络信号
Automation	runner_version、entrypoint、job_id	是否从正确入口运行

如果这些字段没有记录，后续很难判断是页面变化、账号状态变化，还是运行环境变化。

5. 一个推荐的处理流程

可以把流程设计成：

```text
Start Task
-> Preflight Check
-> Execute Step
-> Detect Security Verification
-> Save StepEvidence
-> Save EnvironmentSnapshot
-> Pause Task
-> Push ReviewQueue
-> Manual Verify
-> Resume or Close
```

其中最重要的动作是 `Pause Task`。

只要识别到安全验证，就不要继续自动执行高影响操作。

6. 最小配置示例

```yaml
failure_policy:
security_verification_required:
retry_allowed: false
pause_immediately: true
save_screenshot: true
save_environment_snapshot: true
review_required: true
next_action: manual_official_verify

retry_policy:
retry_allowed_for:
- action_timeout
pause_immediately_for:
- security_verification_required
- session_invalid
- env_mismatch
- agent_uncertain
```

这个配置的核心思想很简单：

低风险异常可以有限重试。

安全验证、环境异常、会话异常必须暂停。

7. ReviewQueue 建议字段

人工复核队列可以包含：

字段	说明
review_id	复核任务 ID
run_id	关联运行 ID
failure_type	失败类型
priority	复核优先级
evidence_path	截图和日志路径
environment_snapshot_path	环境快照路径
assigned_to	负责人
status	pending / reviewed / resumed / closed
reviewer_note	复核说明

这样能让暂停后的任务有明确归属，不会卡在没人处理的状态。

8. 实践建议

遇到安全验证时，建议遵守几条原则：

原则	说明
不要自动绕过验证	走平台提供的官方验证入口
不要连续刷新重试	避免让验证触发更频繁
保存现场证据	保留截图、URL、标题、环境快照
固定 Profile	避免账号环境频繁变化
记录 Proxy 变更	排查地区、时区、语言不一致问题
人工确认后再恢复	复核通过后再继续任务