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

获取评估器信息 - ShowOpsEvaluator

功能介绍

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

URI

GET /v1/ops/evaluators/{evaluator_id}

表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对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

evaluator_id

String

参数解释

评估器的唯一标识符ID。

取值范围

符合通用唯一识别码(UUID)标准的字符串。

name

String

参数解释

评估器的显示名称。

取值范围

支持中英文、数字及常用特殊符号。

description

String

参数解释

对评估器功能、逻辑或评测维度的详细描述。

取值范围

任意字符串。

evaluator_type

Integer

参数解释

评估器的分类类型编码。

取值范围

对应的整型编码。

box_type

String

参数解释

评估器的可见性类型(盒子类型),决定了评估逻辑的透明度。

取值范围

  • White: 白盒评估。

  • Black: 黑盒评估。

builtin

Boolean

参数解释

标识该评估器是否为系统内置预置。

取值范围

  • true: 系统内置。

  • false: 用户自定义。

latest_version

String

参数解释

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

取值范围

符合语义化版本格式的字符串(如 0.0.2)。

current_version

EvaluationOpsCurrentVersion object

参数解释

评估器当前生效版本的详细配置信息。

取值范围

对象。

base_info

OpsEvaluatorBaseInfo object

参数解释

评估器的基础审计及元数据(如创建时间、更新者等)。

取值范围

对象。

表4 EvaluationOpsCurrentVersion

参数

参数类型

描述

description

String

参数解释:

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

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

evaluator_content

Object

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

version

String

参数解释:

评估器的版本标识符。

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

表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字符。

取值范围:

不涉及。

默认取值:

不涉及。

请求示例

通过评估器ID精确查询其配置详情、版本信息及判定逻辑。

GET https://*.com/agentarts/v1/ops/evaluators/7590068991923321858



响应示例

状态码:200

查询成功

{
  "evaluator_id" : "7590068372975734018",
  "name" : "正确性评估",
  "description" : "评估提交的内容是否正确、准确、真实,并完整覆盖核心要点。",
  "evaluator_type" : 1,
  "box_type" : "White",
  "builtin" : false,
  "latest_version" : "0.0.2",
  "current_version" : {
    "description" : "description",
    "evaluator_content" : { },
    "version" : "v1.0.0"
  },
  "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"
    }
  }
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档