j9九游会登录/ 智果(agentarts)智能体平台/ api参考/ api/ / / 获取评估器信息 - showopsevaluator
更新时间:2026-07-17 gmt 08:00

获取评估器信息 -j9九游会登录

功能介绍

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

调用方法

请参见如何调用api

授权信息

账号根用户具备所有api的调用权限,如果使用账号下的iam用户调用当前api,该iam用户需具备如下身份策略权限,更多的权限说明请参见。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluator:showopsevaluator

read

evaluator *

g:resourcetag/

-

-

uri

get /v1/ops/evaluators/{evaluator_id}

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

string

参数解释:

评估器的唯一标识符(id)。该参数在路径中指定,用于精确定位需要操作或查询的特定评估器资源。

约束限制:

长度为 1到100个字符。

取值范围:

符合评估器id命名规范的字符串。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应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

参数解释:

评估器的基础审计信息,记录创建与更新详情。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 evaluationopscurrentversion

参数

参数类型

描述

description

string

参数解释:

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

约束限制:

长度为0到10000个字符。

取值范围:

不涉及。

默认取值:

不涉及。

evaluator_content

object

参数解释:

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

约束限制:

符合评估器配置json结构定义。

取值范围:

不涉及。

默认取值:

不涉及。

version

string

参数解释:

评估器的版本标识符。

约束限制:

0到10000字符。

取值范围:

符合语义化版本格式的字符串,如"v1.0.0"。

默认取值:

不涉及。

表4 opsevaluatorbaseinfo

参数

参数类型

描述

created_at

string

参数解释:

评估器的创建时间。

created_by

evaluationopscreatedby object

参数解释:

记录评估资产创建者详情。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

updated_at

string

参数解释:

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

updated_by

evaluationopsupdatedby object

参数解释:

记录评估资产最近一次变更操作者信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表5 evaluationopscreatedby

参数

参数类型

描述

user_id

string

参数解释:

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

name

string

参数解释:

资源创建者的显示名称。

avatar_url

string

参数解释:

创建者的头像链接。

表6 evaluationopsupdatedby

参数

参数类型

描述

user_id

string

参数解释:

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

name

string

参数解释:

更新者的显示名称。

avatar_url

string

参数解释:

更新者的头像链接。

请求示例

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

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

响应示例

状态码:200

查询成功

{
  "evaluator_id" : "ade111ca-843f-4e20-a9a4-01a9aa22a3f9",
  "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

查询成功

错误码

请参见错误码

相关文档

网站地图