创建智能体 - CreateCoreAgent

agentarts:managedAgent:createCoreAgent

Write

environment *

g:ResourceTag/<tag-key>

-

• agentarts:runtime:createCoreRuntime
• iam:agencies:pass
• vpc:nativePorts:create
• vpc:routeTables:update
• eip:publicIps:associateInstance

managedAgent *

-

customModelProvider *

-

skill

-

-

• g:RequestTag/<tag-key>

• g:TagKeys

name

是

String

参数解释：

智能体名称。

约束限制：

同一账号下名称不可重复。

取值范围：

长度为2-40个字符，必须以小写字母开头、以小写字母或数字结尾，只能包含小写字母、数字和中划线。

默认取值：

不涉及。

description

否

String

参数解释：

智能体描述信息。

约束限制：

不涉及。

取值范围：

长度为0-4096个字符。

默认取值：

不涉及。

environment_id

是

String

参数解释：

关联的环境ID，指定该智能体运行的环境。获取方式：通过创建环境接口返回的environment_id字段获取。

约束限制：

创建后可通过更新智能体接口切换，切换时要求新旧环境网络配置一致。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

默认取值：

不涉及。

agent_gateway_id

否

String

参数解释：

智能体网关的唯一ID，用于智能体的入站流量路由。获取方式：通过AgentGateway的查询网关实例列表接口获取。

约束限制：

不涉及。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

默认取值：

不涉及。

model

是

Array of ModelConfig objects

参数解释：

模型配置列表，声明使用的模型提供商和模型，必须配置1个模型。

约束限制：

不涉及。

默认取值：

不涉及。

system_prompt

否

String

参数解释：

系统提示词。

约束限制：

不涉及。

取值范围：

长度为0-32768个字符。

默认取值：

不涉及。

allowed_tools

否

Array of strings

参数解释：

允许智能体使用的工具列表。*表示允许所有工具，也可指定具体工具名称（如bash、write_file、read_file、glob、edit_file、list_files、grep），元素个数0-100个，每个工具名的长度为1-128个字符。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

skills

否

Array of AgentSkill objects

参数解释：

技能列表，来源于我的资产。上限50个。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

identity_configuration

否

IdentityConfiguration object

参数解释：

入站身份认证配置，创建后不可修改。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

execution_agency_name

否

String

参数解释：

执行委托名称（华为云IAM委托格式），运行时以此委托身份访问云资源。

约束限制：

不涉及。

取值范围：

长度为1-64个字符。

默认取值：

不涉及。

lifecycle_config

否

lifecycle_config object

参数解释：

运行时生命周期配置，用于配置空闲会话超时与最大存活时间。不填时使用平台默认配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

observability

否

ObservabilityConfiguration object

参数解释：

可观测性配置。不填时使用平台默认配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

provider_id

是

String

参数解释：

模型提供商ID，模型网关界面打开控制台刷新后可以获取模型供应商ID。

约束限制：

必须为UUID格式，不能为空。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

默认取值：

不涉及。

model_id

是

String

参数解释：

模型ID，在模型网关界面打开模型提供商后通过控制台刷新可以获取模型ID。

约束限制：

必须为UUID格式，不能为空。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

默认取值：

不涉及。

skill_id

是

String

参数解释：

引用已创建的Skill资源的唯一标识ID。来源于我的资产。

约束限制：

Skill资源需提前创建。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

默认取值：

不涉及。

skill_name

是

String

参数解释：

引用已创建的Skill资源名称。来源于我的资产。

约束限制：

Skill资源需提前创建。

取值范围：

长度为1-128个字符。

默认取值：

不涉及。

description

否

String

参数解释：

技能在当前智能体中的用途说明，便于理解该技能在此智能体场景下的作用。

约束限制：

不涉及。

取值范围：

长度为0-4096个字符。

默认取值：

不涉及。

version

否

Integer

参数解释：

引用的Skill资源版本号。

约束限制：

未指定时使用Skill资源的最新版本。

取值范围：

1-10000。

默认取值：

不涉及。

authorizer_type

是

String

参数解释：

智能体运行时所需的入站认证类型，智能体网关将根据该配置进行入站认证。

约束限制：

不涉及。

取值范围：

长度为1-10个字符。允许的值：

• CUSTOM_JWT：OAuth 2.0认证方式，使用自定义JWT认证机制。

• IAM：使用IAM签名认证机制。

• API_KEY：使用自定义API Key进行认证。

默认取值：

IAM

authorizer_configuration

否

authorizer_configuration object

参数解释：

运行时入站认证配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

urn

否

