获取评估器信息列表 - ListOpsEvaluators
功能介绍
该接口用于分页查询当前租户下所有已注册的评估器信息,支持按名称、类型或创建时间进行过滤评估器。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluator:listOpsEvaluators | List | evaluator * | g:ResourceTag/<tag-key> | - | - |
URI
POST /v1/ops/evaluators/list
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| builtin | 否 | Boolean | 参数解释: 是否为系统预置评估器的过滤开关。 约束限制: 不涉及。 取值范围: 默认取值: 无(查询全部)。 |
| filter_option | 否 | EvaluationOpsFilterOption object | 参数解释: 过滤条件配置对象,引用EvaluationOpsFilterOption对象。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| offset | 否 | Integer | 参数解释: 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回,常与 limit参数配合实现分页功能。 约束限制: 必须为整数,且大小在0到2147483647之间。 取值范围: 0-2147483647。 默认取值: 0。 |
| limit | 否 | AnyType | 参数解释: 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 约束限制: 必须为整数,且大小在1到100之间。 取值范围: 1-100。 默认取值: 10。 |
| tag_key_exists | 否 | Array of strings | 参数解释: 需要匹配的包含该标签名称的资源。数组元素为字符串类型,每个元素最大长度128。 约束限制: 数组元素最小数量为0,最大数量为10,每个元素最大长度为128个字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_key_matches | 否 | Array of strings | 参数解释: 需要匹配的包含该标签的资源,需要和tag_value_matches条件配合使用。数组元素为字符串类型,每个元素最大长度128。 约束限制: tag_key_matches和tag_value_matches按索引位置配对。数组元素最小数量为0,最大数量为10,每个元素最大长度为128个字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_value_matches | 否 | Array of strings | 参数解释: 需要匹配的包含该标签值的资源,需要和tag_key_matches条件配合使用。数组元素为字符串类型,每个元素最大长度255。 约束限制: tag_key_matches和tag_value_matches按索引位置配对。数组元素最小数量为0,最大数量为10,每个元素最大长度为255个字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_match_policy | 否 | String | 参数解释: 标签匹配模式,仅针对tag_key_exists、tag_key_matches、tag_value_matches参数生效。 约束限制: 不涉及。 取值范围: 默认取值: ALL。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| filters | 否 | EvaluationOpsFilters object | 参数解释: 过滤条件对象,引用EvaluationOpsFilters对象。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| evaluators | Array of OpsListEvaluatorsInfo objects | 参数解释: 包含评估器元数据、配置信息及状态的详细信息列表。数组元素引用OpsListEvaluatorsInfo对象。 取值范围: 不涉及。 |
| total | Integer | 参数解释: 符合当前过滤条件的评估器总记录数,常用于分页。 取值范围: 非负整数。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释: 自定义模型名称。 取值范围: 不涉及。 |
请求示例
查询当前租户下所有已注册的评估器信息
POST https://api.example.com/v1/ops/evaluators/list
{
"builtin" : false,
"filter_option" : {
"filters" : {
"logic_op" : "And",
"filter_conditions" : [ { } ]
}
},
"offset" : 0,
"limit" : 10,
"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,
"turn_type" : "single",
"latest_version" : "0.0.1",
"current_version_id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
"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"
},
"base_info" : {
"created_at" : "2026-04-13T17:34:08.696Z",
"updated_at" : "2026-04-13T17:34:08.696Z"
},
"current_version" : {
"version_id" : "23b9ff4f-79cb-44a8-8ffd-5d3d0fd8e1a8",
"version" : "0.0.1",
"description" : "正确性评估器初始版本",
"evaluator_content" : { },
"base_info" : {
"created_at" : "2026-04-13T17:34:08.696Z",
"updated_at" : "2026-04-13T17:34:08.696Z"
}
},
"tags" : [ {
"key" : "env",
"value" : "prod"
}, {
"key" : "team",
"value" : "ai-platform"
} ]
} ],
"total" : 22
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 获取评估器列表信息成功 |
错误码
请参见错误码。