# 获取评估器模板列表 - ListOpsEvaluatorTemplates #### 功能介绍 该接口用于获取系统中的所有评估器模板信息列表，支持分页查询和条件筛选，适用于需要查看和管理评估器模板的场景。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts::listOpsEvaluatorTemplates | List | - | - | - | - | #### URI POST /v1/ops/evaluator-templates/list #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | filter_option | 否 | Object | **参数解释：** 用于设置获取评估器模板时的过滤条件，可以基于多个条件进行筛选。filter_option对象包含以下子参数：logic_op（逻辑运算符，如And/Or，用于组合多个过滤条件）、tag_key（标签键名，用于按标签维度筛选）、operator（比较运算符，如等于、包含等）、value（过滤条件的匹配值）等字段。 **约束限制：** 不涉及。 | | page_size | 否 | Integer | **参数解释：** 指定每次请求返回的评估器模板数量，用于控制每次分页返回的数据量。 **约束限制：** 与page_number配合使用实现分页查询。 **取值范围：** 类型为整数，取值范围为0-10000的整数。 **默认取值：** 不涉及。 | | page_number | 否 | Integer | **参数解释：** 指定获取的页码，用于控制数据分页的页数定位。 **约束限制：** 与page_size配合使用实现分页查询。 **取值范围：** 类型为整数，取值范围为0-10000的整数。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | evaluator_templates | Array of [OpsListEvaluatorTemplatesInfo] objects | **参数解释：** 评估器模板列表包含获取到的所有符合条件的评估器模板数据，用于展示和选择。数组内每个元素引用OpsListEvaluatorTemplatesInfo对象，包含评估器模板的完整配置信息。 | | total | Long | **参数解释：** 符合条件的模板总数。 **取值范围：** 由数字组成，0\~2147483647。 | | code | Integer | **参数解释：** API执行状态码。 **取值范围：** 不涉及。 | | msg | String | **参数解释：** 响应状态描述信息。 **取值范围：** 不涉及。 | 表3OpsListEvaluatorTemplatesInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | evaluator_type | Integer | **参数解释：** 评估器类型标识。 **取值范围：** - 1：模型评估器 - 2：代码评估器 - 3：自适应评估器 | | template_id | String | **参数解释：** 评估器模板的唯一ID。 **取值范围：** 不涉及。 | | popularity | String | **参数解释：** 流行度表示评估器在用户中的受欢迎程度和使用频率。 **取值范围：** 不涉及。 | | base_info | [OpsEvaluatorBaseInfo] object | **参数解释：** 评估器的基础审计信息，引用OpsEvaluatorBaseInfo对象。 | | description | String | **参数解释：** 评估器描述用于说明评估器的功能、用途和使用场景。 **取值范围：** 不涉及。 | | evaluator_info | [OpsListEvaluatorTemplatesEvaluatorInfo] object | **参数解释：** 评估器信息对象，引用OpsListEvaluatorTemplatesEvaluatorInfo对象。 | | evaluator_content | [OpsListEvaluatorTemplatesEvaluatorContent] object | **参数解释：** 评估器内容对象，引用OpsListEvaluatorTemplatesEvaluatorContent对象。 | | name | String | **参数解释：** 评估器显示名称。 **取值范围：** 不涉及。 | | tags | [OpsListEvaluatorTemplatesTags] object | **参数解释：** 模板标签信息，引用OpsListEvaluatorTemplatesTags对象。Key为语言代码（如zh-CN），Value为标签分类对象。 | 表4OpsEvaluatorBaseInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | created_at | String | **参数解释：** 评估器的创建时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。 **取值范围：** 不涉及。 | | created_by | [EvaluationOpsCreatedBy] object | **参数解释：** 评估器的创建者信息，引用EvaluationOpsCreatedBy对象。 | | updated_at | String | **参数解释：** 评估器的最近一次更新时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。 **取值范围：** 不涉及。 | | updated_by | [EvaluationOpsUpdatedBy] object | **参数解释：** 评估器的最近一次更新者信息，引用EvaluationOpsUpdatedBy对象。 | 表5EvaluationOpsCreatedBy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | user_id | String | **参数解释：** 资源创建者的唯一标识符。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 资源创建者的显示名称。 **取值范围：** 不涉及。 | | avatar_url | String | **参数解释：** 创建者的头像链接。 **取值范围：** 不涉及。 | 表6EvaluationOpsUpdatedBy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | user_id | String | **参数解释：** 最后一次更新资源的用户的ID。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 更新者的显示名称。 **取值范围：** 不涉及。 | | avatar_url | String | **参数解释：** 更新者的头像链接。 **取值范围：** 不涉及。 | 表7OpsListEvaluatorTemplatesEvaluatorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | benchmark | String | **参数解释：** 评估器的基准测试标准或参考系。 **取值范围：** 不涉及。 | | user_manual_url | String | **参数解释：** 用户手册网址。 **取值范围：** 不涉及。 | | vendor | String | **参数解释：** 评估器的提供方或开发机构。 **取值范围：** 不涉及。 | | vendor_url | String | **参数解释：** 供应商官方资源链接。 **取值范围：** 不涉及。 | 表8OpsListEvaluatorTemplatesEvaluatorContent | 参数 | 参数类型 | 描述 | |:---|:---|:---| | input_schemas | Array of [OpsListEvaluatorTemplatesInputSchemas] objects | **参数解释：** 输入参数定义评估器接收的数据格式。数组内每个元素为OpsListEvaluatorTemplatesInputSchemas对象，包含json_schema、key、support_content_types等字段。 | | output_schemas | Array of [OpsListEvaluatorTemplatesOutputSchemas] objects | **参数解释：** 输出参数定义。 | | prompt_evaluator | [OpsListEvaluatorTemplatesPromptEvaluator] object | **参数解释：** 包含评估过程中使用的提示词内容和模型配置。 | | receive_chat_history | Boolean | **参数解释：** 是否接收聊天记录上下文。 **取值范围：** true: 接收, false: 不接收。 | 表9OpsListEvaluatorTemplatesInputSchemas | 参数 | 参数类型 | 描述 | |:---|:---|:---| | json_schema | String | **参数解释：** JSON格式的入参描述。 **取值范围：** 不涉及。 | | key | String | **参数解释：** 参数标识关键字。 **取值范围：** 不涉及。 | | support_content_types | Array of strings | **参数解释：** 支持的内容格式类型，如 Text 等。 | 表10OpsListEvaluatorTemplatesOutputSchemas | 参数 | 参数类型 | 描述 | |:---|:---|:---| | json_schema | String | **参数解释：** JSON格式的出参描述。 **取值范围：** 不涉及。 | | key | String | **参数解释：** 输出关键字。 **取值范围：** 不涉及。 | 表11OpsListEvaluatorTemplatesPromptEvaluator | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message_list | Array of [OpsListEvaluatorTemplatesPromptMessage] objects | **参数解释：** 提示词信息列表。数组内每个元素为OpsListEvaluatorTemplatesPromptMessage对象，包含role（消息角色）和content（消息内容对象，引用OpsListEvaluatorTemplatesPromptContent）字段。 | | model_config | [OpsListEvaluatorTemplatesModelConfig] object | **参数解释：** 模型推理配置。 | 表12OpsListEvaluatorTemplatesPromptMessage | 参数 | 参数类型 | 描述 | |:---|:---|:---| | role | Integer | **参数解释：** 消息角色。 **取值范围：** - 1：System角色 - 2：User角色 | | content | [OpsListEvaluatorTemplatesPromptContent] object | **参数解释：** 消息的具体内容对象。 | 表13OpsListEvaluatorTemplatesPromptContent | 参数 | 参数类型 | 描述 | |:---|:---|:---| | text | String | **参数解释：** 提示词文本内容。 **取值范围：** 不涉及。 | 表14OpsListEvaluatorTemplatesModelConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | model_id | String | **参数解释：** 模型唯一标识。 **取值范围：** 不涉及。 | | temperature | Float | **参数解释：** 模型采样温度。 **取值范围：** 0.0\~2.0。 | 表15OpsListEvaluatorTemplatesTags | 参数 | 参数类型 | 描述 | |:---|:---|:---| | zh-CN | [OpsListEvaluatorTemplatesTagsZhCN] object | **参数解释：** 中文标签分类信息。 | 表16OpsListEvaluatorTemplatesTagsZhCN | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 获取评估器模板信息列表成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。