String

参数解释：

系统自动生成的资源标识符，用于唯一标识认证配置。

约束限制：

系统自动生成，请求时不传，响应时返回。

取值范围：

长度为0-1024个字符。

默认取值：

不涉及。

custom_jwt

否

custom_jwt object

参数解释：

运行时自定义JWT类型认证配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

key_auth

否

key_auth object

参数解释：

APIKEY入站认证配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

discovery_url

是

String

参数解释：

此URL用于获取OpenIDConnect配置或授权服务器元数据，以验证传入的令牌。

约束限制：

不涉及。

取值范围：

长度为1-2048个字符。

默认取值：

不涉及。

allowed_audience

是

Array of strings

参数解释：

允许对入站JWT进行验证的受众值列表，元素个数0-10个，每个受众值元素的长度为1-512个字符。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

allowed_clients

否

Array of strings

参数解释：

允许用于入站JWT验证的客户端标识符值列表，元素个数0-50个，每个客户端值的长度为1-256个字符。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

allowed_scopes

否

Array of strings

参数解释：

允许对入站JWT进行验证的范围值列表，元素个数0-50个，每个范围值的长度为1-256个字符。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

custom_claims

否

Array of custom_claims objects

参数解释：

对入站JWT应用自定义声明验证规则，最小数量1，最大数量20。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

inbound_token_claim_name

否

String

参数解释：

要检查的自定义声明字段的名称。

约束限制：

不涉及。

取值范围：

长度为1-255个字符，只包含字母数字、下划线、点号、中划线和冒号。

默认取值：

不涉及。

inbound_token_claim_value_type

否

String

参数解释：

要检查的声明值的数据类型。

约束限制：

不涉及。

取值范围：

长度为1-12个字符。允许的值：

• STRING：表示字符串类型。

• STRING_ARRAY：表示字符串数组类型。

默认取值：

不涉及。

authorizing_claim_match_value

否

authorizing_claim_match_value object

参数解释：

自定义声明匹配配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

claim_match_operator

否

String

参数解释：

定义声明字段值与要匹配的值之间的关系。

约束限制：

不涉及。

取值范围：

长度为1-12个字符。允许的值：

• EQUALS：表示完全匹配。

• CONTAINS：表示包含匹配项。

• CONTAINS_ANY：表示包含任意匹配项。

默认取值：

不涉及。

claim_match_value

否

claim_match_value object

参数解释：

入站认证需要校验的自定义Claim字段所需要的匹配策略。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

match_value_string

否

String

参数解释：

入站认证需要校验的自定义Claim字段所要匹配的字符串值。

约束限制：

不涉及。

取值范围：

长度为1-255个字符，只包含字母数字、下划线、点号和中划线。

默认取值：

不涉及。

match_value_string_list

否

Array of strings

参数解释：

入站认证需要校验的自定义Claim字段所要匹配的字符串值列表，最小数量1，最大数量50，每个值的长度为1-255个字符。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

api_keys

否

Array of api_keys objects

参数解释：

入站认证允许的所有的APIKEY密钥列表（响应中api_key脱敏），最小数量0，最大数量10。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

api_key

否

String

参数解释：

API密钥值。轮换期间，可以使用其中任何一个密钥。如果密钥为空，则会生成一个随机字符串。

约束限制：

不涉及。

取值范围：

长度为1-512个字符，只包含字母数字、中划线和下划线。

默认取值：

不涉及。

api_key_name

否

String

参数解释：

API密钥名称，该名称仅用于标识该密钥，不用于实际认证。

约束限制：

不涉及。

取值范围：

长度为0-64个字符，只包含字母数字、中划线和下划线。

默认取值：

不涉及。

idle_session_timeout_sec

否

Integer

参数解释：

空闲会话超时（秒）。

约束限制：

不涉及。

取值范围：

null或[60,604800]（含边界，604800秒=7天）。

默认取值：

900秒（15分钟）。

max_alive_time_sec

否

Integer

参数解释：

最大存活时间（秒）。

约束限制：

不涉及。

取值范围：

null或[60,604800]（含边界，604800秒=7天）。

默认取值：

86400秒（24小时）。

logs

否

ObservabilityLogsConfig object

参数解释：

日志采集配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

enabled

否

Boolean

参数解释：

是否开启日志采集。

约束限制：

不涉及。

取值范围：

• true：托管运行时过程产生的日志会上报云日志服务(LTS)。

• false：托管运行时过程产生的日志无法上报至云日志服务(LTS)。

默认取值：

false

agent_id

String

参数解释：

