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

保存浏览器 Profile - SaveBrowserProfile

该 API 用于将当前浏览器 Session 的状态（cookie %%localStorage %%sessionStorage）

保存到指定的 Profile。通过 CDP 提取浏览器状态后打包上传到 OBS，覆盖之前的 Profile 数据。

Profile 不自动保存，需由 SDK %%Agent 在合适时机（如登录成功后）显式调用。

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

PUT https://agentarts.com/v1/browsers/{browser_name}/save-profile

表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/save-profile

{
  "profile_id" : "profile-abc123"
}

无

请参见错误码。

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