ActSpace Docs

Browser Use

使用 ActSpace Browser Bridge 操作真实 Chrome,并理解授权、定位器与标签页隔离。

Browser Use 让主 Agent 通过标准工具操作真实 Chrome,包括读取页面、导航、表单输入、截图、标签页、下载、剪贴板和调试。

组成

Browser 能力跨越三个运行边界:

  • Agent Core 暴露模型工具并管理会话语义。
  • Go Bridge 维护 canonical command registry、CDP 连接和命令执行。
  • Chrome Extension 提供浏览器侧 primitive、可视光标与 Native Messaging 连接。

它们通过协议通信,不要求 Agent Core 直接依赖 Go 编译产物。

按需披露工具

每个 Turn 默认只提供 browser_help。当模型确认任务需要网页操作后,完整浏览器工具组从下一次模型请求开始进入 Context。

新 Turn 或 Kairos tick 会重新回到入口状态。这能减少无关 schema 占用,并降低普通编码任务误触浏览器的概率。

会话授权

Browser 使用会话级授权租约。用户首次允许后,同一 Browser session 内的连续操作不需要逐条询问;拒绝只作用于当前 Turn 的授权请求。

标签页具有 ownership 和 claim 语义,不同任务不会随意关闭彼此的页面。

Locator

定位器优先使用接近真实用户的语义:

  • role 与 accessible name
  • label
  • placeholder
  • text
  • test id
  • 必要时使用 CSS

Locator Runtime 支持 Frame、开放 Shadow DOM、严格匹配、自动等待和 actionability 检查。相比只依赖坐标,这种方式对响应式布局和页面小幅变化更稳定。

批量操作

批量 mutation 会先完成整批参数验证和风险预检,再按顺序执行。这样能避免前几步已经改变页面、后一步才发现输入无效的半完成状态。

需要为浏览器加入项目专属流程时,可以把固定操作沉淀成 Skill,而不是不断扩大系统提示词。