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 ...)。
先复制示例配置,再编辑:
cp configs/agents/skyvern/config.yaml.example configs/agents/skyvern/config.yaml
编辑 configs/agents/skyvern/config.yaml:
# LLM 配置
ENABLE_OPENAI_COMPATIBLE: true
OPENAI_COMPATIBLE_MODEL_NAME: gemini-3-flash-preview
OPENAI_COMPATIBLE_MAX_TOKENS: 16000
OPENAI_COMPATIBLE_TEMPERATURE: 0.0
OPENAI_COMPATIBLE_SUPPORTS_VISION: true
# 引擎配置
ENGINE: skyvern_v2
# 浏览器配置
BROWSER_ID: local
HEADLESS: false
LEXMOUNT_BROWSER_MODE: normal
# 执行参数
MAX_STEPS: 25
TIMEOUT: 600
敏感密钥建议放在根目录 .env 中,例如 OPENAI_COMPATIBLE_API_KEY 或 SKYVERN_API_KEY。
引擎选项
| ENGINE | 说明 |
|---|
skyvern_v1 | Skyvern v1 引擎 |
skyvern_v2 | Skyvern v2 引擎 |
openai-cua | OpenAI CUA 引擎 |
anthropic-cua | Anthropic CUA 引擎 |
ui-tars | UI-TARS 引擎 |
浏览器后端
| BROWSER_ID | 说明 |
|---|
local | 本地浏览器 |
cdp | 连接外部 CDP 浏览器(可配 CDP_ADDRESS) |
lexmount | Lexmount 云浏览器(可配 LEXMOUNT_BROWSER_MODE) |
skyvern-cloud | Skyvern 云浏览器 |
常用参数
| 参数 | 说明 | 示例值 |
|---|
ENABLE_OPENAI_COMPATIBLE | 启用 OpenAI-Compatible 运行模式 | true |
OPENAI_COMPATIBLE_MODEL_NAME | 模型名称 | gemini-3-flash-preview |
OPENAI_COMPATIBLE_MAX_TOKENS | 最大输出 tokens | 16000 |
OPENAI_COMPATIBLE_TEMPERATURE | 温度 | 0.0 |
OPENAI_COMPATIBLE_SUPPORTS_VISION | 模型是否支持视觉 | true |
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 |
使用示例
基础运行
bubench run \
--agent skyvern \
--benchmark LexBench-Browser \
--mode first_n \
--count 3
运行全部任务
bubench run \
--agent skyvern \
--benchmark LexBench-Browser \
--mode all \
--skip-completed
bubench eval --agent skyvern --benchmark LexBench-Browser
支持的 Benchmarks
- ✅ LexBench-Browser
- ✅ Online-Mind2Web
- ✅ BrowseComp
相关链接