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

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

功能介绍

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

调用方法

请参见如何调用api

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluator:listopsevaluators

list

evaluator *

g:resourcetag/

-

-

uri

post /v1/ops/evaluators/list

请求参数

表1 请求body参数

参数

是否必选

参数类型

描述

builtin

boolean

参数解释:

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

约束限制:

布尔值。

取值范围:

  • true: 仅查询预置评估器

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

默认取值:

无(查询全部)。

filter_option

evaluationopsfilteroption object

参数解释:

评估操作的过滤选项包装对象。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

page_size

integer

参数解释:

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

约束限制:

0到10000。

取值范围:

0到10000之间的整数。

默认取值:

10。

page_number

integer

参数解释:

分页查询的当前页码。

约束限制:

0到10000。

取值范围:

0到10000 之间的整数。

默认取值:

1。

表2 evaluationopsfilteroption

参数

是否必选

参数类型

描述

filters

evaluationopsfilters object

参数解释:

评估操作的过滤条件对象。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 evaluationopsfilters

参数

是否必选

参数类型

描述

logic_op

string

参数解释:

过滤条件的逻辑运算符。and表示全显,or表示任一。

约束限制:

0到10000字符。

取值范围:

and, or。

默认取值:

不涉及。

filter_conditions

array of objects

参数解释:

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

约束限制:

数组长度为0到10000。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

获取评估器列表信息成功

请求示例

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

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
}

响应示例

状态码: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
    } ],
    "total" : 22,
    "page_number" : 1,
    "page_size" : 100,
    "total_pages" : 1
  }
}

状态码

状态码

描述

200

获取评估器列表信息成功

错误码

请参见错误码

相关文档

网站地图