# 新建配置文件
配置文件（Profile） 用于保存浏览器会话的运行状态，包括但不限于 Cookie、本地存储（LocalStorage / SessionStorage）、登录凭证等。通过配置文件，您可以：
- 将当前会话状态持久化保存，避免重复登录或重复初始化。
- 在新的会话中加载已有配置文件，快速恢复到上次保存的状态。
- 对同一业务场景创建多个配置文件，按需切换使用。
会话状态不会自动保存，如需持久化当前浏览器的状态（Cookie、登录凭证等），请手动在实时会话页面单击"[保存到配置文件](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_178.html#agentarts_10_178__section911135481411)"，或[通过SDK将会话保存至配置文件](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_178.html#agentarts_10_178__section592972111518)。
#### 通过控制台新建配置文件
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 在左侧导航栏选择"托管与运行 \> 浏览器"，进入浏览器界面。
3. 单击右上角"配置文件"，然后单击"新建配置文件"。
4. 输入相关配置信息，参数说明请参考[表1 参数说明]，配置完成后单击"确定"。
   
    表1参数说明 
   | 参数       | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   |:---|:---|
   | 名称      | 配置文件名称。 系统默认生成格式为profile-\<随机字符串\>（例如 profile-6amdlkwy2），您可自行修改为具有业务含义的名称。                                                                                                                                                                                                                                                                                                                                          |
   | 描述       | 对配置文件用途的简要说明，最多支持 4,096 个字符。                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 标签 (可选) | 由"标签键"和"标签值"组成，用于标识和分类云资源。 您可以在TMS中创建预定义标签，用于使用同一标签标识多种云资源，创建后可在标签输入框下拉选择同一标签，具体操作请参考[创建预定义标签](https://support.huaweicloud.com/usermanual-tms/zh-cn_topic_0144368884.html)，创建后单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002711523178.png)刷新。 单击"添加标签"，选择在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']}")
```