文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估器管理/ 获取评估器筛选选项列表 - ListOpsEvaluatorFilterOptions
更新时间:2026-06-10 GMT+08:00
分享

获取评估器筛选选项列表 - ListOpsEvaluatorFilterOptions

功能介绍

该接口用于获取评估器列表页面可用的筛选维度及其枚举值。

前端通过此接口动态渲染筛选下拉框,帮助用户快速定位所需的评估器。

返回的筛选项包括:

  • evaluator_type: 评估器类型(模型判定/代码判定/自适应判定)

  • turn_type: 对话轮次类型(单轮/多轮)

  • evaluator_content_type: 内容类型(文本/轨迹)

  • evaluator_objective_type: 评估目标类型(任务完成/输出质量/安全/工具调用/轨迹质量)

典型应用场景:

用户在评估器列表页面选择筛选条件时,前端调用此接口获取可选的筛选项。

调用方法

请参见如何调用API

授权信息

当前API调用无需身份策略权限。

URI

GET /v1/ops/evaluator-filter-options

请求参数

响应参数

状态码:200

表1 响应Body参数

参数

参数类型

描述

filter_options

filter_options object

参数解释:

评估器筛选选项集合,包含各个维度的可用筛选项。

约束限制:

各维度下的筛选项为非空数组。

取值范围:

预定义的枚举值集合。

默认取值:

不涉及。

表2 filter_options

参数

参数类型

描述

evaluator_type

Array of integers

参数解释:

评估器类型筛选项。

约束限制:

至少包含 1 个选项,最多包含 3 个选项。

取值范围:

  • 1: 模型判定

  • 2: 代码判定

  • 3: 自适应判定

默认取值:

不涉及。

turn_type

Array of strings

参数解释:

对话轮次类型筛选项。

约束限制:

至少包含 1 个选项,最多包含 2 个选项。

取值范围:

  • single: 单轮对话

  • multi: 多轮对话

默认取值:

不涉及。

evaluator_content_type

Array of strings

参数解释:

评估内容类型筛选项。

约束限制:

至少包含 1 个选项,最多包含 2 个选项。

取值范围:

  • text: 文本

  • trajectory: 轨迹

默认取值:

不涉及。

evaluator_objective_type

Array of strings

参数解释:

评估目标类型筛选项。

约束限制:

至少包含 1 个选项,最多包含 5 个选项。

取值范围:

  • 任务完成: 评估任务是否完成

  • 输出质量: 评估输出内容的质量

  • 安全: 评估内容安全性

  • 工具调用: 评估工具调用的合理性

  • 轨迹质量: 评估 Agent 轨迹的质量

默认取值:

不涉及。

状态码:500

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,用于标识请求失败的具体原因。

约束限制:

格式为服务简写加数字编码,例如Agentarts.40000001。

取值范围:

服务简写为2到8位大写字母,数字编码为8位,首位通常为4、6或8。

默认取值:

不涉及。

error_msg

String

参数解释:

错误描述信息,用于说明请求失败原因。

约束限制:

长度为1到512个字符。

取值范围:

符合自然语言规范的错误描述。

默认取值:

不涉及。

request_id

String

参数解释:

请求追踪ID,用于问题定位和日志检索。

约束限制:

长度为1到128个字符。

取值范围:

系统生成的请求唯一标识。

默认取值:

不涉及。

请求示例

响应示例

状态码:200

查询成功

{
  "filter_options" : {
    "evaluator_type" : [ 1, 2, 3 ],
    "turn_type" : [ "single", "multi" ],
    "evaluator_content_type" : [ "text", "trajectory" ],
    "evaluator_objective_type" : [ "任务完成", "输出质量", "安全", "工具调用", "轨迹质量" ]
  }
}

状态码:500

服务器内部错误

{
  "error_code" : "EVAL.80000001",
  "error_msg" : "服务器内部错误",
  "request_id" : "550e8400-e29b-41d4-a716-446655440000"
}

状态码

状态码

描述

200

查询成功

500

服务器内部错误

错误码

请参见错误码

相关文档