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

发布评估器新版本 - PublishOpsEvaluatorVersion

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

String

参数解释:

评估器的唯一标识符(ID)。该参数用于在路径中指定需要发布新版本的特定评估器。

约束限制:

长度为 1到100个字符。

取值范围:

存在的评估器ID。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

evaluator_type

Integer

参数解释:

评估器的核心执行模式。

约束限制:

int32 格式。

取值范围:

  • 1: 模型评估器(LLM 裁判)

  • 2: 代码评估器(脚本逻辑)

默认取值:

不涉及。

current_version

EvaluationOpsCurrentVersion object

参数解释:

该评估器的初始版本具体配置。

约束限制:

符合 EvaluationOpsCurrentVersion定义。

取值范围:

对象结构。

默认取值:

不涉及。

name

String

参数解释:

评估器的业务名称。

约束限制:

长度 0到10000字符。

取值范围:

中英文及特殊字符。

默认取值:

不涉及。

description

String

参数解释:

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

约束限制:

长度 0到10000字符。

取值范围:

任意字符串。

默认取值:

不涉及。

表4 EvaluationOpsCurrentVersion

参数

是否必选

参数类型

描述

description

String

参数解释:

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

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

evaluator_content

Object

参数解释:

评估器的核心配置JSON内容。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

version

String

参数解释:

评估器的版本标识符。

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

提交新版本成功

请求示例

为指定的评估器发布新版本,更新其 Prompt 模板或模型配置。

POST https://*.com/agentarts/v1/ops/evaluators/7590068991923321858/versions

{
  "evaluator_type" : 1,
  "current_version" : {
    "description" : "description",
    "evaluator_content" : { },
    "version" : "v1.0.0"
  },
  "name" : "正确性评估",
  "description" : "评估提交的内容是否正确、准确、真实,并完整覆盖核心要点。"
}

响应示例

状态码:200

提交新版本成功

{ }

状态码

状态码

描述

200

提交新版本成功

错误码

请参见错误码

相关文档