创建 Automation CDP WebSocket 流 - CreateAutomationStream

browser_name

是

String

参数解释：

与会话关联的浏览器工具的唯一标识符。

浏览器工具名称获取方式：

1. 进入 AgentArts 平台，在左侧导航栏选择"组件库 > 沙箱工具"。

2. 在浏览器工具列表中"浏览器工具名称/ID"处获取名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Authorization

是

String

参数解释：

本次智能体工具调用对应的身份认证凭据。需要根据实际的智能体工具的入站身份认证方式获取对应的身份认证凭据。

API Key认证、IAM认证及OAuth 2.0认证具体请参见认证鉴权。

约束限制：

不涉及。

取值范围：

1-4096个字符，由字母、数字及特殊字符组成。

默认取值：

不涉及。

X-Hw-Agentarts-Browser-Session-Id

是

String

参数解释：

要使用的浏览器会话的唯一标识符。

约束限制：

必须是通过 StartBrowserSession 创建的活跃会话。如果会话已过期或已停止，请求将失败。

取值范围：

符合正则：^[a-zA-Z0-9_-]+$。

默认取值：

不涉及。

Upgrade

是

String

参数解释：

固定为 websocket，表示从 HTTP 协议升级为 WebSocket 协议。

约束限制：

不涉及。

取值范围：

websocket。

默认取值：

不涉及。

Connection

是

String

参数解释：

固定为 Upgrade，表示客户端请求升级连接协议。

约束限制：

不涉及。

取值范围：

Upgrade。

默认取值：

不涉及。

Sec-Websocket-Key

是

String

参数解释：

随机 Base64 字符串（24 字符），用于生成 Sec-WebSocket-Accept 响应头。

约束限制：

不涉及。

取值范围：

24个字符的Base64字符串。

默认取值：

不涉及。

Sec-Websocket-Version

是

String

参数解释：

WebSocket 协议版本，固定传 13（RFC 6455 规定的当前版本号）。

约束限制：

不涉及。

取值范围：

13。

默认取值：

不涉及。

Upgrade

String

参数解释：

固定为 websocket，表示从 HTTP 协议升级为 WebSocket 协议。

约束限制：

不涉及。

取值范围：

websocket。

默认取值：

不涉及。

Connection

String

参数解释：

固定为 Upgrade，表示客户端请求升级连接协议。

约束限制：

不涉及。

取值范围：

Upgrade。

默认取值：

不涉及。

Sec-WebSocket-Accept

String

参数解释：

由服务端基于Sec-WebSocket-Key计算并返回。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

101

Switching Protocols —— 连接升级成功，开始双向 CDP 消息透传。

200

WebSocket 消息帧 —— 升级后的双向 CDP JSON 消息。

每帧为一条完整的 Chrome DevTools Protocol JSON 文本消息。

401

认证失败

403

权限不足

404

资源不存在

500

内部系统错误