浏览器自动化
浏览器自动化让 Agent 通过内置能力操作 Captain Who 右侧栏中的受管浏览器。它适合点击、填写、翻页、截图和下载;如果只需要搜索和读取网页,优先使用更简单的联网搜索。
开启能力
- 打开“设置 → 浏览器”。
- 找到“浏览器自动化”。
- 打开“允许使用浏览器自动化”。
- 返回任务。
这个开关只允许 Agent 在任务中申请激活能力,并不是对所有网页操作的永久授权。任务运行时仍可能出现“启用浏览器自动化”或敏感操作审批。
准备浏览器页面
- 打开右侧栏“新建面板 → 浏览器”。
- 访问目标网站。
- 如果任务需要登录,建议先由你手动完成登录,并确认当前账户和环境。
- 回到对话,明确允许操作的站点、目标和禁止动作。
例如:
使用右侧栏浏览器查看当前已登录项目的构建记录。只读,不触发重跑、不修改设置、不下载文件。汇总最近三个失败任务的错误原因。
Agent 也可以请求创建或选择受管页面,但不会接管系统 Chrome、Safari、Edge 或任意远程调试端口。
任务会记住自己选定的页面。你切换标签查看其他网站,不会改变 Agent 后续操作的目标;Agent 明确选择或新建页面时,才会更新自己的目标。你仍然可以和 Agent 同时操作网页,不需要先暂停或接管。
正在作为 Agent 目标的标签会显示一圈高亮边框,左侧网站图标上覆盖机器人操作电脑的图标。标记在两次工具调用之间保持,任务结束后消失。如果你关闭了目标页面,Agent 需要重新选择或新建页面,才能继续操作。
审批敏感动作
以下操作可能要求单独审批,或直接被安全边界拒绝:
- 上传或读取本地文件。
- 下载内容和导出 Artifact。
- 访问 Cookie、local/session storage 或导入导出浏览器状态。
- 访问本机、内网、云服务内部地址、非标准端口或带凭据的 URL。
- 执行页面脚本、不安全代码或敏感网络读取。
- 新窗口、风险升级或目标身份变化。
审批绑定当前 Run、工具、参数和网页目标。页面导航、DNS 或参数发生变化时,系统可能要求重新审批。
上传和下载
Agent 可以上传任务中已有权限读取的附件、工作区文件和下载文件,包括刚生成的文件,无需重新通过系统文件选择器选择。要上传新文件,可先将它添加为任务附件或放入已授权的工作区,再说明目标网站和文件。审批前确认网站、文件和提交动作。
下载会保存到“设置 → 浏览器”中配置的系统默认或自定义下载目录,并登记为不向模型暴露绝对路径的持久下载记录。手动下载可以选择“下载前询问保存位置”;Agent 发起的下载不会弹出保存对话框打断后台运行,而是直接使用已配置目录。
浏览器工具只向 Agent 返回 browser-download: 安全引用、文件名、类型、大小和校验信息。下载完成后,可以在浏览器工具栏的下载中心查看进度、暂停、继续、停止、定位文件或从列表移除;完整记录可在“设置 → 浏览器 → 下载历史记录”搜索和管理。
登录状态和清理
网站的登录弹窗会显示为 Captain Who 管理的独立小窗口,默认大小为 520 × 680,打开时相对主窗口居中。窗口标题为 CaptainWho-当前网页链接,随页面跳转更新。你可以在窗口中登录,网站能够将结果传回原页面并自动关闭弹窗。网站主动隔离窗口的安全设置仍会生效。
手动浏览器与浏览器自动化共享应用内受管会话,Cookie 和站点存储会跨页面和应用重启保留。任务完成后,如不希望保留登录状态,打开浏览器菜单并选择“清除浏览数据”;可以按时间范围选择历史、Cookie/站点数据、缓存或下载历史。清除下载历史不会承诺删除磁盘上的已下载文件。
网页的摄像头、麦克风、定位、系统通知等权限请求始终被拒绝,Agent 审批也不能绕过这一固定边界。
如何写安全的浏览器任务
包含四项:
- 目标站点和账户环境。
- 允许的动作,例如“只读”“可填写但提交前停下”。
- 禁止的动作,例如“不发送、不购买、不删除”。
- 验收方式,例如“截图关键页面并列出 URL”。
对于提交、购买、发布、删除等不可轻易撤销的操作,要求 Agent 在最终点击前暂停并说明页面状态。
出错与结果未知
网页可能在工具调用后立即跳转,或在调用执行期间关闭。超时、取消、浏览器崩溃或通信中断时,Captain Who 会区分“尚未发送”和“可能已经执行”。后者不能自动重试;先打开网站核对真实状态。
多个浏览器操作会依次执行。排队不会占用操作本身的执行时间;如果等候超时,系统会明确说明操作尚未执行,可以等当前操作或审批结束后重试。
当前限制
- 只控制 Captain Who 应用内的受管浏览器会话。
- 只支持审查过的内置浏览器工具;未知或目录发生变化的工具会被拒绝。
- 网页 PDF 导出目前支持不含跨进程嵌入内容的页面。部分带第三方 iframe 的页面暂不支持;如果打印超时并持续阻塞后续导出,可关闭发起打印的页面后重试。
- 网站系统权限全部拒绝,仅支持 HTTP/HTTPS 和窄化的内部 PDF 查看。
- 下载文件和下载历史会持久保存。历史页按文件是否存在、是否仍为普通文件和大小是否变化显示可用性;它不检测同尺寸内容替换,Agent 真正把下载作为文件输入时会再校验内容身份。
- 截图等非下载 Browser Artifact 仍是 Run 范围的临时资源,不等同于下载文件。