获取评估器信息列表 - ListOpsEvaluators
功能介绍
该接口用于分页查询当前租户下所有已注册的评估器信息,支持按名称、类型或创建时间进行过滤评估器。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluator:listOpsEvaluators | List | evaluator * | g:ResourceTag/<tag-key> | - | - |
URI
POST /v1/ops/evaluators/list
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| builtin | 否 | Boolean | 参数解释: 是否为系统预置评估器的过滤开关。 约束限制: 布尔值。 取值范围: 默认取值: 无(查询全部)。 |
| filter_option | 否 | EvaluationOpsFilterOption object | 参数解释: 过滤条件配置对象,引用EvaluationOpsFilterOption对象。 约束限制: 不涉及。 |
| page_size | 否 | Integer | 参数解释: 分页查询时每页返回的记录数量。 约束限制: 与page_number配合使用实现分页查询。 取值范围: 0到10000之间的整数。 默认取值: 10。 |
| page_number | 否 | Integer | 参数解释: 分页查询的当前页码。 约束限制: 与page_size配合使用实现分页查询。 取值范围: 0到10000之间的整数。 默认取值: 1。 |
| tag_key_exists | 否 | Array of strings | 参数解释: 需要匹配的包含该标签名称的资源。数组元素为字符串类型,每个元素最大长度128。 约束限制: 支持批量查询多个标签名,最多支持10个标签。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_key_matches | 否 | Array of strings | 参数解释: 需要匹配的包含该标签的资源,需要和tag_value_matches条件配合使用。数组元素为字符串类型,每个元素最大长度128。 约束限制: tag_key_matches和tag_value_matches按索引位置配对。支持批量查询多个标签,最多支持10个标签。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_value_matches | 否 | Array of strings | 参数解释: 需要匹配的包含该标签值的资源,需要和tag_key_matches条件配合使用。数组元素为字符串类型,每个元素最大长度255。 约束限制: tag_key_matches和tag_value_matches按索引位置配对。支持批量查询多个标签值,最多支持10个标签值。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_match_policy | 否 | String | 参数解释: 标签匹配模式,仅针对tag_key_exists、tag_key_matches、tag_value_matches参数生效。 约束限制: 不涉及。 取值范围: 长度为1-3个字符。允许的值为: 默认取值: ALL。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| filters | 否 | EvaluationOpsFilters object | 参数解释: 过滤条件对象,引用EvaluationOpsFilters对象。 约束限制: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| evaluators | Array of OpsListEvaluatorsInfo objects | 参数解释: 包含评估器元数据、配置信息及状态的详细信息列表。数组元素引用OpsListEvaluatorsInfo对象。 取值范围: 不涉及。 |
| total | Integer | 参数解释: 符合当前过滤条件的评估器总记录数,常用于分页。 取值范围: 非负整数。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| evaluator_id | String | 参数解释: 评估器的唯一标识符。 取值范围: 不涉及。 |
| name | String | 参数解释: 评估器的名称,用于界面展示和检索。 取值范围: 不涉及。 |
| description | String | 参数解释: 评估器的功能描述或业务用途说明。 取值范围: 不涉及。 |
| evaluator_type | Integer | 参数解释: 评估器的类型编码,用于区分不同的逻辑实现(如自定义评估器或系统评估器)。 取值范围: |
| box_type | String | 参数解释: 评估器的可见性或黑白盒属性。 取值范围: |
| builtin | Boolean | 参数解释: 标识该评估器是否为系统预置。 取值范围: |
| latest_version | String | 参数解释: 评估器的最新发布的版本号。 取值范围: 不涉及。 |
| draft_submitted | Boolean | 参数解释: 标识当前的草稿内容是否已经提交。 取值范围: |
| tags | Array of OpsTmsTag objects | 参数解释: 评估器绑定的TMS标签列表。数组元素引用OpsTmsTag对象。 取值范围: 不涉及。 |
请求示例
查询当前租户下所有已注册的评估器信息
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,
"tag_key_exists" : [ "env" ],
"tag_key_matches" : [ "team" ],
"tag_value_matches" : [ "ai-platform" ],
"tag_match_policy" : "ALL"
} 响应示例
状态码:200
获取评估器列表信息成功
{
"evaluators" : [ {
"evaluator_id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
"name" : "正确性评估",
"description" : "评估提交的内容是否正确、准确、真实,并完整覆盖核心要点。",
"evaluator_type" : 1,
"box_type" : "White",
"builtin" : false,
"latest_version" : "0.0.1",
"draft_submitted" : true,
"base_info" : {
"created_at" : "2026-04-13T17:34:08.696Z",
"created_by" : {
"name" : "ARM301_Versatile_z30038842_01",
"user_id" : "6f80301edacc43728bf47b6a6484d512"
},
"updated_at" : "2026-04-13T17:34:08.696Z",
"updated_by" : {
"name" : "ARM301_Versatile_z30038842_01",
"user_id" : "6f80301edacc43728bf47b6a6484d512"
}
},
"current_version" : {
"id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
"version" : "0.0.1",
"description" : "正确性评估器初始版本",
"evaluator_content" : "",
"base_info" : {
"created_at" : "2026-04-13T17:34:08.696Z",
"created_by" : {
"name" : "ARM301_Versatile_z30038842_01",
"user_id" : "6f80301edacc43728bf47b6a6484d512"
},
"updated_at" : "2026-04-13T17:34:08.696Z",
"updated_by" : {
"name" : "ARM301_Versatile_z30038842_01",
"user_id" : "6f80301edacc43728bf47b6a6484d512"
}
}
},
"tags" : [ {
"key" : "env",
"value" : "prod"
}, {
"key" : "team",
"value" : "ai-platform"
} ]
} ],
"total" : 22
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 获取评估器列表信息成功 |
错误码
请参见错误码。