文档首页/ 智果（AgentArts）智能体平台/ 托管与运行智能体/ 浏览器/ 浏览器配置文件管理/ 将会话保存至配置文件
更新时间：2026-09-14 GMT+08:00
查看PDF
分享

将会话保存至配置文件

在会话执行过程中或执行完成后，您可以将当前浏览器的状态保存到配置文件，以便后续会话加载复用。

保存操作将覆盖目标配置文件的现有状态，原有数据将被替换，请谨慎操作。

数据大小限制：单个配置文件（Profile）的数据包上限为50MB，超出将无法保存。

通过控制台将会话保存至配置文件

  1. 登录AgentArts智能体平台。
  2. 在左侧导航栏选择“托管与运行 > 浏览器”，进入浏览器界面。
  1. 单击已创建的浏览器名称。
  2. 在“会话管理”页签，单击会话列表中操作列的“查看实时会话”。
  3. 在“实时会话”页面，查看浏览器页面，右上角单击“保存到配置文件”。
  4. 在列表中选中目标配置文件，单击“确定”，当前会话状态将覆盖写入该配置文件。

通过SDK将会话保存至配置文件

浏览器沙箱工具支持通过SDK将当前会话状态（cookie、localStorage、sessionStorage）保存到指定的配置文件中，以便下次创建会话时恢复状态。SDK提供save_profile接口用于保存会话状态。

  • 前提条件

    在调用save_profile方法前，必须已经启动浏览器会话。

  • 保存会话状态
    在Python文件中通过SDK保存浏览器会话状态，相关参数说明以及配置示例如下：
    • 方法名：save_profile
    • 配置以下参数：

      参数名

      类型

      描述

      profile_id

      str

      Required 要保存到的配置文件ID。由控制面创建并返回。

      api_key

      str

      API Key认证密钥。当使用API_KEY认证方式时，如果未提供此参数，SDK会尝试从环境变量HUAWEICLOUD_SDK_BROWSER_API_KEY获取。Default：None
    • 返回值如下：

      包含保存结果的字典，包括：

      • profile_id (str): 已保存的配置文件ID。
      • saved_at (str): 保存时间。
      • size_bytes (int): 保存数据大小（字节）。
      • cookie_count (int): 保存的cookie数量。
      • origin_count (int): 保存的源数量。
    • 行为说明：
      • 必须在活跃会话中调用（会话终止后无法保存）
      • 保存的是当前会话的浏览器状态（cookie、localStorage、sessionStorage）
      • 保存后，下次创建会话时通过profile_configuration={"profile_id": "..."}加载该配置，即可恢复状态

API KEY代码示例

from agentarts.sdk.tools import Browser
# 创建浏览器客户端
client = Browser(region="cn-southwest-2", auth_type="API_KEY", verify_ssl=False)
# 启动会话（前提条件）
client.start_session(
    browser_name="your_browser_name",
    session_name="your_session_name",
    api_key="your_api_key"
)
# 执行浏览器操作
client.navigate(url="https://example.com", api_key="your_api_key")
# 保存当前会话状态到配置文件
result = client.save_profile(
    profile_id="your_profile_id",
    api_key="your_api_key"
)
print(f"保存结果: {result}")
# 终止会话
client.stop_session(api_key="your_api_key")

IAM代码示例

from agentarts.sdk.tools import Browser
# 创建浏览器客户端（使用IAM认证）
client = Browser(region="cn-southwest-2", auth_type="IAM", verify_ssl=False)
# 启动会话（前提条件）
client.start_session(
    browser_name="your_browser_name",
    session_name="your_session_name"
)
# 执行浏览器操作
client.navigate(url="https://example.com")
# 保存当前会话状态到配置文件
result = client.save_profile(profile_id="your_profile_id")
print(f"保存结果: {result}")
# 终止会话（IAM认证无需传递api_key）
client.stop_session()

注意事项

  1. 前提条件：调用save_profile前必须已经启动会话，否则会抛出异常
  2. 调用时机：必须在活跃会话中调用save_profile，会话终止后无法保存
  3. profile_id：必须是通过控制面已创建的配置文件ID
  4. 保存内容：当前会话的浏览器状态，包括cookie、localStorage、sessionStorage
  5. 状态恢复：下次创建会话时通过profile_configuration={"profile_id": "..."}加载配置，即可恢复之前保存的状态
  6. 认证方式：
    • API_KEY认证：需要传递api_key参数或设置环境变量HUAWEICLOUD_SDK_BROWSER_API_KEY
    • IAM认证：需要配置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK

相关文档