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

获取评估器模板列表 - ListOpsEvaluatorTemplates

功能介绍

该接口用于获取系统中的所有评估器模板信息列表,支持分页查询和条件筛选,适用于需要查看和管理评估器模板的场景。

URI

POST /v1/ops/evaluator-templates/list

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

filter_option

Object

参数解释:

用于设置获取评估器模板时的过滤条件,可以基于多个条件进行筛选。

约束限制:

过滤条件对象内包含逻辑操作和具体的条件列表。

取值范围:

  • 过滤条件数量不涉及最小数量限制,最大为10000。

  • 逻辑操作(logic_op)长度不涉及最小值,最大长度为100。示例值为And。

  • tag_key长度不涉及最小值,最大长度为100。示例值为Category。

  • 操作(operator)长度不涉及最小值,最大长度为100。示例值为In。

  • 值(value)长度不涉及最小值,最大长度为100。示例值为LLM。

默认取值:

不涉及。

page_size

Integer

参数解释:

指定每次请求返回的评估器模板数量,用于控制每次分页返回的数据量。

约束限制:

必须为0到10,000 之间的整数。

取值范围:

类型为整数,取值范围为0-10000的整数。

默认取值:

不涉及。

page_number

Integer

参数解释:

指定获取的页码,用于控制数据分页的页数定位。

约束限制:

必须为0到10,000之间的整数。

取值范围:

类型为整数,取值范围为0-10000的整数。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

evaluator_templates

Array of evaluator_templates objects

参数解释:

评估器模版列表包含获取到的所有符合条件的评估器模板数据,用于展示和选择。

取值范围:

评估器模版对象数组。

total

Long

参数解释:

符合条件的模板总数。

取值范围:

0到2,147,483,647。

code

Integer

参数解释:

API执行状态码。

取值范围:

32位整数。

msg

String

参数解释:

响应状态描述信息。

取值范围:

不涉及。

表4 evaluator_templates

参数

参数类型

描述

evaluator_type

Integer

参数解释:

评估器类型标识。

取值范围:

0到2,147,483,647。

template_id

String

参数解释:

评估器模板的唯一ID。

取值范围:

由系统生成的数字字符串。

popularity

String

参数解释:

流行度表示评估器在用户中的受欢迎程度和使用频率。

取值范围:

数字形式的字符串。

base_info

OpsEvaluatorBaseInfo object

参数解释:

评估器基本信息包含评估器的核心属性和基础配置。

取值范围:

参考OpsEvaluatorBaseInfo定义。

description

String

参数解释:

评估器描述用于说明评估器的功能、用途和使用场景。

取值范围:

描述性文本。

evaluator_info

evaluator_info object

参数解释:

评估器的元数据信息,如供应商和手册链接。

取值范围:

不涉及。

evaluator_content

evaluator_content object

参数解释:

评估器具体实现逻辑,包括输入输出格式、提示词和模型配置。

取值范围:

不涉及。

name

String

参数解释:

评估器显示名称。

取值范围:

不涉及。

tags

tags object

参数解释:

评估器分类标签。

取值范围:

不涉及。

表5 OpsEvaluatorBaseInfo

参数

参数类型

描述

created_at

String

参数解释:

评估器的创建时间。

约束限制:

采用 ISO 8601 标准格式表示。

取值范围:

0到100个字符。

默认取值:

不涉及。

created_by

EvaluationOpsCreatedBy object

参数解释:

创建该评估器的用户信息。

约束限制:

符合 EvaluationOpsCreatedBy定义。

取值范围:

对象结构。

默认取值:

不涉及。

updated_at

String

参数解释:

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

约束限制:

采用 ISO 8601 标准格式表示。

取值范围:

0到100个字符。

默认取值:

不涉及。

updated_by

EvaluationOpsUpdatedBy object

参数解释:

最后一次修改该评估器的用户信息。

约束限制:

符合 EvaluationOpsUpdatedBy定义。

取值范围:

对象结构。

默认取值:

不涉及。

表6 EvaluationOpsCreatedBy

参数

参数类型

描述

user_id

String

参数解释:

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

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

name

String

参数解释:

资源创建者的显示名称。

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

avatar_url

String

参数解释:

创建者的头像链接。

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

表7 EvaluationOpsUpdatedBy

参数

参数类型

描述

user_id

String

参数解释:

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

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

name

String

参数解释:

更新者的显示名称。

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

avatar_url

String

参数解释:

更新者的头像链接。

约束限制:

0到10000字符。

取值范围:

不涉及。

默认取值:

不涉及。

表8 evaluator_info

参数

参数类型

描述

benchmark

