获取评估器信息 - ShowOpsEvaluator
功能介绍
该接口用于通过指定的评估器ID检索其完整定义信息,包括判分逻辑、参数配置、关联模型及元数据详情,是核对特定评测标准执行细节的核心入口。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluator:showOpsEvaluator | Read | evaluator * | g:ResourceTag/<tag-key> | - | - |
URI
GET /v1/ops/evaluators/{evaluator_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| evaluator_id | 是 | String | 参数解释: 评估器的唯一标识符(ID)。可通过调用创建评估器接口获取,或通过查询评估器列表接口获取。该参数在路径中指定,用于精确定位需要操作或查询的特定评估器资源。 约束限制: 不涉及。 取值范围: 由字母、数字和连字符(-)组成的字符串,长度为1~100个字符。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| evaluator | OpsListEvaluatorsInfo object | 参数解释: 评估器详细信息对象,引用OpsListEvaluatorsInfo定义。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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精确查询其配置详情、版本信息及判定逻辑。
GET https://api.example.com/v1/ops/evaluators/7590068991923321858
响应示例
状态码:200
{
"evaluator" : {
"evaluator_id" : "ade111ca-843f-4e20-a9a4-01a9aa22a3f9",
"name" : "正确性评估",
"description" : "评估提交的内容是否正确、准确、真实,并完整覆盖核心要点。",
"evaluator_type" : 1,
"turn_type" : "single",
"evaluator_content_type" : "text",
"current_version_id" : "1.0.0",
"latest_version" : "0.0.2",
"base_info" : {
"created_at" : "2026-04-10T16:58:00Z",
"updated_at" : "2026-04-10T17:30:00Z"
},
"current_version" : {
"version" : "1.0.0",
"description" : "正确性评估器初始版本",
"version_description" : "",
"evaluator_content" : { }
},
"reference_count" : 0,
"model_type" : "custom_model",
"custom_model" : {
"model_provider_id" : "provider-123456",
"model_id" : "model-123456",
"model_proxy_id" : "gateway-123456",
"security_group_ids" : [ "ade111ca-843f-4e20-a9a4-01a9aa22a3f9" ],
"vpc_id" : "vpc-123456",
"subnet_id" : "subnet-123456",
"model_provider_name" : "model_provider_test",
"gateway_name" : "default_gateway",
"model_name" : "DeepSeek-R1"
},
"tags" : [ {
"key" : "env",
"value" : "prod"
}, {
"key" : "team",
"value" : "ai-platform"
} ]
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。