文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 评估器管理/ 获取评估器单个版本信息 - ShowOpsEvaluatorVersion
更新时间：2026-04-15 GMT+08:00
查看PDF
分享

获取评估器单个版本信息 - ShowOpsEvaluatorVersion

功能介绍

该接口用于通过评估器ID与版本ID获取特定版本的详细快照信息，包括该版本固化的判分逻辑、Prompt 模板、参数权重及生效配置。

调用方法

请参见如何调用API。

URI

GET /v1/ops/evaluators/{evaluator_id}/versions/{version_id}

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

是

String

参数解释：

评估器的唯一标识符（ID）。该参数用于在路径中定位具体的评估逻辑或评估器实例。

约束限制：

长度为0到10000个字符。

取值范围：

不涉及。

默认取值：

不涉及。

version_id

是

String

参数解释：

评估器的具体版本号。用于在同一评估器ID下区分不同的配置版本或逻辑迭代。

约束限制：

长度为0到10000个字符。

取值范围：

符合版本号定义的字符串。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

application/json

Authorization

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Sdk-Date

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

versions

Array of versions objects

参数解释：

评估器的版本列表，包含该评估器下所有已发布的历史版本及配置详情。

取值范围：

不涉及。
表4 versions

参数

参数类型

描述

evaluator_id

String

参数解释：

评估器的唯一标识符。

取值范围：

不涉及。

version

String

参数解释：

评估器的具体版本号，用于区分不同的逻辑迭代。

取值范围：

不涉及。

description

String

参数解释：

该版本的变更详细说明或备注。

取值范围：

不涉及。

base_info

OpsEvaluatorBaseInfo object

参数解释：

评估器的基本属性信息，如名称、所属分类等。

取值范围：

参考OpsEvaluatorBaseInfo定义。

evaluator_content

EvaluatorContent object

参数解释：

评估器的核心业务逻辑、Prompt 模版 or 脚本配置内容。

取值范围：

参考EvaluatorContent定义。
表5 OpsEvaluatorBaseInfo

参数

参数类型

描述

created_at

String

参数解释：

评估器的创建时间。

约束限制：

采用 ISO 8601 标准格式表示。

取值范围：

0到100个字符。

默认取值：

不涉及。

created_by

EvaluationOpsCreatedBy object

参数解释：

创建该评估器的用户信息。

约束限制：

符合 EvaluationOpsCreatedBy定义。

取值范围：

对象结构。

默认取值：

不涉及。

updated_at

String

参数解释：

评估器的最近一次更新时间。

约束限制：

采用 ISO 8601 标准格式表示。

取值范围：

0到100个字符。

默认取值：

不涉及。

updated_by

EvaluationOpsUpdatedBy object

参数解释：

最后一次修改该评估器的用户信息。

约束限制：

符合 EvaluationOpsUpdatedBy定义。

取值范围：

对象结构。

默认取值：

不涉及。
表6 EvaluationOpsCreatedBy

参数

参数类型

描述

user_id

String

参数解释：

资源创建者的唯一标识符。

约束限制：

0到10000字符。

取值范围：

不涉及。

默认取值：

不涉及。

name

String

参数解释：

资源创建者的显示名称。

约束限制：

0到10000字符。

取值范围：

不涉及。

默认取值：

不涉及。

avatar_url

String

参数解释：

创建者的头像链接。

约束限制：

0到10000字符。

取值范围：

不涉及。

默认取值：

不涉及。
表7 EvaluationOpsUpdatedBy

参数

参数类型

描述

user_id

String

参数解释：

最后一次更新资源的用户的ID。

约束限制：

0到10000字符。

取值范围：

不涉及。

默认取值：

不涉及。

name

String

参数解释：

更新者的显示名称。

约束限制：

0到10000字符。

取值范围：

不涉及。

默认取值：

不涉及。

avatar_url

String

参数解释：

更新者的头像链接。

约束限制：

0到10000字符。

取值范围：

不涉及。

默认取值：

不涉及。
表8 EvaluatorContent

参数

参数类型

描述

prompt_evaluator

PromptEvaluator object

参数解释：

提示词评估器配置。

