更新时间：2026-09-14 GMT+08:00

执行浏览器操作 - InvokeBrowser

该 API 用于在浏览器 Session 中执行结构化操作，包括导航、鼠标点击/拖拽、

键盘输入、滚动、截图、获取页面信息、Tab 管理等。

请求体采用 UNION 结构（对齐 AWS BrowserAction），action 对象中每次仅设置一个成员。

同一 Session 内的 invoke 请求串行执行（session 级锁）。

坐标系为浏览器视口坐标，与截图像素一一对应。

当 automation_stream.stream_status 为 disabled（人工接管中）时，invoke 请求返回 403（Stream is disabled for this session）。

当前API调用无需身份策略权限。

POST https://agentarts.com/v1/browsers/{browser_name}/invoke

表1 路径参数
参数	是否必选	参数类型	描述
browser_name	是	String	参数解释：与会话关联的浏览器工具的唯一标识符。浏览器工具名称获取方式：进入 AgentArts 平台，在左侧导航栏选择"组件库 > 沙箱工具"。在浏览器工具列表中"浏览器工具名称/ID"处获取名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表2 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	参数解释：本次智能体工具调用对应的身份认证凭据。需要根据实际的智能体工具的入站身份认证方式获取对应的身份认证凭据。 API Key认证、IAM认证及OAuth 2.0认证具体请参见认证鉴权。约束限制：不涉及。取值范围： 1-4096个字符，由字母、数字及特殊字符组成。默认取值：不涉及。
X-Hw-Agentarts-Browser-Session-Id	是	String	参数解释：要使用的浏览器会话的唯一标识符。约束限制：必须是通过 StartBrowserSession 创建的活跃会话。如果会话已过期或已停止，请求将失败。取值范围：符合正则：^[a-zA-Z0-9_-]+$。默认取值：不涉及。

状态码：200

无

{
  "type" : "key_shortcut",
  "action" : {
    "keys" : [ "ctrl", "s" ]
  }
}

{
  "type" : "navigate",
  "action" : {
    "url" : "https://example.com"
  }
}

{
  "type" : "screenshot",
  "action" : {
    "format" : "jpeg",
    "quality" : 80,
    "full_page" : false
  }
}

{
  "type" : "go_back",
  "action" : { }
}

{
  "type" : "key_type",
  "action" : {
    "text" : "Hello World"
  }
}

{
  "type" : "mouse_drag",
  "action" : {
    "start_x" : 100,
    "start_y" : 200,
    "end_x" : 300,
    "end_y" : 400
  }
}

{
  "type" : "switch_tab",
  "action" : {
    "tab_id" : "target-abc123"
  }
}

无

状态码	描述
200	OK
400	请求参数错误
401	认证失败
403	权限不足或 Automation 流已禁用（人工接管中，通过 UpdateBrowserStream 设为 disabled）
404	资源不存在
408	操作超时
409	操作冲突
413	请求体过大
429	请求频率超限
500	内部系统错误

请参见错误码。

父主题： 浏览器数据面接口