agent-browser 通过显式 tab ID 实现多标签页精准隔离与路由:1. 创建命名页用 --tab-id;2. 切换/操作必须指定 ID 防污染;3. 关闭支持单个、除当前外、全部三种模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让 AI Agent 在同一浏览器实例中并行处理多个网页任务,比如一边查文档、一边填表单、一边等待 API 响应页面加载完成,而不能让操作串到错误的标签页上——agent-browser 的多标签页切换机制正是为此设计,它不依赖人工记忆 tab 顺序,而是通过显式声明的 tab ID 进行精准路由。
创建并命名新标签页
执行 agent-browser open https://example.com --tab-id docs。这一步会新开一个标签页,并将其绑定到唯一标识符 【docs】,后续所有对该 tab 的操作都必须带上这个 ID。不指定 --tab-id 时,命令默认作用于当前活跃 tab,极易导致跨任务污染。
再执行 agent-browser open https://httpbin.org/forms --tab-id form-page,打开第二个带命名的标签页。此时两个页面完全隔离,互不影响 DOM 状态和 JavaScript 执行上下文。
在已命名标签页间切换并操作
使用 agent-browser switch --tab-id docs 激活 docs 标签页。这一步不会刷新页面,只改变浏览器焦点和后续操作的目标上下文。
接着运行 agent-browser snapshot -i --tab-id docs,获取 docs 页面当前可交互元素快照。注意:如果漏写 --tab-id docs,snapshot 会默认采集当前活跃 tab(可能是 form-page),导致后续 click 指令打偏。
执行 agent-browser click @e5 --tab-id docs,点击 docs 页面中编号为 e5 的元素。该指令仅在 docs 标签页内生效,哪怕 form-page 正在后台执行 JS,也不会被干扰。
批量关闭指定标签页
方法一:关闭单个命名 tab
运行 agent-browser close --tab-id form-page,立即销毁 form-page 标签页及其全部资源(包括未完成的 fetch 请求、定时器、Web Worker)。
方法二:关闭除当前外所有 tab
执行 agent-browser close --except-current。这会保留你当前 switch 到的那个 tab,其余全部清理,适合任务收尾阶段快速重置环境。
方法三:关闭全部 tab 并退出进程
运行 agent-browser quit。此操作不可逆,浏览器实例将彻底终止,所有 tab 及其状态一并清除。


