约束限制：

遵循 PromptEvaluator定义。

取值范围：

不涉及。

默认取值：

不涉及。

input_schemas

Array of objects

参数解释：

评估器输入参数的Schema定义列表。

约束限制：

数组元素为符合JSONSchema规范的对象。

取值范围：

不涉及。

默认取值：

空列表。
表9 PromptEvaluator

参数

参数类型

描述

message_list

Array of objects

参数解释：

消息列表，包含评估过程中的对话记录或消息对象。

约束限制：

数组长度为0到10000。

取值范围：

不涉及。

默认取值：

空列表。

model_config

EvaluationOpsModelConfig object

参数解释：

模型配置信息，定义评估时使用的模型参数。

约束限制：

遵循EvaluationOpsModelConfig定义。

取值范围：

不涉及。

默认取值：

不涉及。

prompt_source_type

Integer

参数解释：

提示词（Prompt）的来源类型。

约束限制：

0到10000 之间的整数。

取值范围：

0到10000。

默认取值：

不涉及。

prompt_template_key

String

参数解释：

提示词模板的唯一关键字（Key）。

约束限制：

长度为0到10000个字符。

取值范围：

不涉及。

默认取值：

不涉及。

prompt_template_name

String

参数解释：

提示词模板的显示名称。

约束限制：

长度为0到10000个字符。

取值范围：

不涉及。

默认取值：

不涉及。
表10 EvaluationOpsModelConfig

参数

参数类型

描述

model_id

String

参数解释：

指定调用的大模型唯一标识符。

约束限制：

1-64个字符。

取值范围：

合法的模型ID字符串。

默认取值：

不涉及。

model_name

String

参数解释：

模型的显示名称。

约束限制：

2-100个字符。

取值范围：

任意字符串。

默认取值：

不涉及。

temperature

Float

参数解释：

采样温度参数，用于控制输出的随机性。数值低更聚焦，数值高更具创造性。

约束限制：

浮点数。

取值范围：

0.0到2.0。

默认取值：

0.7。

max_tokens

Integer

参数解释：

单次推理生成的最大Token数量限制。

约束限制：

1-32,000之间的整数。

取值范围：

1-32000。

默认取值：

2000。

top_p

Float

参数解释：

核采样参数。

约束限制：

浮点数。

取值范围：

0.0到1.0。

默认取值：

1.0。

frequency_penalty

Float

参数解释：

频率惩罚系数，降低内容重复倾向。

约束限制：

浮点数。

取值范围：

-2.0到2.0。

默认取值：

0。

请求示例

通过评估器ID和版本ID获取该特定版本的详细配置快照。

GET https://*.com/agentarts/v1/ops/evaluators/7590068991923321858/versions/v-7590068991923321858-20240320

响应示例

状态码：200

获取单个评估器版本信息成功

{
  "versions" : [ {
    "evaluator_id" : "evaluator_id",
    "version" : "v1.2.0",
    "description" : "优化了评估准确率逻辑",
    "base_info" : {
      "created_at" : "2026-04-10T16:58:00Z",
      "created_by" : {
        "user_id" : "user_id",
        "name" : "name",
        "avatar_url" : "avatar_url"
      },
      "updated_at" : "2026-04-10T17:30:00Z",
      "updated_by" : {
        "user_id" : "user_id",
        "name" : "name",
        "avatar_url" : "https://example.com/avatar.png"
      }
    },
    "evaluator_content" : {
      "prompt_evaluator" : {
        "message_list" : [ ],
        "model_config" : {
          "model_id" : "1749615103",
          "model_name" : "豆包·1.6·自动深度思考",
          "temperature" : 0.1,
          "max_tokens" : 4096,
          "top_p" : 0.7,
          "frequency_penalty" : 0
        },
        "prompt_source_type" : 1,
        "prompt_template_key" : "prompt_template_key",
        "prompt_template_name" : "prompt_template_name"
      },
      "input_schemas" : [ { } ]
    }
  } ]
}

状态码

状态码

描述

200

获取单个评估器版本信息成功

错误码

请参见错误码。

父主题： 评估器管理

相关文档