获取评估器模板列表 - ListOpsEvaluatorTemplates
功能介绍
该接口用于获取系统中的所有评估器模板信息列表,支持分页查询和条件筛选,适用于需要查看和管理评估器模板的场景。
URI
POST /v1/ops/evaluator-templates/list
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
filter_option |
否 |
Object |
参数解释: 用于设置获取评估器模板时的过滤条件,可以基于多个条件进行筛选。 约束限制: 过滤条件对象内包含逻辑操作和具体的条件列表。 取值范围: 默认取值: 不涉及。 |
|
page_size |
否 |
Integer |
参数解释: 指定每次请求返回的评估器模板数量,用于控制每次分页返回的数据量。 约束限制: 必须为0到10,000 之间的整数。 取值范围: 类型为整数,取值范围为0-10000的整数。 默认取值: 不涉及。 |
|
page_number |
否 |
Integer |
参数解释: 指定获取的页码,用于控制数据分页的页数定位。 约束限制: 必须为0到10,000之间的整数。 取值范围: 类型为整数,取值范围为0-10000的整数。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
evaluator_templates |
Array of evaluator_templates objects |
参数解释: 评估器模版列表包含获取到的所有符合条件的评估器模板数据,用于展示和选择。 取值范围: 评估器模版对象数组。 |
|
total |
Long |
参数解释: 符合条件的模板总数。 取值范围: 0到2,147,483,647。 |
|
code |
Integer |
参数解释: API执行状态码。 取值范围: 32位整数。 |
|
msg |
String |
参数解释: 响应状态描述信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
参数解释: 评估器分类标签。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_at |
String |
参数解释: 评估器的创建时间。 约束限制: 采用 ISO 8601 标准格式表示。 取值范围: 0到100个字符。 默认取值: 不涉及。 |
|
created_by |
EvaluationOpsCreatedBy object |
参数解释: 创建该评估器的用户信息。 约束限制: 符合 EvaluationOpsCreatedBy定义。 取值范围: 对象结构。 默认取值: 不涉及。 |
|
updated_at |
String |
参数解释: 评估器的最近一次更新时间。 约束限制: 采用 ISO 8601 标准格式表示。 取值范围: 0到100个字符。 默认取值: 不涉及。 |
|
updated_by |
EvaluationOpsUpdatedBy object |
参数解释: 最后一次修改该评估器的用户信息。 约束限制: 符合 EvaluationOpsUpdatedBy定义。 取值范围: 对象结构。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
user_id |
String |
参数解释: 资源创建者的唯一标识符。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
name |
String |
参数解释: 资源创建者的显示名称。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
avatar_url |
String |
参数解释: 创建者的头像链接。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
user_id |
String |
参数解释: 最后一次更新资源的用户的ID。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
name |
String |
参数解释: 更新者的显示名称。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
avatar_url |
String |
参数解释: 更新者的头像链接。 约束限制: 0到10000字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
benchmark |
String |
参数解释: 评估器的基准测试标准或参考系。 取值范围: 不涉及。 |
|
user_manual_url |
String |
参数解释: 用户手册网址。 取值范围: 不涉及。 |
|
vendor |
String |
参数解释: 评估器的提供方或开发机构。 取值范围: 供应商名称。 |
|
vendor_url |
String |
参数解释: 供应商官方资源链接。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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: 不接收。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
json_schema |
String |
参数解释: JSON格式的入参描述。 取值范围: 不涉及。 |
|
key |
String |
参数解释: 参数标识关键字。 取值范围: 不涉及。 |
|
support_content_types |
Array of strings |
参数解释: 支持的内容格式类型。 取值范围: 如 Text 等。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
json_schema |
String |
参数解释: JSON格式的出参描述。 取值范围: 不涉及。 |
|
key |
String |
参数解释: 输出关键字。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
message_list |
Array of message_list objects |
参数解释: 提示词信息列表。 取值范围: 不涉及。 |
|
model_config |
model_config object |
参数解释: 模型推理配置。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
role |
Integer |
参数解释: 消息角色。 取值范围: 1: System, 2: User 等。 |
|
content |
content object |
参数解释: 消息的具体内容对象。 取值范围: 不涉及。 |
请求示例
分页查询 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 |
获取评估器模板信息列表成功 |
错误码
请参见错误码。