# 获取评估器所有版本信息 - ListOpsEvaluatorVersions #### 功能介绍 该接口用于查询指定评估器下所有已发布的历史版本列表，提供各版本的发布时间、逻辑快照及版本状态。 #### 调用方法 请参见[如何调用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:listOpsEvaluatorVersions | List | evaluator \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/evaluators/{evaluator_id}/versions 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | evaluator_id | 是 | String | **参数解释：** 评估器的唯一标识符（ID）。可通过调用创建评估器接口获取，或通过查询评估器列表接口获取。该参数用于在API路径中定位具体的评估逻辑或评估器实例。 **约束限制：** 长度为0到10000个字符的字符串。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 否 | Integer | **参数解释：** 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与 limit参数配合实现分页功能。 **约束限制：** 与limit参数配合使用实现分页查询。 **取值范围：** 0\~10000。 **默认取值：** 0。 | | limit | 否 | Integer | **参数解释：** 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 **约束限制：** 与offset参数配合使用实现分页查询。 **取值范围：** 1-100。 **默认取值：** 10。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | versions | Array of [OpsListEvaluatorVersionsInfo] objects | **参数解释：** 评估器的版本列表，包含该评估器下所有已发布的历史版本及配置详情。数组内每个元素引用OpsListEvaluatorVersionsInfo对象，包含版本号、评估器ID、描述、基础信息和评估器内容等字段。 | | total | Integer | **参数解释：** 数据总数数量。 **取值范围：** 不涉及。 | 表4OpsListEvaluatorVersionsInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | evaluator_id | String | **参数解释：** 评估器的唯一标识符。可通过调用创建评估器接口获取，或通过查询评估器列表接口获取。 **取值范围：** 不涉及。 | | version | String | **参数解释：** 评估器的具体版本号，用于区分不同的逻辑迭代。 **取值范围：** 不涉及。 | | description | String | **参数解释：** 该版本的变更详细说明或备注。 **取值范围：** 不涉及。 | | base_info | [OpsEvaluatorBaseInfo] object | **参数解释：** 评估器的基础审计信息，引用OpsEvaluatorBaseInfo对象。 | | evaluator_content | [OpsEvaluatorContent] object | **参数解释：** 评估器内容对象，引用OpsEvaluatorContent对象，定义评估器的核心配置及输入Schema。 | 表5OpsEvaluatorBaseInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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对象。 | 表6EvaluationOpsCreatedBy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | user_id | String | **参数解释：** 资源创建者的唯一标识符。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 资源创建者的显示名称。 **取值范围：** 不涉及。 | | avatar_url | String | **参数解释：** 创建者的头像链接。 **取值范围：** 不涉及。 | 表7EvaluationOpsUpdatedBy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | user_id | String | **参数解释：** 最后一次更新资源的用户的ID。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 更新者的显示名称。 **取值范围：** 不涉及。 | | avatar_url | String | **参数解释：** 更新者的头像链接。 **取值范围：** 不涉及。 | 表8OpsEvaluatorContent | 参数 | 参数类型 | 描述 | |:---|:---|:---| | prompt_evaluator | [OpsPromptEvaluator] object | **参数解释：** 提示词评估器对象，引用OpsPromptEvaluator对象，定义基于Prompt的评估逻辑及模型配置。 | | input_schemas | Array of objects | **参数解释：** 评估器输入参数的Schema定义列表。数组内每个元素为Object类型，包含输入参数的键名和Schema定义。 | 表9OpsPromptEvaluator | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message_list | Array of objects | **参数解释：** 消息列表，包含评估过程中的对话记录或消息对象。数组内每个元素为Object类型，包含role（消息角色）、content（消息内容对象）等字段。 | | model_config | [OpsEvaluationModelConfig] object | **参数解释：** 模型配置信息，定义评估时使用的模型参数。 | | prompt_source_type | Integer | **参数解释：** 提示词（Prompt）的来源类型。 **取值范围：** 不涉及。 | | prompt_template_key | String | **参数解释：** 提示词模板的唯一关键字（Key）。 **取值范围：** 不涉及。 | | prompt_template_name | String | **参数解释：** 提示词模板的显示名称。 **取值范围：** 不涉及。 | 表10OpsEvaluationModelConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | model_id | String | **参数解释：** 模型的唯一标识符。可通过调用获取模型列表接口获取。 **取值范围：** 不涉及。 | | model_name | String | **参数解释：** 模型的显示名称。 **取值范围：** 不涉及。 | | temperature | Float | **参数解释：** 采样温度参数，用于控制输出的随机性。数值低更聚焦，数值高更具创造性。 **取值范围：** 0.0\~2.0。 | | max_tokens | Integer | **参数解释：** 单次推理生成的最大Token数量限制，单位：个。 **取值范围：** 1\~32000。 | | top_p | Float | **参数解释：** 核采样参数，用于控制生成时考虑的概率分布范围，值越小生成内容越确定，值越大生成内容越多样。 **取值范围：** 0.0\~1.0。 | | frequency_penalty | Float | **参数解释：** 频率惩罚系数，降低内容重复倾向。 **取值范围：** -2.0\~2.0。 | #### 请求示例 查询特定评估器下的所有历史版本列表及其配置快照。 ``` GET https://api.example.com/v1/ops/evaluators/7590068991923321858/versions ``` #### 响应示例 **状态码：200** 获取评估器所有版本信息成功 ``` { "versions" : [ { "evaluator_id" : "evaluator_id", "version" : "v1.2.0", "description" : "优化了评估准确率逻辑", "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" } }, "evaluator_content" : { "prompt_evaluator" : { "message_list" : [ ], "model_config" : { "model_id" : "1749615103", "model_name" : "豆包·1.6·自动深度思考", "temperature" : 0.1, "max_tokens" : 4096, "top_p" : 0.7, "frequency_penalty" : 0 }, "prompt_source_type" : 1, "prompt_template_key" : "prompt_template_key", "prompt_template_name" : "prompt_template_name" }, "input_schemas" : [ { } ] } } ], "total" : 10 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 获取评估器所有版本信息成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。