获取评估器信息列表 - ListOpsEvaluators

功能介绍

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

调用方法

授权信息

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
agentarts:evaluator:listOpsEvaluators	List	evaluator *	g:ResourceTag/<tag-key>	-	-

URI

POST /v1/ops/evaluators/list

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	参数解释：消息体编码格式。用于告知服务端请求体（Body）所采用的主体数据类型，以便服务端正确解析。约束限制：不涉及取值范围：不涉及默认取值： application/json
Authorization	是	String	参数解释：签名认证信息，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。约束限制：不涉及取值范围：不涉及默认取值：不涉及
X-Sdk-Date	是	String	参数解释：请求发送的时间，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表2 请求Body参数
参数	是否必选	参数类型	描述
builtin	否	Boolean	参数解释：是否为系统预置评估器的过滤开关。约束限制：布尔值。取值范围： true: 仅查询预置评估器 false: 仅查询用户自定义评估器默认取值：无（查询全部）。
filter_option	否	EvaluationOpsFilterOption object	参数解释：评估器的详细过滤条件（如名称、标签等）。约束限制：符合 EvaluationOpsFilterOption定义。取值范围：对象结构。默认取值：不涉及。
page_size	否	Integer	参数解释：分页查询时每页返回的记录数量。约束限制： 0到10000。取值范围： 0到10000之间的整数。默认取值： 10。
page_number	否	Integer	参数解释：分页查询的当前页码。约束限制： 0到10000。取值范围： 0到10000 之间的整数。默认取值： 1。

表3 EvaluationOpsFilterOption
参数	是否必选	参数类型	描述
filters	否	EvaluationOpsFilters object	参数解释：评估器的过滤详细配置，支持包含和模糊查询。约束限制：不涉及。取值范围：参考EvaluationOpsFilters定义。默认取值：不涉及。

表4 EvaluationOpsFilters
参数	是否必选	参数类型	描述
logic_op	否	String	参数解释：过滤条件的逻辑运算符。And表示全显，Or表示任一。约束限制： 0到10000字符。取值范围： And, Or。默认取值：不涉及。
filter_conditions	否	Array of objects	参数解释：具体的过滤条件列表。每个元素为一个JSON格式的字符串。约束限制：数组长度为0到10000。取值范围：不涉及。默认取值：不涉及。

响应参数

状态码：200

获取评估器列表信息成功

无

请求示例

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

POST https://*.com/agentarts/v1/ops/evaluators/list

{
  "builtin" : false,
  "filter_option" : {
    "filters" : {
      "logic_op" : "And",
      "filter_conditions" : [ { } ]
    }
  },
  "page_size" : 12,
  "page_number" : 1
}

响应示例

状态码：200

获取评估器列表信息成功

{
  "body" : {
    "evaluators" : [ {
      "base_info" : {
        "created_at" : "2026-04-13T17:34:08.696Z",
        "created_by" : {
          "name" : "ARM301_Versatile_z30038842_01",
          "account_id" : "6c23f0482474776dc"
        },
        "updated_at" : "2026-04-13T17:34:08.696Z",
        "updated_by" : {
          "name" : "ARM301_Versatile_z30038842_01",
          "account_id" : "6c2474176dc"
        }
      },
      "evaluator_type" : 1,
      "turn_type" : "single",
      "latest_version" : "0.0.1",
      "evaluator_id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
      "account_id" : "6c2347447776dc",
      "current_version" : {
        "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
        "evaluator_id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
        "version" : "0.0.1",
        "description" : "test1776101648491bmUF",
        "version_description" : "",
        "base_info" : {
          "created_at" : "2026-04-13T17:34:08.696Z",
          "created_by" : {
            "name" : "ARM301_Versatile_z30038842_01",
            "account_id" : "6c23f048232242564277b176dc"
          },
          "updated_at" : "2026-04-13T17:34:08.696Z",
          "updated_by" : {
            "name" : "ARM301_Versatile_z30038842_01",
            "account_id" : "6c6454bhh2dab176dc"
          }
        },
        "evaluator_content" : {
          "input_schemas" : [ {
            "key" : "input",
            "support_content_types" : [ "Text" ]
          }, {
            "key" : "actual_output",
            "support_content_types" : [ "Text" ]
          } ],
          "prompt_evaluator" : {
            "message_list" : [ {
              "content" : {
                "content_type" : "Text",
                "format" : 1,
                "text" : "# Role\n你是一位极其“挑剔”的文字编辑与信息效率审计专家。"
              },
              "role" : 1
            } ],
            "model_config" : {
              "frequency_penalty" : 0,
              "max_tokens" : 3000,
              "model_id" : "deepseek-v3.2",
              "model_name" : "deepseek-v3.2",
              "temperature" : 0.1,
              "top_p" : 0.3
            }
          }
        },
        "reference_count" : 0
      },
      "current_version_id" : "",
      "description" : "test1776101648491bmUF",
      "name" : "test1776101648491bmUF",
      "reference_count" : 0,
      "tags" : null,
      "tms_tags" : null
    } ],
    "total" : 22,
    "page_number" : 1,
    "page_size" : 100,
    "total_pages" : 1
  }
}