获取评估器信息 - ShowOpsEvaluator
功能介绍
该接口用于通过指定的评估器ID检索其完整定义信息,包括判分逻辑、参数配置、关联模型及元数据详情,是核对特定评测标准执行细节的核心入口。
URI
GET /v1/ops/evaluators/{evaluator_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
evaluator_id |
是 |
String |
参数解释: 评估器的唯一标识符(ID)。该参数在路径中指定,用于精确定位需要操作或查询的特定评估器资源。 约束限制: 长度为 1到100个字符。 取值范围: 符合评估器ID命名规范的字符串。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
evaluator_id |
String |
参数解释 评估器的唯一标识符ID。 取值范围 符合通用唯一识别码(UUID)标准的字符串。 |
|
name |
String |
参数解释 评估器的显示名称。 取值范围 支持中英文、数字及常用特殊符号。 |
|
description |
String |
参数解释 对评估器功能、逻辑或评测维度的详细描述。 取值范围 任意字符串。 |
|
evaluator_type |
Integer |
参数解释 评估器的分类类型编码。 取值范围 对应的整型编码。 |
|
box_type |
String |
参数解释 评估器的可见性类型(盒子类型),决定了评估逻辑的透明度。 取值范围 |
|
builtin |
Boolean |
参数解释 标识该评估器是否为系统内置预置。 取值范围 |
|
latest_version |
String |
参数解释 该评估器下最新发布的版本号。 取值范围 符合语义化版本格式的字符串(如 0.0.2)。 |
|
current_version |
EvaluationOpsCurrentVersion object |
参数解释 评估器当前生效版本的详细配置信息。 取值范围 对象。 |
|
base_info |
OpsEvaluatorBaseInfo object |
参数解释 评估器的基础审计及元数据(如创建时间、更新者等)。 取值范围 对象。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
description |
String |
参数解释: 当前版本的详细描述信息。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
evaluator_content |
Object |
参数解释: 评估器的核心配置JSON内容。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
version |
String |
参数解释: 评估器的版本标识符。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_at |
String |
参数解释: 评估器的创建时间。 约束限制: 采用 ISO 8601 标准格式表示。 取值范围: 0到100个字符。 默认取值: 不涉及。 |
|
created_by |
EvaluationOpsCreatedBy object |
参数解释: 创建该评估器的用户信息。 约束限制: 符合 EvaluationOpsCreatedBy定义。 取值范围: 对象结构。 默认取值: 不涉及。 |
|
updated_at |
String |
参数解释: 评估器的最近一次更新时间。 约束限制: 采用 ISO 8601 标准格式表示。 取值范围: 0到100个字符。 默认取值: 不涉及。 |
|
updated_by |
EvaluationOpsUpdatedBy object |
参数解释: 最后一次修改该评估器的用户信息。 约束限制: 符合 EvaluationOpsUpdatedBy定义。 取值范围: 对象结构。 默认取值: 不涉及。 |
请求示例
通过评估器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 |
查询成功 |
错误码
请参见错误码。