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

获取评估器信息列表 - ListOpsEvaluators

功能介绍

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

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 strings

参数解释:

具体的过滤条件列表。每个元素为一个JSON格式的字符串。

约束限制:

数组长度为0到10000。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

获取评估器列表信息成功

请求示例

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

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

{
  "builtin" : false,
  "filter_option" : {
    "filters" : {
      "logic_op" : "And",
      "filter_conditions" : [ "string" ]
    }
  },
  "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
  }
}

状态码

状态码

描述

200

获取评估器列表信息成功

错误码

请参见错误码

相关文档