智能体唯一标识，由系统自动生成。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

name

String

参数解释：

智能体名称。

取值范围：

长度为2-40个字符，必须以小写字母开头、以小写字母或数字结尾，只能包含小写字母、数字和中划线。

description

String

参数解释：

智能体描述信息。

取值范围：

长度为0-4096个字符。

environment_id

String

参数解释：

关联的环境ID，创建后不可修改。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

agent_gateway_id

String

参数解释：

智能体网关的唯一ID，用于智能体的入站流量路由。获取方式：通过AgentGateway的查询网关实例列表接口获取。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

model

Array of ModelConfigResp objects

参数解释：

模型配置列表，包含模型提供商和模型的详细信息，元素个数1个。

取值范围：

不涉及。

system_prompt

String

参数解释：

系统提示词。

取值范围：

长度为0-32768个字符。

allowed_tools

Array of strings

参数解释：

允许智能体使用的工具列表。*表示允许所有工具，也可指定具体工具名称（如bash、write_file、read_file、glob、edit_file、list_files、grep），元素个数0-100个，每个工具名的长度为1-128个字符。

取值范围：

不涉及。

skills

Array of AgentSkill objects

参数解释：

技能列表，来源于我的资产，上限50个。

取值范围：

不涉及。

identity_configuration

IdentityConfiguration object

参数解释：

入站身份认证配置，创建后不可修改。响应中api_key脱敏。

取值范围：

不涉及。

workload_identity_urn

String

参数解释：

工作负载身份URN，由系统自动生成，用于运行时身份认证。未配置时为null。

取值范围：

长度为0-512个字符，可包含小写字母、数字、冒号、下划线和中划线（IAMURN格式）。

access_endpoint

String

参数解释：

智能体的访问端点URL，由系统自动生成。未配置时为null。

取值范围：

长度为0-512个字符。

execution_agency_name

String

参数解释：

执行委托名称（华为云IAM委托格式），运行时以此委托身份访问云资源。未配置时为null。

取值范围：

长度为1-64个字符。

lifecycle_config

lifecycle_config object

参数解释：

运行时生命周期配置，用于配置空闲会话超时与最大存活时间。未配置时为null（使用平台默认配置）。

取值范围：

不涉及。

observability

observability object

参数解释：

可观测性配置。未配置时为null（使用平台默认配置）。

取值范围：

不涉及。

latest_version

String

参数解释：

最新版本号。创建时为v1，每次更新由平台自动递增。

取值范围：

匹配小写字母开头、数字结尾的版本号格式，如v1、v2。

created_by

String

参数解释：

创建者用户ID，由系统自动记录。

取值范围：

长度为0-128个字符。

created_at

String

参数解释：

创建时间，UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ，由系统自动生成。

取值范围：

不涉及。

updated_at

String

参数解释：

更新时间，UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ，由系统自动生成。

取值范围：

不涉及。

provider_id

String

参数解释：

模型提供商ID。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

provider_name

String

参数解释：

模型提供商名称。

取值范围：

长度为0-64个字符。

model_id

String

参数解释：

模型ID。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

model_name

String

参数解释：

模型名称。

取值范围：

长度为0-128个字符。

skill_id

String

参数解释：

引用已创建的Skill资源的唯一标识ID。来源于我的资产。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。

skill_name

String

参数解释：

引用已创建的Skill资源名称。来源于我的资产。

取值范围：

长度为1-128个字符。

description

String

参数解释：

技能在当前智能体中的用途说明，便于理解该技能在此智能体场景下的作用。

取值范围：

长度为0-4096个字符。

version

Integer

参数解释：

引用的Skill资源版本号。

取值范围：

1-10000。

authorizer_type

String

参数解释：

智能体运行时所需的入站认证类型，智能体网关将根据该配置进行入站认证。

取值范围：

长度为1-10个字符。允许的值：

• CUSTOM_JWT：OAuth 2.0认证方式，使用自定义JWT认证机制。

• IAM：使用IAM签名认证机制。

• API_KEY：使用自定义API Key进行认证。

authorizer_configuration

authorizer_configuration object

参数解释：

运行时入站认证配置。

取值范围：

不涉及。

urn

String

参数解释：

系统自动生成的资源标识符，用于唯一标识认证配置。

取值范围：

长度为0-1024个字符。

custom_jwt

custom_jwt object

参数解释：

运行时自定义JWT类型认证配置。

取值范围：

不涉及。

key_auth

key_auth object

参数解释：

APIKEY入站认证配置。

取值范围：

不涉及。

discovery_url

String

参数解释：

