文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 沙箱工具/ 浏览器配置管理/ 创建浏览器配置 - CreateCoreBrowserProfile
更新时间:2026-09-24 GMT+08:00
分享

创建浏览器配置 - CreateCoreBrowserProfile

功能介绍

该API用于创建一个浏览器配置。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:browserProfile:createCoreBrowserProfile

Write

browserProfile *

-

-

-

-

  • g:RequestTag/<tag-key>

  • g:TagKeys

URI

POST /v1/core/browser-profiles

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

参数解释:

浏览器配置的名称。

约束限制:

该名称在您的账户中必须是唯一的。

取值范围:

符合正则条件^[a-z][a-z0-9-]{0,38}[a-z0-9]$,即必须以小写字母开头,小写字母或数字结尾,中间可包含数字、小写字母、中划线,字符长度必须在2-40个字符之间。

默认取值:

不涉及。

description

否

String

参数解释:

浏览器配置的描述。

约束限制:

不涉及。

取值范围:

任意字符,长度不能超过4096个字符。

默认取值:

不涉及。

tags

否

Array of CoreToolsTag objects

参数解释:

资源标签。

约束限制:

同一个资源的标签key不能重复、标签列表最多支持20个。

表2 CoreToolsTag

参数

是否必选

参数类型

描述

key

是

String

参数解释:

标签键,不能为空且同一资源下标签键不能重复。

约束限制:

不涉及。

取值范围:

符合规则^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}.:/=+-@]*)(?<!\s)$,即可以包含任意语种的字母、数字和空格,以及.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头,且长度在1到128之间。

默认取值:

不涉及。

value

是

String

参数解释:

标签值。

约束限制:

不涉及。

取值范围:

符合规则^([\p{L}\p{Z}\p{N}.:/=+-@]*)$,即可以包含任意语种的字母、数字和空格,以及.:/=+-@字符,且长度不能超过255个字符。

默认取值:

不涉及。

响应参数

状态码:201

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释:

浏览器配置ID。

取值范围:

符合UUID规则^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$的36位字符串。

name

String

参数解释:

浏览器配置的名称。

取值范围:

符合正则^[a-z][a-z0-9-]{0,38}[a-z0-9]$,即必须以小写字母开头,小写字母或数字结尾,中间可包含数字、小写字母、中划线,字符长度必须在2-40个字符之间。

description

String

参数解释:

浏览器配置的描述。

取值范围:

任意字符,长度不能超过4096个字符

last_saved_browser_id

String

参数解释:

最近保存的浏览器ID。

取值范围:

长度36到36个字符。

last_saved_browser_name

String

参数解释:

最近保存的浏览器名称。

取值范围:

长度1到64个字符。

last_saved_browser_session_id

String

参数解释:

最近保存的浏览器会话ID。

取值范围:

长度36到36个字符。

last_saved_browser_session_name

String

参数解释:

最近保存的浏览器会话名称。

取值范围:

长度1到128个字符。

last_saved_at

String

参数解释:

最近保存时间。

取值范围:

ISO 8601日期时间格式字符串。

tags

Array of CoreToolsTag objects

参数解释:

资源标签。

取值范围:

数组长度0到20个元素。

created_at

String

参数解释:

创建时间。

取值范围:

ISO 8601日期时间格式字符串。

表4 CoreToolsTag

参数

参数类型

描述

key

String

参数解释:

标签键,不能为空且同一资源下标签键不能重复。

取值范围:

符合规则^((?!\s)(?!sys)[\p{L}\p{Z}\p{N}.:/=+-@]*)(?<!\s)$,即可以包含任意语种的字母、数字和空格,以及.:=+-@字符,但首尾不能包含空格,且不能以_sys_开头,且长度在1到128之间。

value

String

参数解释:

标签值。

取值范围:

符合规则^([\p{L}\p{Z}\p{N}.:/=+-@]*)$,即可以包含任意语种的字母、数字和空格,以及.:/=+-@字符,且长度不能超过255个字符。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

长度1到4096个字符。

details

Array of CoreToolsCommonError objects

参数解释:

依赖的下游服务错误信息列表。

取值范围:

数组长度0到10个元素。

表8 CoreToolsCommonError

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:404

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:409

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:429

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

请求示例

POST /v1/core/browser-profiles

{
  "name" : "browser-profiles-demo",
  "description" : "des"
}

响应示例

状态码:201

创建成功。

{
  "id" : "306b7c12-a069-4b3e-9c1d-692f010cc37b",
  "name" : "browser-profiles-demo",
  "description" : "des",
  "created_at" : "2022-11-09 16:37:24"
}

状态码:400

请求参数错误。

{
  "error_code" : "AgentArts.04000400",
  "error_msg" : "Invalid parameter."
}

状态码:401

认证失败。

{
  "error_code" : "AgentArts.04000401",
  "error_msg" : "Authentication failed: invalid token."
}

状态码:403

权限不足。

{
  "error_code" : "AgentArts.04000403",
  "error_msg" : "Authentication failed: you have no permission of XXX",
  "encoded_authorization_message" : "eyJlcnJvciI6ICJVbmF1dGhvcml6ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.04000403",
    "error_msg" : "Authentication failed."
  } ]
}

状态码:404

资源不存在。

{
  "error_code" : "AgentArts.04000404",
  "error_msg" : "resource xxx not exist"
}

状态码:409

操作冲突。

{
  "error_code" : "AgentArts.04000409",
  "error_msg" : "operation conflict"
}

状态码:429

请求频率超限。

{
  "error_code" : "AgentArts.04000429",
  "error_msg" : "The interface has been limited."
}

状态码:500

内部系统错误。

{
  "error_code" : "AgentArts.04000500",
  "error_msg" : "Internal error"
}

状态码

状态码

描述

201

创建成功。

400

请求参数错误。

401

认证失败。

403

权限不足。

404

资源不存在。

409

操作冲突。

429

请求频率超限。

500

内部系统错误。

错误码

请参见错误码。

相关文档