文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估器管理/ 发布评估器新版本 - PublishOpsEvaluatorVersion
更新时间:2026-09-24 GMT+08:00
分享

发布评估器新版本 - PublishOpsEvaluatorVersion

功能介绍

该接口用于为指定的评估器创建并发布一个全新的快照版本,通过固化当前的判分逻辑与参数配置,实现评测标准的版本化管理与历史可追溯。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluator:publishOpsEvaluatorVersion

Write

evaluator *

g:ResourceTag/<tag-key>

-

-

URI

POST /v1/ops/evaluators/{evaluator_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

是

String

参数解释:

评估器的唯一标识符(ID)。可通过调用创建评估器接口获取,或通过查询评估器列表接口获取。该参数用于在路径中指定需要发布新版本的特定评估器。

约束限制:

不涉及。

取值范围:

由字母、数字和连字符(-)组成的字符串,长度为1~100个字符。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

evaluator_type

否

Integer

参数解释:

评估器的核心执行模式。

约束限制:

不涉及。

取值范围:

  • 1: 模型评估器(模型评估器,基于大语言模型进行智能评判)

  • 2: 代码评估器(代码评估器,基于预设脚本逻辑进行规则判定)

  • 3: 自适应评估器(自适应评估模式,可根据上下文与历史结果动态调整评判规则)

默认取值:

不涉及。

current_version

是

EvaluationOpsCurrentVersion object

参数解释:

评估器的当前版本信息,引用EvaluationOpsCurrentVersion对象。

约束限制:

不涉及。

name

是

String

参数解释:

评估器的业务名称。

约束限制:

不涉及。

取值范围:

由中英文、数字、下划线(_)、中划线(-)组成的字符串,长度为0~10000个字符。

默认取值:

不涉及。

description

否

String

参数解释:

对该评估器的功能逻辑和判定准则的详细文字补充。

约束限制:

不涉及。

取值范围:

任意字符串,长度为0~10000个字符。

默认取值:

不涉及。

tags

否

Array of OpsTmsTag objects

参数解释:

创建评估器时绑定的TMS标签列表。数组内每个元素为OpsTmsTag对象,包含标签的键值信息。

约束限制:

数组元素最小数量为0,最大数量为50。

取值范围:

不涉及。

默认取值:

不涉及。

表3 EvaluationOpsCurrentVersion

参数

是否必选

参数类型

描述

description

否

String

参数解释:

当前版本的详细描述信息。

约束限制:

长度为0到10000个字符。

取值范围:

不涉及。

默认取值:

不涉及。

evaluator_content

否

Object

参数解释:

评估器的核心配置JSON内容,包含评估逻辑、评分规则等配置项。

约束限制:

符合评估器配置JSON结构定义。

取值范围:

不涉及。

默认取值:

不涉及。

version

否

String

参数解释:

评估器的版本标识符。

约束限制:

0到10000字符。

取值范围:

符合语义化版本格式的字符串,如"v1.0.0"。

默认取值:

不涉及。

表4 OpsTmsTag

参数

是否必选

参数类型

描述

key

否

String

参数解释:

标签键名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

value

否

String

参数解释:

标签值,存储该标签键对应的具体内容。

约束限制:

不涉及。

取值范围:

由任意字符组成,长度为0~256个字符。

默认取值:

不涉及。

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

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

{ }

状态码

状态码

描述

200

提交新版本成功

错误码

请参见错误码。

相关文档