此URL用于获取OpenIDConnect配置或授权服务器元数据，以验证传入的令牌。

取值范围：

长度为1-2048个字符。

allowed_audience

Array of strings

参数解释：

允许对入站JWT进行验证的受众值列表，元素个数0-10个，每个受众值元素的长度为1-512个字符。

取值范围：

不涉及。

allowed_clients

Array of strings

参数解释：

允许用于入站JWT验证的客户端标识符值列表，元素个数0-50个，每个客户端值的长度为1-256个字符。

取值范围：

不涉及。

allowed_scopes

Array of strings

参数解释：

允许对入站JWT进行验证的范围值列表，元素个数0-50个，每个范围值的长度为1-256个字符。

取值范围：

不涉及。

custom_claims

Array of custom_claims objects

参数解释：

对入站JWT应用自定义声明验证规则，最小数量1，最大数量20。

取值范围：

不涉及。

inbound_token_claim_name

String

参数解释：

要检查的自定义声明字段的名称。

取值范围：

长度为1-255个字符，只包含字母数字、下划线、点号、中划线和冒号。

inbound_token_claim_value_type

String

参数解释：

要检查的声明值的数据类型。

取值范围：

长度为1-12个字符。允许的值：

• STRING：表示字符串类型。

• STRING_ARRAY：表示字符串数组类型。

authorizing_claim_match_value

authorizing_claim_match_value object

参数解释：

自定义声明匹配配置。

取值范围：

不涉及。

claim_match_operator

String

参数解释：

定义声明字段值与要匹配的值之间的关系。

取值范围：

长度为1-12个字符。允许的值：

• EQUALS：表示完全匹配。

• CONTAINS：表示包含匹配项。

• CONTAINS_ANY：表示包含任意匹配项。

claim_match_value

claim_match_value object

参数解释：

入站认证需要校验的自定义Claim字段所需要的匹配策略。

取值范围：

不涉及。

match_value_string

String

参数解释：

入站认证需要校验的自定义Claim字段所要匹配的字符串值。

取值范围：

长度为1-255个字符，只包含字母数字、下划线、点号和中划线。

match_value_string_list

Array of strings

参数解释：

入站认证需要校验的自定义Claim字段所要匹配的字符串值列表，最小数量1，最大数量50，每个值的长度为1-255个字符。

取值范围：

不涉及。

api_keys

Array of api_keys objects

参数解释：

入站认证允许的所有的APIKEY密钥列表（响应中api_key脱敏），最小数量0，最大数量10。

取值范围：

不涉及。

api_key

String

参数解释：

API密钥值。轮换期间，可以使用其中任何一个密钥。如果密钥为空，则会生成一个随机字符串。

取值范围：

长度为1-512个字符，只包含字母数字、中划线和下划线。

api_key_name

String

参数解释：

API密钥名称，该名称仅用于标识该密钥，不用于实际认证。

取值范围：

长度为0-64个字符，只包含字母数字、中划线和下划线。

idle_session_timeout_sec

Integer

参数解释：

空闲会话超时（秒）。

取值范围：

null或[60,604800]（含边界，604800秒=7天）。

max_alive_time_sec

Integer

参数解释：

最大存活时间（秒）。

取值范围：

null或[60,604800]（含边界，604800秒=7天）。

logs

logs object

参数解释：

日志采集配置。

取值范围：

不涉及。

enabled

Boolean

参数解释：

是否开启日志采集。

取值范围：

• true：启用。

• false：停用。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。

取值范围：

固定值：AgentArts.03000400。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。

取值范围：

固定值：AgentArts.03000401。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000403表示禁止访问（认证后权限不足）。

取值范围：

固定值：AgentArts.03000403。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

coded_authorization_message

String

参数解释：

当API无访问权限时报错信息。

取值范围：

长度为1-1024个字符。

details

Array of ManagedAgentErrorDetail objects

参数解释：

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

取值范围：

最小数量0，最大数量10。

error_code

String

参数解释：

错误码。

取值范围：

长度为18个字符。

error_msg

String

参数解释：

错误信息。

取值范围：

长度为1-1024个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000409表示资源冲突。

取值范围：

固定值：AgentArts.03000409。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。

取值范围：

固定值：AgentArts.03000429。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。

取值范围：

固定值：AgentArts.03000500。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

201

创建成功，返回智能体详细信息。

400

请求参数错误。

401

未授权（认证令牌缺失、无效或已过期）。

403

禁止访问（认证后权限不足）。

409

资源冲突（如智能体名称已存在）。

429

请求过于频繁（触发限流）。

500

服务器内部错误。