发布评估器新版本 - PublishOpsEvaluatorVersion
功能介绍
该接口用于为指定的评估器创建并发布一个全新的快照版本,通过固化当前的判分逻辑与参数配置,实现评测标准的版本化管理与历史可追溯。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
URI
POST /v1/ops/evaluators/{evaluator_id}/versions
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| evaluator_id | 是 | String | 参数解释: 评估器的唯一标识符(ID)。可通过调用创建评估器接口获取,或通过查询评估器列表接口获取。该参数用于在路径中指定需要发布新版本的特定评估器。 约束限制: 不涉及。 取值范围: 由字母、数字和连字符(-)组成的字符串,长度为1~100个字符。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| evaluator_type | 否 | Integer | 参数解释: 评估器的核心执行模式 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| current_version | 是 | EvaluationOpsCurrentVersion object | 参数解释: 评估器的内容配置,引用EvaluationOpsCurrentVersion对象 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| name | 否 | String | 参数解释: 评估器的业务名称 约束限制: 不涉及。 取值范围: 由中英文、数字、下划线(_)、中划线(-)组成的字符串,长度为0~100个字符 默认取值: 不涉及。 |
| description | 否 | String | 参数解释: 版本描述信息。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tags | 否 | Array of OpsTmsTag objects | 参数解释: 评估器绑定的TMS标签列表。数组元素引用OpsTmsTag对象。 约束限制: 数组元素最小数量为0,最大数量为20。 取值范围: 不涉及。 默认取值: |
| model_type | 否 | String | 参数解释: 评估器使用的模型类型 约束限制: 不涉及。 取值范围: 默认取值: builtin。 |
| custom_model | 否 | 参数解释: 自定义模型的详细配置。 约束限制: 当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。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| description | 否 | String | 参数解释: 当前版本的详细描述信息。 约束限制: 长度为0到10000个字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
| evaluator_content | 否 | Object | 参数解释: 评估器的核心配置JSON内容,包含评估逻辑、评分规则等配置项。 约束限制: 符合评估器配置JSON结构定义。 取值范围: 不涉及。 默认取值: 不涉及。 |
| version | 否 | String | 参数解释: 评估器的版本标识符。 约束限制: 0到10000字符。 取值范围: 符合语义化版本格式的字符串,如"v1.0.0"。 默认取值: 不涉及。 |
| version_description | 否 | String | 参数解释: 版本描述信息。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| turn_type | 否 | String | 参数解释: 对话类型,支持单轮或多轮评估。 约束限制: 不涉及。 取值范围: 默认取值: single(不传默认为单轮)。 |
| evaluator_type | 否 | Integer | 参数解释: 评估器类型。 约束限制: 不涉及。 取值范围: 非负整数,最小值为0,最大值为2147483647。 默认取值: 1。 |
| evaluator_content_type | 否 | String | 参数解释: 评估内容类型。 约束限制: 不涉及。 取值范围: 默认取值: text(不传默认为文本)。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| key | 否 | String | 参数解释: 标签键名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| value | 否 | String | 参数解释: 标签值,存储该标签键对应的具体内容。 约束限制: 不涉及。 取值范围: 由任意字符组成,长度为0~256个字符。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 参数解释: 自定义模型名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| version | String | 参数解释: 新发布的版本号。 取值范围: 不涉及。 |
请求示例
为指定的评估器发布新版本,更新其 Prompt 模板或模型配置。
POST https://api.example.com/v1/ops/evaluators/7590068991923321858/versions
{
"evaluator_type" : 1,
"current_version" : {
"description" : "description",
"evaluator_content" : { },
"version" : "v1.0.0"
},
"name" : "正确性评估",
"description" : "评估提交的内容是否正确、准确、真实,并完整覆盖核心要点。"
} 响应示例
状态码:200
{
"version" : "v1.0.0"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 提交新版本成功 |
错误码
请参见错误码。