获取评估器单个版本信息 - ShowOpsEvaluatorVersion
功能介绍
该接口用于通过评估器ID与版本ID获取特定版本的详细快照信息,包括该版本固化的判分逻辑、Prompt 模板、参数权重及生效配置。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluator:showOpsEvaluatorVersion | Read | evaluator * | g:ResourceTag/<tag-key> | - | - |
URI
GET /v1/ops/evaluators/{evaluator_id}/versions/{version_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| evaluator_id | 是 | String | 参数解释: 评估器的唯一标识符(ID)。可通过调用创建评估器接口获取,或通过查询评估器列表接口获取。该参数用于在路径中定位具体的评估逻辑或评估器实例。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| version_id | 是 | String | 参数解释: 评估器的具体版本号。用于在同一评估器ID下区分不同的配置版本或逻辑迭代。可通过调用获取评估器版本列表接口获取。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| evaluator | OpsListEvaluatorsInfo object | 参数解释: 评估器详细信息对象,引用OpsListEvaluatorsInfo定义。 取值范围: 不涉及。 |
| agent_call_timeout_minutes | Integer | 参数解释: 全局默认Agent调用超时时间(分钟),动态(自适应判定)评估器不返回。 取值范围: 不涉及。 |
| model_type | String | 参数解释: 该版本提交时的模型类型。 取值范围: |
| custom_model | 参数解释: 该版本提交时的自定义MaaS模型配置(model_type=custom_model 时返回)。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| base_info | OpsEvaluatorBaseInfo object | 参数解释: 评估器的基础审计信息,引用OpsEvaluatorBaseInfo对象。 取值范围: 不涉及。 |
| evaluator_id | String | 参数解释: 评估器的唯一标识符。 取值范围: 不涉及。 |
| name | String | 参数解释: 评估器的名称,用于界面展示和检索。 取值范围: 不涉及。 |
| description | String | 参数解释: 评估器的功能描述或业务用途说明。 取值范围: 不涉及。 |
| evaluator_type | Integer | 参数解释: 评估器的类型编码,用于区分不同的逻辑实现(如自定义评估器或系统评估器)。 取值范围: |
| turn_type | String | 参数解释: 评估器的对话轮次类型。 取值范围: |
| latest_version | String | 参数解释: 评估器的最新发布的版本号。 取值范围: 不涉及。 |
| current_version | OpsListEvaluatorVersionsInfo object | 参数解释: 评估器当前生效的版本信息,引用OpsListEvaluatorVersionsInfo定义。 取值范围: 不涉及。 |
| current_version_id | String | 参数解释: 评估器当前生效版本的唯一标识符。 取值范围: 不涉及。 |
| reference_count | Long | 参数解释: 该评估器被评估任务引用的次数。 取值范围: 非负整数。 |
| tags | Array of OpsTmsTag objects | 参数解释: 评估器绑定的TMS标签列表。数组元素引用OpsTmsTag对象。 取值范围: 不涉及。 |
| evaluator_content_type | String | 参数解释: 评估器的评估内容类型。 取值范围: |
| model_type | String | 参数解释: 评估器使用的模型类型。 取值范围: |
| custom_model | 参数解释: 自定义模型详细配置(model_type=custom_model 时返回)。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| version_id | String | 参数解释: 版本记录的ID。可通过调用获取评估器版本列表接口获取。 取值范围: 不涉及。 |
| evaluator_id | String | 参数解释: 评估器的唯一标识符。可通过调用创建评估器接口获取,或通过查询评估器列表接口获取。 取值范围: 不涉及。 |
| version | String | 参数解释: 评估器的具体版本号,用于区分不同的逻辑迭代。 取值范围: 不涉及。 |
| turn_type | String | 参数解释: 评估器的对话轮次类型。 取值范围: |
| evaluator_type | Integer | 参数解释: 评估器的分类类型编码。 取值范围: |
| evaluator_content_type | String | 参数解释: 评估内容类型。 取值范围: |
| description | String | 参数解释: 该版本的变更详细说明或备注。 取值范围: 不涉及。 |
| version_description | String | 参数解释: 版本描述。 取值范围: 不涉及。 |
| base_info | OpsEvaluatorBaseInfo object | 参数解释: 评估器的基础审计信息,引用OpsEvaluatorBaseInfo对象。 取值范围: 不涉及。 |
| evaluator_content | OpsEvaluatorContent object | 参数解释: 评估器内容对象,引用OpsEvaluatorContent对象,定义评估器的核心配置及输入Schema。 取值范围: 不涉及。 |
| reference_count | Long | 参数解释: 该版本被评估任务引用的次数。 取值范围: 非负整数。 |
| model_type | String | 参数解释: 该版本提交时的模型类型。 取值范围: |
| custom_model | 参数解释: 该版本提交时的自定义模型配置(model_type=custom_model 时返回)。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| created_at | String | 参数解释: 评估器的创建时间。时间格式为yyyy-MM-ddTHH:mm:ssZ,示例:2024-01-01T12:00:00Z。 取值范围: 不涉及。 |
| updated_at | String | 参数解释: 评估器的最近一次更新时间。时间格式为yyyy-MM-ddTHH:mm:ssZ,示例:2024-01-01T12:00:00Z。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| prompt_evaluator | OpsPromptEvaluator object | 参数解释: 提示词评估器对象,引用OpsPromptEvaluator对象,定义基于Prompt的评估逻辑及模型配置。 取值范围: 不涉及。 |
| input_schemas | Array of OpsEvaluatorContentSchemas objects | 参数解释: 评估器的Schema定义列表。数组内每个元素为Object类型,包含参数的键名和Schema定义。 取值范围: 不涉及。 |
| geval_config | OpsGEvalConfig object | 参数解释: G-Eval 评估器配置对象,包含评估标准、评分规则及模型配置。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释: 提示词模板的显示名称。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| json_schema | String | 参数解释: JSON格式的数据描述。 取值范围: 不涉及。 |
| key | String | 参数解释: 参数标识关键字。 取值范围: 不涉及。 |
| support_content_types | Array of strings | 参数解释: 支持的内容格式类型,如 Text 等。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| criteria | String | 参数解释: 评估标准描述,包含评估维度和评分依据。 取值范围: 不涉及。 |
| evaluation_steps | Array of strings | 参数解释: 评估步骤列表,每个步骤为一条操作指令。 取值范围: 不涉及。 |
| rubric | Array of OpsGEvalRubricItem objects | 参数解释: 评分量表,定义不同分数档位对应的参考表现描述。 取值范围: 不涉及。 |
| model_config | OpsEvaluationModelConfig object | 参数解释: 大模型调用配置。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| score | Float | 参数解释: 该档位的评分值,取值范围0.0~1.0。 取值范围: 0.0~1.0。 |
| reference_outcome | String | 参数解释: 该档位对应的参考表现描述。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | String | 参数解释: 标签键名称。 取值范围: 不涉及。 |
| value | String | 参数解释: 标签值,存储该标签键对应的具体内容。 取值范围: 由任意字符组成,长度为0~256个字符。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| model_provider_id | String | 参数解释: 模型提供商ID。可通过McpGateway控制台或调用查询模型提供商列表接口获取。 取值范围: 不涉及。 |
| model_id | String | 参数解释: McpGateway上注册的模型ID。可通过McpGateway控制台或调用查询模型列表接口获取。 取值范围: 不涉及。 |
| model_proxy_id | String | 参数解释: McpGateway上model_proxy网关ID,即调用GET /v1/core/custom-model-providers/{custom_model_provider_id}接口返回的gateways中agent_gateway_id字段的值,表示客户选择的模型代理ID。 取值范围: 不涉及。 |
| security_group_ids | Array of strings | 参数解释: 安全组ID列表,用于sandbox-proxy私网访问。可通过VPC控制台或调用查询安全组列表接口获取。 取值范围: 不涉及。 |
| vpc_id | String | 参数解释: 模型代理使用的具体VPC信息。可通过VPC服务查询VPC列表获取VPC ID。 取值范围: 不涉及。 |
| subnet_id | String | 参数解释: 模型代理使用的具体VPC子网信息。可通过VPC服务查询子网列表获取子网ID。 取值范围: 不涉及。 |
| model_provider_name | String | 参数解释: 自定义模型提供商名称。 取值范围: 不涉及。 |
| gateway_name | String | 参数解释: 自定义模型代理(网关)名称。 取值范围: 不涉及。 |
| model_name | String | 参数解释: 自定义模型名称。 取值范围: 不涉及。 |
请求示例
通过评估器ID和版本ID获取该特定版本的详细配置快照。
GET https://api.example.com/v1/ops/evaluators/7590068991923321858/versions/v-7590068991923321858-20240320
响应示例
状态码:200
{
"evaluator" : {
"evaluator_id" : "a3d1c9e7-6b2f-4850-9e4a-1f8d7c3b5a26",
"name" : "正确性评估",
"description" : "优化了评估准确率逻辑",
"evaluator_type" : 1,
"turn_type" : "single",
"reference_count" : 0,
"base_info" : {
"created_at" : "2026-04-10T16:58:00Z",
"updated_at" : "2026-04-10T17:30:00Z"
},
"current_version" : {
"version_id" : "version_id",
"evaluator_id" : "evaluator_id",
"version" : "v1.2.0",
"evaluator_type" : 1,
"evaluator_content_type" : "text",
"description" : "优化了评估准确率逻辑",
"version_description" : "",
"evaluator_content" : {
"input_schemas" : [ {
"key" : "input",
"support_content_types" : [ "text" ]
} ],
"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
}
}
},
"base_info" : {
"created_at" : "2026-04-10T16:58:00Z",
"updated_at" : "2026-04-10T17:30:00Z"
}
}
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 获取单个评估器版本信息成功 |
错误码
请参见错误码。