# 创建智能体 - CreateCoreAgent #### 功能介绍 创建一个新的智能体实例。智能体为最外层实体，整合模型、工具、技能、环境、身份、记忆等配置。 **适用场景：** 创建一个托管智能体，包含模型、工具集、技能、环境绑定、身份认证等完整配置。 **架构说明：** 智能体（做什么）与环境（在哪跑）正交解耦。创建智能体时需引用一个环境。 **约束限制：** - identity_configuration（入站身份认证）创建后不可修改。 - environment_id创建后可通过更新智能体接口切换，切换时要求新旧环境网络配置一致。 - skills上限50个，来源于我的资产。 - 模型依赖模型网关，选用等内容遵循模型管理模块定义。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:managedAgent:createCoreAgent | Write | environment \* | g:ResourceTag/\ | - | - agentarts:runtime:createCoreRuntime - iam:agencies:pass - vpc:nativePorts:create - vpc:routeTables:update - eip:publicIps:associateInstance | | agentarts:managedAgent:createCoreAgent | Write | managedAgent \* | - | - | - agentarts:runtime:createCoreRuntime - iam:agencies:pass - vpc:nativePorts:create - vpc:routeTables:update - eip:publicIps:associateInstance | | agentarts:managedAgent:createCoreAgent | Write | customModelProvider \* | - | - | - agentarts:runtime:createCoreRuntime - iam:agencies:pass - vpc:nativePorts:create - vpc:routeTables:update - eip:publicIps:associateInstance | | agentarts:managedAgent:createCoreAgent | Write | skill | - | - | - agentarts:runtime:createCoreRuntime - iam:agencies:pass - vpc:nativePorts:create - vpc:routeTables:update - eip:publicIps:associateInstance | | agentarts:managedAgent:createCoreAgent | Write | - | - g:RequestTag/\ - g:TagKeys | - | - agentarts:runtime:createCoreRuntime - iam:agencies:pass - vpc:nativePorts:create - vpc:routeTables:update - eip:publicIps:associateInstance | #### URI POST /v1/core/agents #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释**： 智能体名称。 **约束限制**： 同一账号下名称不可重复。 **取值范围**： 长度为2-40个字符，必须以小写字母开头、以小写字母或数字结尾，只能包含小写字母、数字和中划线。 **默认取值**： 不涉及。 | | description | 否 | String | **参数解释**： 智能体描述信息。 **约束限制**： 不涉及。 **取值范围**： 长度为0-4096个字符。 **默认取值**： 不涉及。 | | environment_id | 是 | String | **参数解释**： 关联的环境ID，指定该智能体运行的环境。获取方式：通过[创建环境接口](https://support.huaweicloud.com/api-agentarts/CreateCoreEnvironment.html)返回的environment_id字段获取。 **约束限制**： 创建后可通过更新智能体接口切换，切换时要求新旧环境网络配置一致。 **取值范围**： 匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），例如0451ff49-3c47-4049-851c-51c23fe7fe69。 **默认取值**： 不涉及。 | | agent_gateway_id | 否 | String | **参数解释**： 智能体网关的唯一ID，用于智能体的入站流量路由。获取方式：通过AgentGateway的[查询网关实例列表](https://support.huaweicloud.com/api-agentarts/ListCoreIngresses.html)接口获取。 **约束限制**： 不涉及。 **取值范围**： 匹配标准的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 | **参数解释**： 可观测性配置。不填时使用平台默认配置。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表2ModelConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 **默认取值**： 不涉及。 | 表3AgentSkill | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 **默认取值**： 不涉及。 | 表4IdentityConfiguration | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | authorizer_type | 是 | String | **参数解释**： 智能体运行时所需的入站认证类型，智能体网关将根据该配置进行入站认证。 **约束限制**： 不涉及。 **取值范围**： 长度为1-10个字符。允许的值： - CUSTOM_JWT：OAuth 2.0认证方式，使用自定义JWT认证机制。 - IAM：使用IAM签名认证机制。 - API_KEY：使用自定义API Key进行认证。 **默认取值**： IAM | | authorizer_configuration | 否 | [authorizer_configuration] object | **参数解释**： 运行时入站认证配置。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表5authorizer_configuration | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | urn | 否 | String | **参数解释**： 系统自动生成的资源标识符，用于唯一标识认证配置。 **约束限制**： 系统自动生成，请求时不传，响应时返回。 **取值范围**： 长度为0-1024个字符。 **默认取值**： 不涉及。 | | custom_jwt | 否 | [custom_jwt] object | **参数解释**： 运行时自定义JWT类型认证配置。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | key_auth | 否 | [key_auth] object | **参数解释**： APIKEY入站认证配置。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表6custom_jwt | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表7custom_claims | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | **参数解释**： 自定义声明匹配配置。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表8authorizing_claim_match_value | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | claim_match_operator | 否 | String | **参数解释**： 定义声明字段值与要匹配的值之间的关系。 **约束限制**： 不涉及。 **取值范围**： 长度为1-12个字符。允许的值： - EQUALS：表示完全匹配。 - CONTAINS：表示包含匹配项。 - CONTAINS_ANY：表示包含任意匹配项。 **默认取值**： 不涉及。 | | claim_match_value | 否 | [claim_match_value] object | **参数解释**： 入站认证需要校验的自定义Claim字段所需要的匹配策略。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表9claim_match_value | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | match_value_string | 否 | String | **参数解释**： 入站认证需要校验的自定义Claim字段所要匹配的字符串值。 **约束限制**： 不涉及。 **取值范围**： 长度为1-255个字符，只包含字母数字、下划线、点号和中划线。 **默认取值**： 不涉及。 | | match_value_string_list | 否 | Array of strings | **参数解释**： 入站认证需要校验的自定义Claim字段所要匹配的字符串值列表，最小数量1，最大数量50，每个值的长度为1-255个字符。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表10key_auth | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | api_keys | 否 | Array of [api_keys] objects | **参数解释**： 入站认证允许的所有的APIKEY密钥列表（响应中api_key脱敏），最小数量0，最大数量10。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表11api_keys | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | api_key | 否 | String | **参数解释**： API密钥值。轮换期间，可以使用其中任何一个密钥。如果密钥为空，则会生成一个随机字符串。 **约束限制**： 不涉及。 **取值范围**： 长度为1-512个字符，只包含字母数字、中划线和下划线。 **默认取值**： 不涉及。 | | api_key_name | 否 | String | **参数解释**： API密钥名称，该名称仅用于标识该密钥，不用于实际认证。 **约束限制**： 不涉及。 **取值范围**： 长度为0-64个字符，只包含字母数字、中划线和下划线。 **默认取值**： 不涉及。 | 表12lifecycle_config | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | idle_session_timeout_sec | 否 | Integer | **参数解释**： 空闲会话超时（秒）。 **约束限制**： 不涉及。 **取值范围**： null或\[60,604800\]（含边界，604800秒=7天）。 **默认取值**： 900秒（15分钟）。 | | max_alive_time_sec | 否 | Integer | **参数解释**： 最大存活时间（秒）。 **约束限制**： 不涉及。 **取值范围**： null或\[60,604800\]（含边界，604800秒=7天）。 **默认取值**： 86400秒（24小时）。 | 表13ObservabilityConfiguration | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | logs | 否 | [ObservabilityLogsConfig] object | **参数解释**： 日志采集配置。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | 表14ObservabilityLogsConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | enabled | 否 | Boolean | **参数解释**： 是否开启日志采集。 **约束限制**： 不涉及。 **取值范围**： - true：托管运行时过程产生的日志会上报云日志服务(LTS)。 - false：托管运行时过程产生的日志无法上报至云日志服务(LTS)。 **默认取值**： false | #### 响应参数 **状态码：201** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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的[查询网关实例列表接口](https://support.huaweicloud.com/api-agentarts/ListCoreIngresses.html)获取。 **取值范围**： 匹配标准的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，由系统自动生成。 **取值范围**： 不涉及。 | 表16ModelConfigResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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个字符。 | 表17AgentSkill | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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。 | 表18IdentityConfiguration | 参数 | 参数类型 | 描述 | |:---|:---|:---| | authorizer_type | String | **参数解释**： 智能体运行时所需的入站认证类型，智能体网关将根据该配置进行入站认证。 **取值范围**： 长度为1-10个字符。允许的值： - CUSTOM_JWT：OAuth 2.0认证方式，使用自定义JWT认证机制。 - IAM：使用IAM签名认证机制。 - API_KEY：使用自定义API Key进行认证。 | | authorizer_configuration | [authorizer_configuration] object | **参数解释**： 运行时入站认证配置。 **取值范围**： 不涉及。 | 表19authorizer_configuration | 参数 | 参数类型 | 描述 | |:---|:---|:---| | urn | String | **参数解释**： 系统自动生成的资源标识符，用于唯一标识认证配置。 **取值范围**： 长度为0-1024个字符。 | | custom_jwt | [custom_jwt] object | **参数解释**： 运行时自定义JWT类型认证配置。 **取值范围**： 不涉及。 | | key_auth | [key_auth] object | **参数解释**： APIKEY入站认证配置。 **取值范围**： 不涉及。 | 表20custom_jwt | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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。 **取值范围**： 不涉及。 | 表21custom_claims | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释**： 自定义声明匹配配置。 **取值范围**： 不涉及。 | 表22authorizing_claim_match_value | 参数 | 参数类型 | 描述 | |:---|:---|:---| | claim_match_operator | String | **参数解释**： 定义声明字段值与要匹配的值之间的关系。 **取值范围**： 长度为1-12个字符。允许的值： - EQUALS：表示完全匹配。 - CONTAINS：表示包含匹配项。 - CONTAINS_ANY：表示包含任意匹配项。 | | claim_match_value | [claim_match_value] object | **参数解释**： 入站认证需要校验的自定义Claim字段所需要的匹配策略。 **取值范围**： 不涉及。 | 表23claim_match_value | 参数 | 参数类型 | 描述 | |:---|:---|:---| | match_value_string | String | **参数解释**： 入站认证需要校验的自定义Claim字段所要匹配的字符串值。 **取值范围**： 长度为1-255个字符，只包含字母数字、下划线、点号和中划线。 | | match_value_string_list | Array of strings | **参数解释**： 入站认证需要校验的自定义Claim字段所要匹配的字符串值列表，最小数量1，最大数量50，每个值的长度为1-255个字符。 **取值范围**： 不涉及。 | 表24key_auth | 参数 | 参数类型 | 描述 | |:---|:---|:---| | api_keys | Array of [api_keys] objects | **参数解释**： 入站认证允许的所有的APIKEY密钥列表（响应中api_key脱敏），最小数量0，最大数量10。 **取值范围**： 不涉及。 | 表25api_keys | 参数 | 参数类型 | 描述 | |:---|:---|:---| | api_key | String | **参数解释**： API密钥值。轮换期间，可以使用其中任何一个密钥。如果密钥为空，则会生成一个随机字符串。 **取值范围**： 长度为1-512个字符，只包含字母数字、中划线和下划线。 | | api_key_name | String | **参数解释**： API密钥名称，该名称仅用于标识该密钥，不用于实际认证。 **取值范围**： 长度为0-64个字符，只包含字母数字、中划线和下划线。 | 表26lifecycle_config | 参数 | 参数类型 | 描述 | |:---|:---|:---| | idle_session_timeout_sec | Integer | **参数解释**： 空闲会话超时（秒）。 **取值范围**： null或\[60,604800\]（含边界，604800秒=7天）。 | | max_alive_time_sec | Integer | **参数解释**： 最大存活时间（秒）。 **取值范围**： null或\[60,604800\]（含边界，604800秒=7天）。 | 表27observability | 参数 | 参数类型 | 描述 | |:---|:---|:---| | logs | [logs] object | **参数解释**： 日志采集配置。 **取值范围**： 不涉及。 | 表28logs | 参数 | 参数类型 | 描述 | |:---|:---|:---| | enabled | Boolean | **参数解释**： 是否开启日志采集。 **取值范围**： - true：启用。 - false：停用。 | **状态码：400** 表29响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。 **取值范围**： 固定值：AgentArts.03000400。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为1-512个字符。 | **状态码：401** 表30响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。 **取值范围**： 固定值：AgentArts.03000401。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为1-512个字符。 | **状态码：403** 表31响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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。 | 表32ManagedAgentErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 长度为18个字符。 | | error_msg | String | **参数解释**： 错误信息。 **取值范围**： 长度为1-1024个字符。 | **状态码：409** 表33响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000409表示资源冲突。 **取值范围**： 固定值：AgentArts.03000409。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为1-512个字符。 | **状态码：429** 表34响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。 **取值范围**： 固定值：AgentArts.03000429。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为1-512个字符。 | **状态码：500** 表35响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。 **取值范围**： 固定值：AgentArts.03000500。 | | error_msg | String | **参数解释**： 错误详细信息。 **取值范围**： 长度为1-512个字符。 | #### 请求示例 创建带MCP工具和环境绑定的智能体 ``` POST https://{Endpoint}/v1/core/agents { "name" : "agent-l1ppk", "description" : "智能客服助手", "environment_id" : "f47ac10b-58cc-4372-a567-0e02b2c3d479", "agent_gateway_id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "model" : [ { "provider_id" : "a1b2c3d4-1234-5678-abcd-e1f2a3b4c5d6", "model_id" : "b2c3d4e5-1234-5678-abcd-e1f2a3b4c5d6" } ], "system_prompt" : "You are a helpful assistant.", "allowed_tools" : [ "*", "bash", "file_operations" ], "skills" : [ { "skill_id" : "4b66da54-5383-489b-bb7e-43c946cb9505", "skill_name" : "code-review", "description" : "对代码变更进行自动化审查" } ], "identity_configuration" : { "authorizer_type" : "IAM" }, "execution_agency_name" : "default-agency", "lifecycle_config" : { "idle_session_timeout_sec" : 900, "max_alive_time_sec" : 86400 } } ``` #### 响应示例 **状态码：201** ``` { "agent_id" : "a1b2c3d4-1234-5678-abcd-e1f2a3b4c5d6", "name" : "agent-l1ppk", "description" : "智能客服助手", "environment_id" : "f47ac10b-58cc-4372-a567-0e02b2c3d479", "agent_gateway_id" : "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "model" : [ { "provider_id" : "a1b2c3d4-1234-5678-abcd-e1f2a3b4c5d6", "provider_name" : "huawei", "model_id" : "b2c3d4e5-1234-5678-abcd-e1f2a3b4c5d6", "model_name" : "claude-sonnet-4-6" } ], "system_prompt" : "You are a helpful assistant.", "allowed_tools" : [ "*", "bash", "file_operations" ], "skills" : [ { "skill_id" : "4b66da54-5383-489b-bb7e-43c946cb9505", "skill_name" : "code-review", "description" : "对代码变更进行自动化审查" } ], "workload_identity_urn" : "urn:iam::677563056420:identity::agent-a1b2c3d4e5", "execution_agency_name" : "default-agency", "lifecycle_config" : { "idle_session_timeout_sec" : 900, "max_alive_time_sec" : 86400 }, "latest_version" : "v1", "created_at" : "2024-05-20T14:30:00Z", "updated_at" : "2024-05-20T14:30:00Z" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 201 | 创建成功，返回智能体详细信息。 | | 400 | 请求参数错误。 | | 401 | 未授权（认证令牌缺失、无效或已过期）。 | | 403 | 禁止访问（认证后权限不足）。 | | 409 | 资源冲突（如智能体名称已存在）。 | | 429 | 请求过于频繁（触发限流）。 | | 500 | 服务器内部错误。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。