# 发布评估器新版本 - PublishOpsEvaluatorVersion #### 功能介绍 该接口用于为指定的评估器创建并发布一个全新的快照版本，通过固化当前的判分逻辑与参数配置，实现评测标准的版本化管理与历史可追溯。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:evaluator:publishOpsEvaluatorVersion | Write | evaluator \* | g:ResourceTag/\ | - | - | #### URI POST /v1/ops/evaluators/{evaluator_id}/versions 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | evaluator_id | 是 | String | **参数解释：** 评估器的唯一标识符（ID）。可通过调用创建评估器接口获取，或通过查询评估器列表接口获取。该参数用于在路径中指定需要发布新版本的特定评估器。 **约束限制：** 不涉及。 **取值范围：** 由字母、数字和连字符（-）组成的字符串，长度为1\~100个字符。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | evaluator_type | 是 | Integer | **参数解释：** 评估器的核心执行模式。 **约束限制：** 不涉及。 **取值范围：** - 1: 模型评估器（模型评估器，基于大语言模型进行智能评判） - 2: 代码评估器（代码评估器，基于预设脚本逻辑进行规则判定） - 3: 自适应评估器 **默认取值：** 不涉及。 | | turn_type | 否 | String | **参数解释：** 评估器的轮次类型。 **约束限制：** 不涉及。 **取值范围：** - single: 单轮评估器 - multi: 多轮评估器 字符长度为0\~100个字符。 **默认取值：** 不涉及。 | | current_version | 是 | [EvaluationOpsCurrentVersion] object | **参数解释：** 评估器的当前版本信息，引用EvaluationOpsCurrentVersion对象。 **约束限制：** 不涉及。 | | name | 是 | String | **参数解释：** 评估器的业务名称。 **约束限制：** 不涉及。 **取值范围：** 由中英文、数字、下划线（_）、中划线（-）组成的字符串，长度为0\~10000个字符。 **默认取值：** 不涉及。 | | description | 是 | String | **参数解释：** 对该评估器的功能逻辑和判定准则的详细文字补充。 **约束限制：** 不涉及。 **取值范围：** 任意字符串，长度为0\~10000个字符。 **默认取值：** 不涉及。 | | tags | 否 | Array of [OpsTmsTag] objects | **参数解释：** 创建评估器时绑定的TMS标签列表。数组内每个元素为OpsTmsTag对象，包含标签的键值信息。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表3EvaluationOpsCurrentVersion | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | description | 否 | String | **参数解释：** 当前版本的详细描述信息。 **约束限制：** 长度为0到10000个字符。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | evaluator_content | 否 | Object | **参数解释：** 评估器的核心配置JSON内容，包含评估逻辑、评分规则等配置项。 **约束限制：** 符合评估器配置JSON结构定义。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | version | 否 | String | **参数解释：** 评估器的版本标识符。 **约束限制：** 0到10000字符。 **取值范围：** 符合语义化版本格式的字符串，如"v1.0.0"。 **默认取值：** 不涉及。 | 表4OpsTmsTag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 否 | String | **参数解释：** 标签键名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | value | 否 | String | **参数解释：** 标签值，存储该标签键对应的具体内容。 **约束限制：** 不涉及。 **取值范围：** 长度0-256个字符。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 提交新版本成功 无 #### 请求示例 为指定的评估器发布新版本，更新其 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** 提交新版本成功 ``` { } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 提交新版本成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。