String

参数解释:

评估器的基准测试标准或参考系。

取值范围:

不涉及。

user_manual_url

String

参数解释:

用户手册网址。

取值范围:

不涉及。

vendor

String

参数解释:

评估器的提供方或开发机构。

取值范围:

供应商名称。

vendor_url

String

参数解释:

供应商官方资源链接。

取值范围:

不涉及。

表9 evaluator_content

参数

参数类型

描述

input_schemas

Array of input_schemas objects

参数解释:

输入参数定义评估器接收的数据格式。

取值范围:

包含json_schema、key等的对象。

output_schemas

Array of output_schemas objects

参数解释:

输出参数定义。

取值范围:

不涉及。

prompt_evaluator

prompt_evaluator object

参数解释:

包含评估过程中使用的提示词内容和模型配置。

取值范围:

不涉及。

receive_chat_history

Boolean

参数解释:

是否接收聊天记录上下文。

取值范围:

true: 接收, false: 不接收。

表10 input_schemas

参数

参数类型

描述

json_schema

String

参数解释:

JSON格式的入参描述。

取值范围:

不涉及。

key

String

参数解释:

参数标识关键字。

取值范围:

不涉及。

support_content_types

Array of strings

参数解释:

支持的内容格式类型。

取值范围:

如 Text 等。

表11 output_schemas

参数

参数类型

描述

json_schema

String

参数解释:

JSON格式的出参描述。

取值范围:

不涉及。

key

String

参数解释:

输出关键字。

取值范围:

不涉及。

表12 prompt_evaluator

参数

参数类型

描述

message_list

Array of message_list objects

参数解释:

提示词信息列表。

取值范围:

不涉及。

model_config

model_config object

参数解释:

模型推理配置。

取值范围:

不涉及。

表13 message_list

参数

参数类型

描述

role

Integer

参数解释:

消息角色。

取值范围:

1: System, 2: User 等。

content

content object

参数解释:

消息的具体内容对象。

取值范围:

不涉及。

表14 content

参数

参数类型

描述

text

String

参数解释:

提示词文本内容。

取值范围:

不涉及。

表15 model_config

参数

参数类型

描述

model_id

String

参数解释:

模型唯一标识。

取值范围:

不涉及。

temperature

Float

参数解释:

模型采样温度。

取值范围:

通常0.0到2.0。

表16 tags

参数

参数类型

描述

zh-CN

zh-CN object

参数解释:

中文标签分类信息。

取值范围:

不涉及。

表17 zh-CN

参数

参数类型

描述

BusinessScenario

Array of strings

参数解释:

业务场景标签。

取值范围:

如 AIGC。

Category

Array of strings

参数解释:

功能类别标签。

取值范围:

如 LLM。

请求示例

分页查询 Category 标签为 "LLM" 的评估器模板。

POST https://*.com/agentarts/v1/ops/evaluator-templates/list

{
  "filter_option" : {
    "filters" : {
      "logic_op" : "And",
      "filter_conditions" : [ {
        "tag_key" : "Category",
        "operator" : "In",
        "value" : "LLM"
      } ]
    }
  },
  "page_size" : 20,
  "page_number" : 1
}

响应示例

状态码:200

获取评估器模板信息列表成功

{
  "evaluator_templates" : [ {
    "evaluator_type" : 1,
    "template_id" : "7569212233054421003",
    "popularity" : "721",
    "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"
      }
    },
    "description" : "输出是否引用了文本中的真实引用",
    "evaluator_info" : {
      "benchmark" : "",
      "user_manual_url" : "",
      "vendor" : "CozeLoop",
      "vendor_url" : ""
    },
    "evaluator_content" : {
      "input_schemas" : [ {
        "json_schema" : "{\"type\": \"string\"}",
        "key" : "input",
        "support_content_types" : [ "Text" ]
      } ],
      "output_schemas" : [ {
        "json_schema" : "{\"type\": \"number\"}",
        "key" : "score"
      } ],
      "prompt_evaluator" : {
        "message_list" : [ {
          "role" : 0,
          "content" : {
            "text" : "string"
          }
        } ],
        "model_config" : {
          "model_id" : "1749615103",
          "temperature" : 0.1
        }
      },
      "receive_chat_history" : false
    },
    "name" : "相关性",
    "tags" : {
      "zh-CN" : {
        "BusinessScenario" : [ "string" ],
        "Category" : [ "string" ]
      }
    }
  } ],
  "total" : 30,
  "code" : 0,
  "msg" : ""
}

状态码

状态码

描述

200

获取评估器模板信息列表成功

错误码

请参见错误码

相关文档