tool /browserIsolation/local/create · 创建或打开命名的隔离 Chrome 实例,并生成或更新桌面快捷方式。新实例可从本机 Chrome 资料复制数据;同名实例沿用已有资料和启动设置。Chrome 会打开扩展管理页;若扩展尚未安装,按返回的 extension.path 手动加载。成功表示本地资料和启动已完成,不表示扩展已经连接。defaultUrl 仅在新建时生效。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"defaultUrl": {
"type": "string",
"format": "uri",
"description": "新建实例时保存的默认启动 URL,须为完整地址;实例已存在时沿用原设置,本次传值不会更新它。"
},
"sourceProfileName": {
"description": "新建时可选复制的本机 Chrome 资料目录名,如 Default 或 Profile 1;复制前须关闭全部 Chrome。省略则使用内置模板,实例已存在时不再复制。",
"type": "string",
"pattern": "^(Default|Profile [1-9]\\d*)$"
}
},
"required": [
"isolationName",
"defaultUrl"
]
}tool /browserIsolation/local/materialize · 为全部已创建的隔离浏览器生成或更新 Windows 桌面快捷方式,返回快捷方式路径列表;仅更新快捷方式,不启动浏览器。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {}
}tool /browserIsolation/local/instances · 列出本地已创建的隔离浏览器名称、资料目录、默认启动地址和来源 profile(若有),用于查找本地实例;不检查扩展连接状态。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {}
}tool /browserIsolation/control/connections · 启动本机浏览器控制监听,并列出当前已连接扩展的实例名称、连接时间与最近心跳时间;不读取本地资料目录,也不启动 Chrome。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {}
}tool /browserIsolation/control/loginState/copy · 从来源实例向目标实例写入 chatgpt.com 和 openai.com 域下允许复制的 Cookie,覆盖同名、同域、同路径的目标 Cookie。来源没有的目标 Cookie 不会删除,因此不会使两个资料完全同步。两个实例的扩展必须已经连接;返回复制数量和实例名称,不返回 Cookie 值,也不保证目标网站已登录。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"sourceIsolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户已指定且扩展已连接的来源实例名称;从中读取允许复制的 Cookie。"
},
"targetIsolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户已指定且扩展已连接的目标实例名称,须与来源不同。同名、同域、同路径的 Cookie 会被覆盖;来源没有的目标 Cookie 不会删除。"
}
},
"required": [
"sourceIsolationName",
"targetIsolationName"
]
}tool /browserIsolation/control/tabs · 列出指定已连接隔离浏览器全部窗口中的页签,返回 ID、标题、URL、活动状态、加载状态和窗口 ID。扩展离线时返回错误,不会启动 Chrome。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
}
},
"required": [
"isolationName"
]
}tool /browserIsolation/control/page · 读取指定已连接页签顶层文档的当前快照,返回标题、URL、最多 30000 字符的正文和 200 个可见交互元素及其 selector。密码输入框的 value 被省略,其他页面文字和输入值可能包含敏感信息。不等待页面加载完成。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"isolationName"
]
}tool /browserIsolation/control/navigate · 激活指定已连接浏览器中的现有页签并导航到完整 URL,沿用该浏览器当前资料和会话状态。返回导航请求后的页签信息,不保证站点已登录或页面已加载完成;需要重新读取时调用 browserIsolation_control_page。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"url": {
"type": "string",
"format": "uri",
"description": "要在现有页签打开的完整 URL;会替换该页签当前页面。"
}
},
"required": [
"isolationName",
"url"
]
}tool /browserIsolation/control/click · 在页签顶层文档中查找首个匹配元素,滚动到该元素、聚焦并调用 click;可能触发页面跳转或表单提交。页面变化后 selector 可能失效,应先重新调用 browserIsolation_control_page。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"selector": {
"type": "string",
"minLength": 1,
"description": "顶层文档中的 CSS 选择器,操作首个匹配元素。可先调用 browserIsolation_control_page 获取 selector;页面变化后 selector 可能失效,应重新读取页面。"
}
},
"required": [
"isolationName",
"selector"
]
}tool /browserIsolation/control/fill · 设置页签顶层文档中 input、textarea 或 contenteditable 元素的内容,并触发 input 和 change 事件;页面可能据此自动保存或提交。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"selector": {
"type": "string",
"minLength": 1,
"description": "顶层文档中的 CSS 选择器,操作首个匹配元素。可先调用 browserIsolation_control_page 获取 selector;页面变化后 selector 可能失效,应重新读取页面。"
},
"value": {
"type": "string",
"description": "要写入输入框、文本域或 contenteditable 元素的文本。"
}
},
"required": [
"isolationName",
"selector",
"value"
]
}tool /browserIsolation/control/press · 向指定元素或当前焦点元素派发脚本生成的 keydown、keypress、keyup 事件。仅支持单个键,不支持 Ctrl+A 等组合键或修饰键;不保证产生真实按键的默认行为,例如输入文字或按 Enter 提交表单。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 32,
"description": "单个 KeyboardEvent.key 键名,如 Enter、Escape 或 ArrowDown。仅派发脚本事件,不支持 Ctrl+A 等组合键或修饰键。"
},
"selector": {
"description": "可选的顶层文档 CSS 选择器。省略时使用当前焦点元素;未找到有效目标时回退到页面 body。",
"type": "string",
"minLength": 1
}
},
"required": [
"isolationName",
"key"
]
}tool /browserIsolation/control/exec · 在指定页签的页面主执行环境求值 JavaScript 表达式,等待 Promise 并返回结果的 type、value 或 unserializableValue。代码可读取页面可见数据、发送网络请求或修改页面;仅在 page、click、fill、press 无法完成时使用。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"expression": {
"type": "string",
"minLength": 1,
"description": "在目标页页面主执行环境求值的 JavaScript 表达式。支持返回可 JSON 序列化结果和 Promise;可读取页面可见数据、发送网络请求或修改页面。仅在专用页面操作无法完成时使用。"
}
},
"required": [
"isolationName",
"expression"
]
}tool /browserIsolation/control/screenshot · 激活指定页签并聚焦其窗口,截取当前可见区域,返回图像 dataUrl 和页签信息;图像仅包含视口范围。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"format": {
"default": "png",
"description": "截图图像格式,默认 png。",
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"quality": {
"description": "传给浏览器截图接口的图像质量,整数 0 至 100。省略时使用浏览器默认值。",
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"isolationName"
]
}tool /browserIsolation/control/research/query · 访问并读取已知 URL,不执行搜索。使用指定已连接隔离 Chrome 的当前资料和会话状态,激活指定页签;未提供 tabId 时使用当前活动页签。导航到 url,等待 waitMs 后读取顶层页面快照,返回标题、读取时的 URL、最多 30000 字符的正文和 200 个可交互元素。固定等待不保证站点已登录或页面加载完成;需要重新读取时调用 browserIsolation_control_page。
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isolationName": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "用户明确指定的隔离浏览器名称;沿用上下文中已指定的名称,尚未指定时先询问用户。同名实例复用同一资料目录。"
},
"tabId": {
"description": "指定实例中的页签 ID;可用 browserIsolation_control_tabs 查询。省略时使用最近聚焦窗口的活动页签。",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"url": {
"type": "string",
"format": "uri",
"description": "要在指定页签访问的完整 URL。"
},
"waitMs": {
"description": "发出导航请求后等待的毫秒数,默认 1000,范围 0 至 30000。固定等待不保证页面或异步内容加载完成。",
"type": "integer",
"minimum": 0,
"maximum": 30000
}
},
"required": [
"isolationName",
"url"
]
}