Sub-agent Labs

Labs 是什么

Sub-agent Labs 是管理员专用的隔离测试台。它用于单独运行 Browser Use，确认模型、浏览器运行时、浏览器流和 trace 是否正常。

当前只有一个统一入口：

• Browser Use Lab：同一个 browser_use 委托可以选择已配置的远端浏览器，或指定已注册的本地浏览器运行时。旧的 Agent Browser Lab 地址会自动跳转到这里。

Labs 不会替代普通 agent。普通 agent 通过 Agent Builder 挂载 sub-agent；Labs 则用于在挂载前或故障时单独验证子 agent。

运行一次测试

一次 lab run 需要填写：

• Browser runtime：选择 Remote browser，或选择 Local browser 后指定一台已注册且在线的机器。
• Model：选择已登记的 chat model。
• Start URL：浏览器打开的起始网页。
• Task：希望子 agent 完成的任务。

点击 Run isolated test 后，页面会创建一次独立 session，并展示浏览器运行状态、结果输出和 trace。远端 Agent Browser 与支持 browser.stream.v1 的本地运行时都会显示实时画面。

页面区域

Lab 页面分为几块：

区域	说明
Summary	显示子 agent 名称、runtime、MCP server id、tool name 和配置状态。
Browser stream	如果后端支持，会显示实时浏览器画面、页面标题和 URL。
Result	展示最终文字结果，以及启用后自动上传的 WebM 操作录像和最终截图。
Trace	展示模型步骤、工具调用和失败信息。

如果浏览器流不可用，子 agent 仍可能完成任务；此时重点看 Result 和 Trace。

录像与截图由 API 统一控制，需要配置 AGENT_R2_* 并设置 BROWSER_ARTIFACTS_ENABLED=true。文件保持私有，页面通过短期签名 URL 读取；远端容器和本地运行时都不持有 R2 密钥。

常见失败原因

• 没有可用模型：先到 模型配置 添加 chat model。
• 远端浏览器未配置：检查 Hosted Browser MCP 后端是否可用。
• 本地浏览器无法运行：确认目标机器已经注册、启用且在线。
• 浏览器画面不显示：确认远端服务包含 stream route，或本地运行时已经升级并声明 browser.stream.v1。
• 录像不显示：确认 API 已启用 browser artifacts、R2 配置完整，并检查远端服务或本地 daemon 的上传日志。
• 任务启动后断流：等待页面回收最终状态，或稍后到相关 session/run 查看结果。

什么时候使用

• 新增浏览器能力前，确认后端可运行。
• 普通 agent 调用 sub-agent 失败时，单独复现。
• 比较同一任务在远端浏览器和本地浏览器上的表现。
• 验证某个模型是否适合网页导航、页面读取和表单类任务。