# 执行浏览器操作 - 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](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST https://agentarts.com/v1/browsers/{browser_name}/invoke
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| browser_name | 是    | String | **参数解释：** 与会话关联的浏览器工具的唯一标识符。 浏览器工具名称获取方式： 1. 进入 AgentArts 平台，在左侧导航栏选择"组件库 \> 沙箱工具"。   2. 在浏览器工具列表中"浏览器工具名称/ID"处获取名称。    **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
   
#### 请求参数
表2请求Header参数 
| 参数                                | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| Authorization                     | 是    | String | **参数解释**： 本次智能体工具调用对应的身份认证凭据。需要根据实际的智能体工具的入站身份认证方式获取对应的身份认证凭据。 API Key认证、IAM认证及OAuth 2.0认证具体请参见[认证鉴权](https://support.huaweicloud.com/api-agentarts/agentarts_07_0005.html)。 **约束限制**： 不涉及。 **取值范围**： 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 | 内部系统错误                                                          |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。