AI Agent 浏览器任务上线前的 Preflight Check 清单

环境栈笔记

170人浏览 · 2026-05-29 20:58:13

环境栈笔记 · 2026-05-29 20:58:13 发布

AI Agent 浏览器任务上线前，最容易被忽略的一步是 Preflight Check。

很多团队会先关注提示词、选择器、等待策略，但在真实运行中，任务稳定性往往先取决于环境对象是否可控。

如果 Profile、Session、Proxy 和任务入口没有固定，Agent 每次运行看到的页面状态可能都不同。

1. Preflight Check 的目标

Preflight Check 的目标不是替代自动化任务，而是在任务开始前确认运行条件。

它至少要回答三个问题：

问题	说明
任务在哪个环境里跑	能追溯 workspace_id、profile_id
任务开始时状态是否可用	能确认 Cookie、LocalStorage、IndexedDB
网络与浏览器信号是否一致	能确认 Proxy、地区、时区、语言

如果这些问题无法回答，就不应该直接执行高影响操作。

2. 上线前检查项

检查项	通过标准
Profile 是否固定	一个工作区绑定一个主 Profile
Cookie 是否可用	登录态正常，未过期
LocalStorage 是否完整	关键配置字段存在
IndexedDB 是否完整	本地队列和业务状态可读
Proxy 是否一致	地区、时区、语言匹配
任务是否绑定环境 ID	run_id 能追溯到 profile_id

这些检查建议在任务启动前自动执行。如果某一项不通过，应暂停任务，而不是继续重试。

3. 建议的配置结构

```yaml
workspace_id: workspace-cn-01
profile_id: profile-cn-01
network_policy_id: network-cn-stable
session:
require_cookie_valid: true
require_local_storage_ready: true
require_indexeddb_ready: true
browser:
require_timezone_match: true
require_language_match: true
automation:
run_if_profile_status: active
pause_on_session_invalid: true
save_step_evidence: true
```

这类配置不复杂，但能让任务具备可追溯性。

4. StepEvidence 建议字段

任务执行时，关键步骤建议保存证据：

字段	说明
step_id	步骤编号
action	执行动作
target	操作目标
url	当前页面 URL
page_title	页面标题
before_screenshot	操作前截图
after_screenshot	操作后截图
assertion	预期状态
result	实际结果
reason	Agent 或脚本判断理由

这些信息可以帮助定位“脚本成功但结果异常”的问题。

5. 失败分类

failure_type	含义	优先排查方向
session_invalid	会话不可用	Cookie、LocalStorage、登录状态
env_mismatch	环境不匹配	Profile、Proxy、时区、语言
page_changed	页面结构变化	DOM、选择器、页面版本
action_timeout	操作超时	网络、等待策略、页面加载
security_verification_required	需要安全验证	暂停任务，人工完成官方验证
agent_uncertain	Agent 判断不确定	保存证据，进入人工复核

这里要特别注意 security_verification_required。遇到平台安全验证时，应暂停并走官方验证入口，不建议让任务继续自动尝试。

6. 推荐上线流程

```text
resolve workspace
-> resolve profile
-> validate session
-> validate network policy
-> save environment snapshot
-> run task
-> save step evidence
-> classify failure
-> review if needed
```

如果团队需要把 Profile、代理、会话和 Agent 任务统一管理，可以参考浏览器环境管理工作台这种方向，把环境对象和任务入口放在同一套本地优先工作流里。