用途:让 Vercel 上部署的应用(Next.js、SvelteKit、Nuxt、Remix、Astro 等)在按需启动的 Vercel Sandbox 微型 Linux VM 中执行浏览器自动化,命令执行完即关闭。
依赖:pnpm add @vercel/sandbox。Chromium 需要一批系统库(nss、nspr、gtk3、pango、cairo 等),还需安装 agent-browser,可用 sandbox snapshot 预装以获得亚秒级启动。
主要能力:通过 Sandbox.create 启动沙箱,用 sandbox.runCommand 调用 agent-browser 命令,如 open、get title --json、screenshot --json、snapshot -i -c、fill、click、wait --load networkidle、close。截图以文件路径返回,可再用 base64 -w 0 读取;沙箱在命令之间持续存活,可执行多步工作流。
认证:在 Vercel 部署上通过 OIDC 自动认证;本地开发可设置 VERCEL_TOKEN、VERCEL_TEAM_ID、VERCEL_PROJECT_ID。可选环境变量 AGENT_BROWSER_SNAPSHOT_ID 用于预建快照加速启动。
适用场景:需要浏览器自动化的 Vercel 应用,可结合 Vercel Cron Jobs 做定时任务,如抓取页面快照、监控价格等。
限制:未提供具体收费、价格与性能数据;沙箱快照与 agent-browser 的无障碍快照不是同一概念;首次不使用快照时安装依赖约需 30 秒。