跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.bubench.lexmount.io/llms.txt

Use this file to discover all available pages before exploring further.

browser-use 是一个基于 Python 的浏览器代理，提供可编程的浏览器自动化能力，支持本地 Chrome、Lexmount 云浏览器和 AgentBay 云浏览器。

​
安装

# 创建并激活项目虚拟环境
uv venv
source .venv/bin/activate

# 安装 browseruse-bench
uv pip install -e .
bubench run 会在首次运行时创建 config.yaml 中指定的 venv（默认 .venvs/browser_use），并自动安装 browser-use extra 依赖。 使用 bubench 前请先激活 .venv（或使用 uv run bubench ...）。

​
配置

在根目录 config.yaml 的 agents.browser-use 下配置： 
agents:
  browser-use:
    active_model: browser-use   # 当前使用的模型配置名
    models:
      browser-use:              # Browser Use 官方 API
        model_type: BROWSER_USE
        model_id: bu-2-0
        api_key: $BROWSER_USE_API_KEY
      gpt:                      # OpenAI 兼容模型
        model_type: OPENAI
        model_id: gpt-5.4
        api_key: $OPENAI_API_KEY
        base_url: $OPENAI_BASE_URL
    browser:
      browser_id: lexmount
      lexmount_browser_mode: normal
      lexmount_api_key: $LEXMOUNT_API_KEY
      lexmount_project_id: $LEXMOUNT_PROJECT_ID
    defaults:
      use_vision: false
      max_steps: 40
      flash_mode: true
      timeout: 600
将 active_model 设置为默认使用的模型配置名，也可在运行时通过 --model <name> 切换。

​
支持的模型类型

model_type说明额外配置项
BROWSER_USEBrowser Use 官方 APIapi_key（$BROWSER_USE_API_KEY）
OPENAIOpenAI 兼容模型api_key, base_url
GEMINIGemini 模型api_key, base_url

​
配置参数说明

参数说明示例
active_model默认模型配置名browser-use, gpt
model_type模型提供商类型BROWSER_USE, OPENAI, GEMINI
model_id模型 IDbu-2-0, gpt-4.1
api_keyAPI 密钥（推荐 $ENV_VAR 形式）$BROWSER_USE_API_KEY
browser_id浏览器后端Chrome-Local, lexmount, agentbay
use_vision是否将截图随 DOM 状态一起传给 LLMtrue, false
max_steps最大任务步数40
timeout任务超时时间（秒）600
lexmount_browser_modeLexmount 浏览器模式normal（默认）, light
agentbay_api_keyAgentBay API Key（推荐 $ENV_VAR 形式）$AGENTBAY_API_KEY
agentbay_image_idAgentBay 会话镜像默认 browser_latest
agentbay_enable_browser_replay是否开启 AgentBay 录制true（默认）, false
agentbay_browser_use_stealth是否开启 AgentBay stealthfalse（默认）, true
为什么没有 browser_control？browser-use 框架内部始终并行使用 DOM 和视觉两套机制，没有”纯 DOM”或”纯视觉”的切换选项。use_vision 只控制是否将截图包含在 LLM 上下文中，底层交互策略由框架本身决定，不对外暴露。

​
浏览器模式

本地浏览器：使用本地 Chrome，适合开发调试，无需额外参数。 
browser:
  browser_id: Chrome-Local
Lexmount 云浏览器：适合大规模评测。先在 .env 中填好 LEXMOUNT_API_KEY / LEXMOUNT_PROJECT_ID，再在 config.yaml 的 browser 下引用： 
browser:
  browser_id: lexmount
  lexmount_browser_mode: normal           # normal | light
  lexmount_api_key: $LEXMOUNT_API_KEY
  lexmount_project_id: $LEXMOUNT_PROJECT_ID
  # lexmount_base_url: $LEXMOUNT_BASE_URL  # 可选，按地区选择：
                                          #   https://api.lexmount.cn            （生产 · 国内，默认）
                                          #   https://api.lexmount.com           （生产 · 国外）
详细配置参考 Lexmount 云浏览器。 AgentBay 云浏览器：适合大规模评测。先在 .env 中填好 AGENTBAY_API_KEY，再在 config.yaml 的 browser 下引用： 
browser:
  browser_id: agentbay
  agentbay_api_key: $AGENTBAY_API_KEY
  # agentbay_image_id: browser_latest
  # agentbay_enable_browser_replay: true
  # agentbay_browser_use_stealth: false
运行说明：
  • AgentBay SDK 按可选依赖处理。包缺失或导出不兼容时，仅在 browser_id: agentbay 才会报错，其他浏览器模式不受影响。
  • AgentBay 后端会话清理失败只会记录日志，不会覆盖任务执行阶段的原始错误。

​
使用示例

​
基础运行

# 运行 LexBench-Browser 前 3 个任务
bubench run \
  --agent browser-use \
  --data LexBench-Browser \
  --mode first_n \
  --count 3

# 运行全部任务（跳过已完成）
bubench run \
  --agent browser-use \
  --data LexBench-Browser \
  --mode all \
  --skip-completed

​
指定任务运行

# 运行指定 ID 的任务
bubench run \
  --agent browser-use \
  --data LexBench-Browser \
  --mode specific \
  --task-ids task_id_1 task_id_2

​
评估

# 评估结果（--model-id 填运行时使用的 model_id）
bubench eval --agent browser-use --data LexBench-Browser --model-id bu-2-0

# 自定义评分阈值
bubench eval --agent browser-use --data LexBench-Browser --model-id bu-2-0 --score-threshold 70

​
支持的 Benchmarks

  • ✅ LexBench-Browser
  • ✅ Online-Mind2Web
  • ✅ BrowseComp

​
相关链接