新建配置文件
配置文件（Profile） 用于保存浏览器会话的运行状态，包括但不限于 Cookie、本地存储（LocalStorage / SessionStorage）、登录凭证等。通过配置文件，您可以：
- 将当前会话状态持久化保存，避免重复登录或重复初始化。
- 在新的会话中加载已有配置文件，快速恢复到上次保存的状态。
- 对同一业务场景创建多个配置文件，按需切换使用。
会话状态不会自动保存，如需持久化当前浏览器的状态（Cookie、登录凭证等），请手动在实时会话页面单击“保存到配置文件”，或通过SDK将会话保存至配置文件。
通过控制台新建配置文件
- 登录AgentArts智能体平台。
- 在左侧导航栏选择“托管与运行 > 浏览器”，进入浏览器界面。
- 单击右上角“配置文件”，然后单击“新建配置文件”。
- 输入相关配置信息，参数说明请参考表1 参数说明，配置完成后单击“确定”。
表1 参数说明 参数
说明
名称
配置文件名称。
系统默认生成格式为profile-<随机字符串>（例如 profile-6amdlkwy2），您可自行修改为具有业务含义的名称。
描述
对配置文件用途的简要说明，最多支持 4,096 个字符。
标签 (可选)
由“标签键”和“标签值”组成，用于标识和分类云资源。
您可以在TMS中创建预定义标签，用于使用同一标签标识多种云资源，创建后可在标签输入框下拉选择同一标签，具体操作请参考创建预定义标签，创建后单击
刷新。单击“添加标签”，选择在TMS中创建的预定义标签，或自定义输入标签键和标签值。
可添加一个或多个标签，最多添加20个标签。
通过SDK新建配置文件
浏览器配置文件用于保存浏览器会话状态（cookie、localStorage、sessionStorage），可在创建会话时加载，实现状态持久化。SDK提供create_browser_profile接口用于创建浏览器配置文件。
创建浏览器配置文件
在Python文件中通过SDK创建浏览器配置文件，相关参数说明以及配置示例如下：
- 方法名：create_browser_profile
- 参数说明：
参数名
类型
描述
name
str
Required 配置文件名称。必须以小写字母开头，小写字母或数字结尾，中间可包含数字、小写字母、中划线。字符数：2-40。
description
str
配置文件描述，最大4096个字符。Default：None
tags
List[Dict]
标签列表，最多20个，key必须唯一。格式：[{"key": "标签键", "value": "标签值"}]。Default：None
API KEY代码示例
from agentarts.sdk.tools import Browser
# 创建浏览器客户端
client = Browser(region="cn-southwest-2", auth_type="API_KEY", verify_ssl=False)
# 创建浏览器配置文件
profile = client.create_browser_profile(
name="your_profile_name",
description="浏览器配置文件描述",
tags=[{"key": "env", "value": "dev"}]
)
print(f"配置文件ID: {profile['id']}")
print(f"配置文件名称: {profile['name']}") IAM代码示例
from agentarts.sdk.tools import Browser
# 创建浏览器客户端（使用IAM认证）
client = Browser(region="cn-southwest-2", auth_type="IAM", verify_ssl=False)
# 创建浏览器配置文件
profile = client.create_browser_profile(
name="your_profile_name",
description="浏览器配置文件描述",
tags=[{"key": "env", "value": "dev"}]
)
print(f"配置文件ID: {profile['id']}")
print(f"配置文件名称: {profile['name']}") 
