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

获取评估器信息 - ShowOpsEvaluator

功能介绍

该接口用于通过指定的评估器ID检索其完整定义信息，包括判分逻辑、参数配置、关联模型及元数据详情，是核对特定评测标准执行细节的核心入口。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:evaluator:showOpsEvaluator

Read

evaluator *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/ops/evaluators/{evaluator_id}

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

是

String

参数解释：

评估器的唯一标识符（ID）。可通过调用创建评估器接口获取，或通过查询评估器列表接口获取。该参数在路径中指定，用于精确定位需要操作或查询的特定评估器资源。

约束限制：

不涉及。

取值范围：

由字母、数字和连字符（-）组成的字符串，长度为1~100个字符。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：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精确查询其配置详情、版本信息及判定逻辑。

GET https://api.example.com/v1/ops/evaluators/7590068991923321858

响应示例

状态码：200

{
  "evaluator" : {
    "evaluator_id" : "ade111ca-843f-4e20-a9a4-01a9aa22a3f9",
    "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
    "name" : "正确性评估",
    "description" : "评估提交的内容是否正确、准确、真实，并完整覆盖核心要点。",
    "evaluator_type" : 1,
    "turn_type" : "single",
    "evaluator_content_type" : "text",
    "current_version_id" : "1.0.0",
    "latest_version" : "0.0.2",
    "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" : "1.0.0",
      "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
      "evaluator_id" : "ade111ca-843f-4e20-a9a4-01a9aa22a3f9",
      "version" : "1.0.0",
      "turn_type" : "single",
      "evaluator_type" : 1,
      "evaluator_content_type" : "text",
      "description" : "正确性评估器初始版本",
      "version_description" : "",
      "evaluator_content" : { },
      "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,
    "tags" : [ {
      "key" : "env",
      "value" : "prod"
    }, {
      "key" : "team",
      "value" : "ai-platform"
    } ]
  }
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

父主题： 评估器管理

相关文档