文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估器管理/ 更新评估器内置模型类型 - UpdateOpsEvaluatorModelType
更新时间:2026-11-09 GMT+08:00
分享

更新评估器内置模型类型 - UpdateOpsEvaluatorModelType

功能介绍

该接口用于更新评估器使用的内置模型类型,支持在系统内置模型(builtin)与自定义模型(custom_model)之间切换。

适用场景:

  • 当需要在自定义模型和系统模型之前进行切换时调用该接口。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluator:updateOpsEvaluatorModelType

Write

customModelProvider

g:ResourceTag/<tag-key>

-

-

-

  • agentarts:AllowEgressPublicAccess

  • agentarts:ModelProviderType

URI

PUT /v1/ops/evaluators/model-type

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

model_type

是

String

参数解释:

评估器使用的模型类型。

约束限制:

不涉及。

取值范围:

  • builtin:原有系统模型

  • custom_model:自定义模型

默认取值:

不涉及。

custom_model

否

OpsEvaluatorCustomModelConfig object

参数解释:

自定义模型的详细配置。

约束限制:

当model_type取值为custom_model时,model_provider_id、model_id、model_proxy_id、security_group_ids、vpc_id、subnet_id为必填字段,model_provider_name、gateway_name、model_name为可选字段。security_group_ids可为空集合,数量0~5。

取值范围:

不涉及。

默认取值:

不涉及。

表2 OpsEvaluatorCustomModelConfig

参数

是否必选

参数类型

描述

model_provider_id

是

String

参数解释:

模型提供商ID。可通过McpGateway控制台或调用查询模型提供商列表接口获取。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

model_id

是

String

参数解释:

McpGateway上注册的模型ID。可通过McpGateway控制台或调用查询模型列表接口获取。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

model_proxy_id

是

String

参数解释:

McpGateway上model_proxy网关ID,即调用GET /v1/core/custom-model-providers/{custom_model_provider_id}接口返回的gateways中agent_gateway_id字段的值,表示客户选择的模型代理ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

security_group_ids

是

Array of strings

参数解释:

安全组ID列表,用于sandbox-proxy私网访问。可通过VPC控制台或调用查询安全组列表接口获取。

约束限制:

可为空集合,数量0~5。数组内每个元素(安全组ID)为长度0~64个字符的字符串。

取值范围:

不涉及。

默认取值:

不涉及。

vpc_id

是

String

参数解释:

模型代理使用的具体VPC信息。可通过VPC服务查询VPC列表获取VPC ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

subnet_id

是

String

参数解释:

模型代理使用的具体VPC子网信息。可通过VPC服务查询子网列表获取子网ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

model_provider_name

否

String

参数解释:

自定义模型提供商名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

gateway_name

否

String

参数解释:

自定义模型代理(网关)名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

model_name

否

String

参数解释:

自定义模型名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:204

无

状态码:400

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

字符长度2-512,任意文本内容。

encoded_authorization_message

String

参数解释:

编码后的授权信息,用于客户端解析权限问题。

取值范围:

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释:

错误详情列表,包含多个子错误的详细信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求的唯一标识符,用于问题排查和链路追踪。

取值范围:

符合通用唯一识别码(UUID)标准的字符串。

表4 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释:

子错误的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对子错误的详细描述。

取值范围:

字符长度2-512,任意文本内容。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

字符长度2-512,任意文本内容。

encoded_authorization_message

String

参数解释:

编码后的授权信息,用于客户端解析权限问题。

取值范围:

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释:

错误详情列表,包含多个子错误的详细信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求的唯一标识符,用于问题排查和链路追踪。

取值范围:

符合通用唯一识别码(UUID)标准的字符串。

表6 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释:

子错误的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对子错误的详细描述。

取值范围:

字符长度2-512,任意文本内容。

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

字符长度2-512,任意文本内容。

encoded_authorization_message

String

参数解释:

编码后的授权信息,用于客户端解析权限问题。

取值范围:

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释:

错误详情列表,包含多个子错误的详细信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求的唯一标识符,用于问题排查和链路追踪。

取值范围:

符合通用唯一识别码(UUID)标准的字符串。

表8 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释:

子错误的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对子错误的详细描述。

取值范围:

字符长度2-512,任意文本内容。

状态码:429

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

字符长度2-512,任意文本内容。

encoded_authorization_message

String

参数解释:

编码后的授权信息,用于客户端解析权限问题。

取值范围:

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释:

错误详情列表,包含多个子错误的详细信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求的唯一标识符,用于问题排查和链路追踪。

取值范围:

符合通用唯一识别码(UUID)标准的字符串。

表10 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释:

子错误的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对子错误的详细描述。

取值范围:

字符长度2-512,任意文本内容。

状态码:500

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

字符长度2-512,任意文本内容。

encoded_authorization_message

String

参数解释:

编码后的授权信息,用于客户端解析权限问题。

取值范围:

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释:

错误详情列表,包含多个子错误的详细信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求的唯一标识符,用于问题排查和链路追踪。

取值范围:

符合通用唯一识别码(UUID)标准的字符串。

表12 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释:

子错误的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对子错误的详细描述。

取值范围:

字符长度2-512,任意文本内容。

请求示例

将评估器使用的模型类型更新为自定义模型

PUT https://api.example.com/v1/ops/evaluators/model-type

{
  "model_type" : "custom_model",
  "custom_model" : {
    "model_provider_id" : "provider-123456",
    "model_id" : "model-123456",
    "model_proxy_id" : "gateway-123456",
    "security_group_ids" : [ "ade111ca-843f-4e20-a9a4-01a9aa22a3f9" ],
    "vpc_id" : "vpc-123456",
    "subnet_id" : "subnet-123456"
  }
}

响应示例

状态码:204

无

状态码:400

{
  "error_code" : "AgentArts.03400001",
  "error_msg" : "请求错误"
}

状态码:401

{
  "error_code" : "AgentArts.100004010",
  "error_msg" : "unauthorized"
}

状态码:403

{
  "error_code" : "AgentArts.100004030",
  "error_msg" : "forbidden",
  "encoded_authorization_message" : "",
  "details" : [ {
    "error_code" : "AgentArts.100004030",
    "error_msg" : "forbidden"
  } ],
  "request_id" : "a3f5e2b1-4c6d-4e8f-9a2b-1c3d5e7f9a2b"
}

状态码:429

{
  "error_code" : "AgentArts.100004290",
  "error_msg" : "请求过于频繁"
}

状态码:500

{
  "error_code" : "AgentArts.03500001",
  "error_msg" : "internal error"
}

状态码

状态码

描述

204

更新成功,无返回体

400

请求参数错误

401

认证失败

403

鉴权失败

429

请求过于频繁

500

系统错误

错误码

请参见错误码。

相关文档