文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估器管理/ 获取评估器信息列表 - ListOpsEvaluators
更新时间:2026-09-24 GMT+08:00
分享

获取评估器信息列表 - ListOpsEvaluators

功能介绍

该接口用于分页查询当前租户下所有已注册的评估器信息,支持按名称、类型或创建时间进行过滤评估器。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluator:listOpsEvaluators

List

evaluator *

g:ResourceTag/<tag-key>

-

-

URI

POST /v1/ops/evaluators/list

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

builtin

否

Boolean

参数解释:

是否为系统预置评估器的过滤开关。

约束限制:

不涉及。

取值范围:

  • true: 仅查询预置评估器

  • false: 仅查询用户自定义评估器

默认取值:

无(查询全部)。

filter_option

否

EvaluationOpsFilterOption object

参数解释:

过滤条件配置对象,引用EvaluationOpsFilterOption对象。

约束限制:

不涉及。

page_size

否

Integer

参数解释:

分页查询时每页返回的记录数量。

约束限制:

与page_number配合使用实现分页查询。

取值范围:

0到10000之间的整数。

默认取值:

10。

page_number

否

Integer

参数解释:

分页查询的当前页码。

约束限制:

与page_size配合使用实现分页查询。

取值范围:

0到10000之间的整数。

默认取值:

1。

tag_key_exists

否

Array of strings

参数解释:

需要匹配的包含该标签名称的资源。数组元素为字符串类型,每个元素最大长度128。

约束限制:

数组元素最小数量为0,最大数量为10,每个元素最大长度为128个字符。

取值范围:

不涉及。

默认取值:

不涉及。

tag_key_matches

否

Array of strings

参数解释:

需要匹配的包含该标签的资源,需要和tag_value_matches条件配合使用。数组元素为字符串类型,每个元素最大长度128。

约束限制:

tag_key_matches和tag_value_matches按索引位置配对。数组元素最小数量为0,最大数量为10,每个元素最大长度为128个字符。

取值范围:

不涉及。

默认取值:

不涉及。

tag_value_matches

否

Array of strings

参数解释:

需要匹配的包含该标签值的资源,需要和tag_key_matches条件配合使用。数组元素为字符串类型,每个元素最大长度255。

约束限制:

tag_key_matches和tag_value_matches按索引位置配对。数组元素最小数量为0,最大数量为10,每个元素最大长度为255个字符。

取值范围:

不涉及。

默认取值:

不涉及。

tag_match_policy

否

String

参数解释:

标签匹配模式,仅针对tag_key_exists、tag_key_matches、tag_value_matches参数生效。

约束限制:

不涉及。

取值范围:

  • ALL:所有标签都必须匹配

  • ANY:任意一个标签匹配即可

默认取值:

ALL。

表2 EvaluationOpsFilterOption

参数

是否必选

参数类型

描述

filters

否

EvaluationOpsFilters object

参数解释:

过滤条件对象,引用EvaluationOpsFilters对象。

约束限制:

不涉及。

表3 EvaluationOpsFilters

参数

是否必选

参数类型

描述

logic_op

否

String

参数解释:

过滤条件的逻辑运算符。

约束限制:

不涉及。

取值范围:

  • And:所有条件都需满足

  • Or:满足任一条件即可

默认取值:

不涉及。

filter_conditions

否

Array of objects

参数解释:

具体的过滤条件列表,数组元素为Object类型的过滤条件对象。

约束限制:

数组元素最小数量为0,最大数量为10000。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

evaluators

Array of OpsListEvaluatorsInfo objects

参数解释:

包含评估器元数据、配置信息及状态的详细信息列表。数组元素引用OpsListEvaluatorsInfo对象。

取值范围:

不涉及。

total

Integer

参数解释:

符合当前过滤条件的评估器总记录数,常用于分页。

取值范围:

非负整数。

page_number

Integer

参数解释:

当前页码。

取值范围:

正整数。

page_size

Integer

参数解释:

每页返回的记录条数。

取值范围:

1~100。

total_pages

Long

参数解释:

总页数。

取值范围:

非负整数。

表5 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对象。

取值范围:

不涉及。

表6 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对象。

表7 EvaluationOpsCreatedBy

参数

参数类型

描述

user_id

String

参数解释:

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

取值范围:

不涉及。

name

String

参数解释:

资源创建者的显示名称。

取值范围:

不涉及。

avatar_url

String

参数解释:

创建者的头像链接。

取值范围:

不涉及。

表8 EvaluationOpsUpdatedBy

参数

参数类型

描述

user_id

String

参数解释:

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

取值范围:

不涉及。

name

String

参数解释:

更新者的显示名称。

取值范围:

不涉及。

avatar_url

String

参数解释:

更新者的头像链接。

取值范围:

不涉及。

表9 EvaluationOpsCurrentVersion

参数

参数类型

描述

description

String

参数解释:

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

取值范围:

不涉及。

evaluator_content

Object

参数解释:

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

取值范围:

不涉及。

version

String

参数解释:

评估器的版本标识符。

取值范围:

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

表10 OpsTmsTag

参数

参数类型

描述

key

String

参数解释:

标签键名称。

取值范围:

不涉及。

value

String

参数解释:

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

取值范围:

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

请求示例

查询当前租户下所有已注册的评估器信息

POST https://api.example.com/v1/ops/evaluators/list

{
  "builtin" : false,
  "filter_option" : {
    "filters" : {
      "logic_op" : "And",
      "filter_conditions" : [ { } ]
    }
  },
  "page_size" : 12,
  "page_number" : 1,
  "tag_key_exists" : [ "env" ],
  "tag_key_matches" : [ "team" ],
  "tag_value_matches" : [ "ai-platform" ],
  "tag_match_policy" : "ALL"
}

响应示例

状态码:200

{
  "evaluators" : [ {
    "evaluator_id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
    "name" : "正确性评估",
    "description" : "评估提交的内容是否正确、准确、真实,并完整覆盖核心要点。",
    "evaluator_type" : 1,
    "box_type" : "White",
    "builtin" : false,
    "latest_version" : "0.0.1",
    "draft_submitted" : true,
    "base_info" : {
      "created_at" : "2026-04-13T17:34:08.696Z",
      "created_by" : {
        "name" : "ARM301_Versatile_z30038842_01",
        "user_id" : "6f80301edacc43728bf47b6a6484d512"
      },
      "updated_at" : "2026-04-13T17:34:08.696Z",
      "updated_by" : {
        "name" : "ARM301_Versatile_z30038842_01",
        "user_id" : "6f80301edacc43728bf47b6a6484d512"
      }
    },
    "current_version" : {
      "id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
      "version" : "0.0.1",
      "description" : "正确性评估器初始版本",
      "evaluator_content" : "",
      "base_info" : {
        "created_at" : "2026-04-13T17:34:08.696Z",
        "created_by" : {
          "name" : "ARM301_Versatile_z30038842_01",
          "user_id" : "6f80301edacc43728bf47b6a6484d512"
        },
        "updated_at" : "2026-04-13T17:34:08.696Z",
        "updated_by" : {
          "name" : "ARM301_Versatile_z30038842_01",
          "user_id" : "6f80301edacc43728bf47b6a6484d512"
        }
      }
    },
    "tags" : [ {
      "key" : "env",
      "value" : "prod"
    }, {
      "key" : "team",
      "value" : "ai-platform"
    } ]
  } ],
  "total" : 22
}

状态码

状态码

描述

200

获取评估器列表信息成功

错误码

请参见错误码。

相关文档