跳转到主要内容
Skyvern 是基于 Skyvern SDK 的浏览器自动化代理，支持多种执行引擎（skyvern_v1、skyvern_v2、openai-cua、anthropic-cua、ui-tars）以及多种浏览器后端（local、cdp、lexmount、skyvern-cloud）。

​
安装

# 安装核心依赖并注册 bubench CLI
uv sync
skyvern 与 browser-use 的 extra 依赖冲突，建议使用独立 venv（config.yaml 默认 skyvern 使用 .venvs/skyvern，browser-use 使用 .venvs/browser_use）。 bubench run 会在首次运行时自动创建该 venv 并安装 skyvern extra。
使用 bubench 前请先激活 .venv（或使用 uv run bubench ...）。

​
配置

在根目录 config.yaml 的 agents.skyvern 下配置： 
agents:
  skyvern:
    active_model: gemini        # 当前使用的模型配置名
    models:
      gemini:
        enable_openai_compatible: true
        model_id: gemini-3-flash-preview
        max_tokens: 16000
        temperature: 0.0
        supports_vision: true
        api_key: $OPENAI_COMPATIBLE_API_KEY
    browser:
      browser_id: local
      headless: false
    defaults:
      engine: skyvern_v2
      max_steps: 25
      timeout: 600
      max_screenshot_scrolls: 5
      include_action_history_in_verification: true
      max_consecutive_repeats: 3
      max_action_occurrences: 5
敏感密钥（如 OPENAI_COMPATIBLE_API_KEY、SKYVERN_API_KEY）请放在根目录 .env 中。

​
引擎选项

ENGINE说明
skyvern_v1Skyvern v1 引擎
skyvern_v2Skyvern v2 引擎
openai-cuaOpenAI CUA 引擎
anthropic-cuaAnthropic CUA 引擎
ui-tarsUI-TARS 引擎

​
浏览器后端

browser_id说明
local本地浏览器
cdp连接外部 CDP 浏览器（可配 CDP_ADDRESS）
lexmountLexmount 云浏览器（可配 LEXMOUNT_BROWSER_MODE）
skyvern-cloudSkyvern 云浏览器

​
常用参数

参数说明示例值
enable_openai_compatible启用 OpenAI-Compatible 运行模式true
model_idLLM 模型名gemini-3-flash-preview
api_keyLLM API 密钥（推荐 $ENV_VAR 形式）$OPENAI_COMPATIBLE_API_KEY
base_urlLLM API 地址$OPENAI_BASE_URL
max_tokens最大输出 tokens16000
temperature温度0.0
supports_vision模型是否支持视觉true
request_timeoutLiteLLM 单次请求超时（秒）600
headless本地浏览器无头模式true / false
timeout任务超时（秒）600
max_steps最大任务步数25
max_screenshot_scrolls最大滚动截图次数5
include_action_history_in_verification校验时包含动作历史true
max_consecutive_repeats最大连续重复次数3
max_action_occurrences单动作最大出现次数5
Key 改名（老 key 兼容）per-model 配置下的 openai_compatible_* 前缀已去掉，与其他 agent 对齐（model_id、api_key、base_url、max_tokens、temperature、supports_vision、request_timeout）。老 key 仍然可用 —— 每个 key 在进程里会触发一次 DeprecationWarning，然后自动别名到新 key。传给 Skyvern 子进程的环境变量 OPENAI_COMPATIBLE_* 保持不变。
为什么没有 browser_control？Skyvern 是完全托管的服务，何时使用 DOM 检查、何时使用视觉定位由 Skyvern 执行引擎内部决策（可通过 execution_engine 切换引擎）。基准测试层只通过 API 提交任务，不干预内部的交互策略。
不推荐：configs/agents/skyvern/config.yamlconfigs/agents/ 下的独立配置文件不再是推荐方式，后续版本可能下掉。请改用根目录 config.yaml（见上方）。

​
使用示例

​
基础运行

bubench run \
  --agent skyvern \
  --benchmark LexBench-Browser \
  --mode first_n \
  --count 3

​
运行全部任务

bubench run \
  --agent skyvern \
  --benchmark LexBench-Browser \
  --mode all \
  --skip-completed

​
评估

# --model-id 填运行时使用的 model_id
bubench eval --agent skyvern --benchmark LexBench-Browser --model-id gemini-3.1-pro-preview

​
支持的 Benchmarks

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

​
相关链接