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

更新浏览器 Stream 状态 - UpdateBrowserStream

该 API 用于更新浏览器会话的 Stream 状态。主要用于人工接管场景：

设置 automation_stream.stream_status 为 disabled：断开所有已有 automation WebSocket 连接，拒绝新的 automation 连接和 invoke 请求（返回 403 "Stream is disabled for this session"）。
设置 automation_stream.stream_status 为 enabled：恢复 automation 连接和 invoke 请求。

LiveView 是纯观看通道，不受此 API 影响。

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

PUT https://agentarts.com/v1/browsers/{browser_name}/streams-update

表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

无

/v1/browsers/my-browser/streams-update

{
  "stream_update" : {
    "automation_stream_update" : {
      "stream_status" : "disabled"
    }
  }
}

无

请参见错误码。

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