用途
browse 是一个直接建立在 agent-browser CLI 之上的浏览器自动化工作流技能。当你需要通过浏览器打开页面、检查页面内容、按流程进行点击、填写表单、截图保存等操作时可以使用它。该技能主张直接使用 agent-browser,保持命令显式,优先使用内置的会话模型,而不是再增加一层包装。
前置要求
- agent-browser 必须可在 PATH 中找到。
- 如果缺少浏览器二进制文件,请运行 agent-browser install 进行安装。
- 除非需要隔离环境,否则复用默认会话;工作流结束时使用 agent-browser close 关闭会话。
- 如果 agent-browser 缺失,应先明确告知用户如何安装再继续。
默认流程
agent-browser open https://example.com
agent-browser wait --load networkidle
agent-browser snapshot -i
当选择器不明确时,使用 snapshot -i 生成快照,然后使用快照输出中的 @ref 目标进行交互。
主要能力(命令映射)
打开或导航:
agent-browser open https://example.com
agent-browser back
agent-browser forward
agent-browser reload
检查内容:
agent-browser get title
agent-browser get url
agent-browser get text body
agent-browser get html main
agent-browser snapshot -i
交互操作:
agent-browser click @e3
agent-browser fill @e4 "test@example.com"
agent-browser type @e5 "hello"
agent-browser press Enter
agent-browser select @e6 option-a
agent-browser upload @e7 /tmp/file.png
agent-browser wait @e8
视觉检查:
agent-browser screenshot /tmp/page.png
agent-browser screenshot --full /tmp/page-full.png
agent-browser pdf /tmp/page.pdf
调试:
agent-browser console
agent-browser errors
agent-browser network requests
agent-browser eval "document.title"
状态与标签页:
agent-browser cookies get
agent-browser storage local get
agent-browser tab new
agent-browser tab list
agent-browser tab 2
agent-browser close
使用方式与工作规则
- 在导航密集的步骤之后,优先使用 wait --load networkidle。
- 当页面不够稳定、无法使用 CSS 选择器时,在 click、fill 或 select 之前优先使用 snapshot -i。
- 在断定页面损坏之前,先使用 console、errors 和 network requests 进行检查。
- 当持久登录或浏览器配置文件很重要时,使用 --profile <path>。
- 当同一任务中需要独立的浏览器上下文时,使用 --session <name>。
- 如果 agent-browser 缺失,应告知用户确切的安装方法后再继续。
适用场景
该技能适用于需要浏览器自动化的各类任务,例如:打开并浏览页面、读取页面文本或标题、按流程点击、填写和提交表单、上传文件、选择下拉选项、截图或导出 PDF、检查控制台错误与网络请求、管理 Cookie 与本地存储、以及多标签页操作。
限制
- 必须预先安装 agent-browser,且其必须在 PATH 中可用;缺少浏览器二进制文件时需先安装。
- 该技能本身未提供关于计费、价格、平台支持范围或效果保证的信息,这些内容暂未提供。
- 使用时应遵循显式命令与内置会话模型,避免额外包装层。