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

获取评估器模板列表 -j9九游会登录

功能介绍

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

调用方法

请参见如何调用api

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::listopsevaluatortemplates

list

-

-

-

-

uri

post /v1/ops/evaluator-templates/list

请求参数

表1 请求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

表2 响应body参数

参数

参数类型

描述

evaluator_templates

array of opslistevaluatortemplatesinfo objects

参数解释:

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

取值范围:

评估器模板对象数组。

total

long

参数解释:

符合条件的模板总数。

取值范围:

0到2,147,483,647。

code

integer

参数解释:

api执行状态码。

取值范围:

32位整数。

msg

string

参数解释:

响应状态描述信息。

取值范围:

不涉及。

表3 opslistevaluatortemplatesinfo

参数

参数类型

描述

evaluator_type

integer

参数解释:

评估器类型标识。

取值范围:

0到2,147,483,647。

template_id

string

参数解释:

评估器模板的唯一id。

取值范围:

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

popularity

string

参数解释:

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

取值范围:

数字形式的字符串。

base_info

opsevaluatorbaseinfo object

参数解释:

评估器的基础审计信息,记录创建与更新详情。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

description

string

参数解释:

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

取值范围:

描述性文本。

evaluator_info

opslistevaluatortemplatesevaluatorinfo object

参数解释:

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

取值范围:

不涉及。

evaluator_content

opslistevaluatortemplatesevaluatorcontent object

参数解释:

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

取值范围:

不涉及。

name

string

参数解释:

评估器显示名称。

取值范围:

不涉及。

tags

opslistevaluatortemplatestags object

参数解释:

评估器分类标签。

取值范围:

不涉及。

表4 opsevaluatorbaseinfo

参数

参数类型

描述

created_at

string

参数解释:

评估器的创建时间。

created_by

evaluationopscreatedby object

参数解释:

记录评估资产创建者详情。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

updated_at

string

参数解释:

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

updated_by

evaluationopsupdatedby object

参数解释:

记录评估资产最近一次变更操作者信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表5 evaluationopscreatedby

参数

参数类型

描述

user_id

string

参数解释:

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

name

string

参数解释:

资源创建者的显示名称。

avatar_url

string

参数解释:

创建者的头像链接。

表6 evaluationopsupdatedby

参数

参数类型

描述

user_id

string

参数解释:

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

name

string

参数解释:

更新者的显示名称。

avatar_url

string

参数解释:

更新者的头像链接。

表7 opslistevaluatortemplatesevaluatorinfo

参数

参数类型

描述

benchmark

string

参数解释:

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

取值范围:

不涉及。

user_manual_url

string

参数解释:

用户手册网址。

取值范围:

不涉及。

vendor

string

参数解释:

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

取值范围:

供应商名称。

vendor_url

string

参数解释:

供应商官方资源链接。

取值范围:

不涉及。

表8 opslistevaluatortemplatesevaluatorcontent

参数

参数类型

描述

input_schemas

array of opslistevaluatortemplatesinputschemas objects

参数解释:

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

取值范围:

包含json_schema、key等的对象。

output_schemas

array of opslistevaluatortemplatesoutputschemas objects

参数解释:

输出参数定义。

取值范围:

不涉及。

prompt_evaluator

opslistevaluatortemplatespromptevaluator object

参数解释:

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

取值范围:

不涉及。

receive_chat_history

boolean

参数解释:

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

取值范围:

true: 接收, false: 不接收。

表9 opslistevaluatortemplatesinputschemas

参数

参数类型

描述

json_schema

string

参数解释:

json格式的入参描述。

取值范围:

不涉及。

key

string

参数解释:

参数标识关键字。

取值范围:

不涉及。

support_content_types

array of strings

参数解释:

支持的内容格式类型。

取值范围:

如 text 等。

表10 opslistevaluatortemplatesoutputschemas

参数

参数类型

描述

json_schema

string

参数解释:

json格式的出参描述。

取值范围:

不涉及。

key

string

参数解释:

输出关键字。

取值范围:

不涉及。

表11 opslistevaluatortemplatespromptevaluator

参数

参数类型

描述

message_list

array of opslistevaluatortemplatespromptmessage objects

参数解释:

提示词信息列表。

取值范围:

不涉及。

model_config

opslistevaluatortemplatesmodelconfig object

参数解释:

模型推理配置。

取值范围:

不涉及。

表12 opslistevaluatortemplatespromptmessage

参数

参数类型

描述

role

integer

参数解释:

消息角色。

取值范围:

  • 1:system

  • 2:user

content

opslistevaluatortemplatespromptcontent object

参数解释:

消息的具体内容对象。

取值范围:

不涉及。

表13 opslistevaluatortemplatespromptcontent

参数

参数类型

描述

text

string

参数解释:

提示词文本内容。

取值范围:

不涉及。

表14 opslistevaluatortemplatesmodelconfig

参数

参数类型

描述

model_id

string

参数解释:

模型唯一标识。

取值范围:

不涉及。

temperature

float

参数解释:

模型采样温度。

取值范围:

通常0.0到2.0。

表15 opslistevaluatortemplatestags

参数

参数类型

描述

zh-cn

opslistevaluatortemplatestagszhcn object

参数解释:

中文标签分类信息。

取值范围:

不涉及。

表16 opslistevaluatortemplatestagszhcn

参数

参数类型

描述

businessscenario

array of strings

参数解释:

业务场景标签。

取值范围:

如 aigc。

category

array of strings

参数解释:

功能类别标签。

取值范围:

如 llm。

请求示例

分页查询 category 标签为 "llm" 的评估器模板。

post https://api.example.com/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" : 1,
          "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

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

错误码

请参见错误码

相关文档

网站地图