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

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

功能介绍

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

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:evaluator:showOpsEvaluatorVersion

Read

evaluator *

g:ResourceTag/<tag-key>

-

-

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

是

String

参数解释：

评估器的唯一标识符（ID）。可通过调用创建评估器接口获取，或通过查询评估器列表接口获取。该参数用于在路径中定位具体的评估逻辑或评估器实例。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

version_id

是

String

参数解释：

评估器的具体版本号。用于在同一评估器ID下区分不同的配置版本或逻辑迭代。可通过调用获取评估器版本列表接口获取。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

evaluator

OpsListEvaluatorsInfo object

参数解释：

评估器详细信息对象，引用OpsListEvaluatorsInfo定义。
表3 OpsListEvaluatorsInfo

参数

参数类型

描述

base_info

OpsEvaluatorBaseInfo object

参数解释：

评估器的基础审计信息，引用OpsEvaluatorBaseInfo对象。

evaluator_id

String

参数解释：

评估器的唯一标识符。

取值范围：

不涉及。

account_id

String

参数解释：

评估器所属的租户账号ID。

取值范围：

不涉及。

name

String

参数解释：

评估器的名称，用于界面展示和检索。

取值范围：

不涉及。

description

String

参数解释：

评估器的功能描述或业务用途说明。

取值范围：

不涉及。

evaluator_type

Integer

参数解释：

评估器的类型编码，用于区分不同的逻辑实现（如自定义评估器或系统评估器）。

取值范围：

  • 1：模型评估器

  • 2：代码评估器

  • 3：自适应评估器（自适应评估模式，可根据上下文与历史结果动态调整评判规则）

turn_type

String

参数解释：

评估器的对话轮次类型。

取值范围：

  • single：单轮

  • multi：多轮

latest_version

String

参数解释：

评估器的最新发布的版本号。

取值范围：

不涉及。

current_version

EvaluationOpsCurrentVersion object

参数解释：

评估器当前生效的版本信息，引用EvaluationOpsCurrentVersion定义。

current_version_id

String

参数解释：

评估器当前生效版本的唯一标识符。

取值范围：

不涉及。

reference_count

Long

参数解释：

该评估器被评估任务引用的次数。

取值范围：

非负整数。

tags

Array of OpsTmsTag objects

参数解释：

评估器绑定的TMS标签列表。数组元素引用OpsTmsTag对象。

取值范围：

不涉及。
表4 OpsEvaluatorBaseInfo

参数

参数类型

描述

created_at

String

参数解释：

评估器的创建时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。

取值范围：

不涉及。

created_by

EvaluationOpsCreatedBy object

参数解释：

评估器的创建者信息，引用EvaluationOpsCreatedBy对象。

updated_at

String

参数解释：

评估器的最近一次更新时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。

取值范围：

不涉及。

updated_by

EvaluationOpsUpdatedBy object

参数解释：

评估器的最近一次更新者信息，引用EvaluationOpsUpdatedBy对象。
表5 EvaluationOpsCreatedBy

参数

参数类型

描述

user_id

String

参数解释：

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

取值范围：

不涉及。

name

String

参数解释：

资源创建者的显示名称。

取值范围：

不涉及。

avatar_url

String

参数解释：

创建者的头像链接。

取值范围：

不涉及。
表6 EvaluationOpsUpdatedBy

参数

参数类型

描述

user_id

String

参数解释：

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

取值范围：

不涉及。

name

String

参数解释：

更新者的显示名称。

取值范围：

不涉及。

avatar_url

String

参数解释：

更新者的头像链接。

取值范围：

不涉及。
表7 EvaluationOpsCurrentVersion

参数

参数类型

描述

description

String

参数解释：

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

取值范围：

不涉及。

evaluator_content

Object

参数解释：

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

取值范围：

不涉及。

version

String

参数解释：

评估器的版本标识符。

取值范围：

符合语义化版本格式的字符串，如"v1.0.0"。
表8 OpsTmsTag

参数

参数类型

描述

key

String

参数解释：

标签键名称。

取值范围：

不涉及。

value

String

参数解释：

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

取值范围：

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

请求示例

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

GET https://api.example.com/v1/ops/evaluators/7590068991923321858/versions/v-7590068991923321858-20240320

响应示例

状态码：200

{
  "evaluator" : {
    "evaluator_id" : "a3d1c9e7-6b2f-4850-9e4a-1f8d7c3b5a26",
    "account_id" : "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "name" : "正确性评估",
    "description" : "优化了评估准确率逻辑",
    "evaluator_type" : 1,
    "base_info" : {
      "created_at" : "2026-04-10T16:58:00Z",
      "created_by" : {
        "user_id" : "user_id",
        "name" : "name"
      },
      "updated_at" : "2026-04-10T17:30:00Z",
      "updated_by" : {
        "user_id" : "user_id",
        "name" : "name"
      }
    },
    "current_version" : {
      "version_id" : "version_id",
      "account_id" : "account_id",
      "evaluator_id" : "evaluator_id",
      "version" : "v1.2.0",
      "turn_type" : "single",
      "evaluator_type" : 1,
      "evaluator_content_type" : "text",
      "description" : "优化了评估准确率逻辑",
      "version_description" : "",
      "evaluator_content" : {
        "input_schemas" : [ {
          "key" : "input",
          "support_content_types" : [ "text" ]
        } ],
        "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
          }
        }
      },
      "base_info" : {
        "created_at" : "2026-04-10T16:58:00Z",
        "created_by" : {
          "user_id" : "user_id",
          "name" : "name"
        },
        "updated_at" : "2026-04-10T17:30:00Z",
        "updated_by" : {
          "user_id" : "user_id",
          "name" : "name"
        }
      },
      "reference_count" : 0
    }
  }
}

状态码

状态码

描述

200

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

错误码

请参见错误码。

父主题： 评估器管理

相关文档