# 获取评估器信息列表 - ListOpsEvaluators #### 功能介绍 该接口用于分页查询当前租户下所有已注册的评估器信息，支持按名称、类型或创建时间进行过滤评估器。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:evaluator:listOpsEvaluators | List | evaluator \* | g:ResourceTag/\ | - | - | #### URI POST /v1/ops/evaluators/list #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | builtin | 否 | Boolean | **参数解释：** 是否为系统预置评估器的过滤开关。 **约束限制：** 布尔值。 **取值范围：** - true: 仅查询预置评估器 - false: 仅查询用户自定义评估器 **默认取值：** 无（查询全部）。 | | 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参数生效。 - ALL: 所有标签都必须匹配 - ANY: 任意一个标签匹配即可 - ALL - ANY **约束限制：** 不涉及。 **取值范围：** 长度为1-3个字符。允许的值为： **默认取值：** ALL。 | 表2EvaluationOpsFilterOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | filters | 否 | [EvaluationOpsFilters] object | **参数解释：** 过滤条件对象，引用EvaluationOpsFilters对象。 **约束限制：** 不涉及。 | 表3EvaluationOpsFilters | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | logic_op | 否 | String | **参数解释：** 过滤条件的逻辑运算符。 **约束限制：** 不涉及。 **取值范围：** - And：所有条件都需满足 - Or：满足任一条件即可 **默认取值：** 不涉及。 | | filter_conditions | 否 | Array of objects | **参数解释：** 具体的过滤条件列表，数组元素为Object类型的过滤条件对象。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | evaluators | Array of [OpsListEvaluatorsInfo] objects | **参数解释：** 包含评估器元数据、配置信息及状态的详细信息列表。数组元素引用OpsListEvaluatorsInfo对象。 **取值范围：** 不涉及。 | | total | Integer | **参数解释：** 符合当前过滤条件的评估器总记录数，常用于分页。 **取值范围：** 非负整数。 | 表5OpsListEvaluatorsInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | evaluator_id | String | **参数解释：** 评估器的唯一标识符。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 评估器的名称，用于界面展示和检索。 **取值范围：** 不涉及。 | | description | String | **参数解释：** 评估器的功能描述或业务用途说明。 **取值范围：** 不涉及。 | | evaluator_type | Integer | **参数解释：** 评估器的类型编码，用于区分不同的逻辑实现（如自定义评估器或系统评估器）。 **取值范围：** - 1：模型评估器 - 2：代码评估器 - 3：自适应评估器 | | box_type | String | **参数解释：** 评估器的可见性或黑白盒属性。 **取值范围：** - White：白盒 - Black：黑盒 | | builtin | Boolean | **参数解释：** 标识该评估器是否为系统预置。 **取值范围：** - true：是系统预置评估器 - false：是用户自定义评估器 | | latest_version | String | **参数解释：** 评估器的最新发布的版本号。 **取值范围：** 不涉及。 | | draft_submitted | Boolean | **参数解释：** 标识当前的草稿内容是否已经提交。 **取值范围：** - true：已提交 - false：未提交 | | tags | Array of [OpsTmsTag] objects | **参数解释：** 评估器绑定的TMS标签列表。数组元素引用OpsTmsTag对象。 **取值范围：** 不涉及。 | 表6OpsTmsTag | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签键名称。 **取值范围：** 不涉及。 | | value | String | **参数解释：** 标签值，存储该标签键对应的具体内容。 **取值范围：** 长度0-256个字符。 | #### 请求示例 查询当前租户下所有已注册的评估器信息 ``` 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 | 获取评估器列表信息成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。