查看评估任务列表 - ListOpsEvaluationTasks
功能介绍
该接口用于获取评估任务列表信息,支持条件筛选和分页查询,返回任务的基本信息和执行状态,适用于任务管理和监控的场景。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluationTask:listOpsEvaluationTasks | List | evaluationTask * | g:ResourceTag/<tag-key> | - | - |
URI
POST /v1/ops/evaluation-tasks/list
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 是 | Integer | 参数解释: 指定每次请求返回的偏移量,即从第几条数据开始查询。 约束限制: offset与limit配合使用实现分页查询,offset表示从第几条数据开始查询,limit表示每页返回的记录数量。 取值范围: 1~10000。 默认取值: 1。 |
| limit | 是 | Integer | 参数解释: 指定每页返回的记录数量(页大小)。 约束限制: 1到100之间的整数。 取值范围: 1到100。 默认取值: 10。 |
| tag_key_exists | 否 | Array of strings | 参数解释: 需要匹配的包含该标签名称的资源。 约束限制: 数组元素最小数量为0,最大数量为10,每个元素最大长度为128个字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_key_matches | 否 | Array of strings | 参数解释: 需要匹配的包含该标签的资源,需要和tag_value_matches条件配合使用。 约束限制: tag_key_matches和tag_value_matches按索引位置配对。数组元素最小数量为0,最大数量为10,每个元素最大长度为128个字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_value_matches | 否 | Array of strings | 参数解释: 需要匹配的包含该标签值的资源,需要和tag_key_matches条件配合使用。 约束限制: tag_key_matches和tag_value_matches按索引位置配对。数组元素最小数量为0,最大数量为10,每个元素最大长度为255个字符。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tag_match_policy | 否 | String | 参数解释: 标签匹配模式,仅针对tag_key_exists、tag_key_matches、tag_value_matches参数生效。 约束限制: 不涉及。 取值范围: 默认取值: ALL。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| data | data object | 响应数据。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 符合条件的任务总数。 |
| items | Array of OpsEvaluationTaskSummary objects | 评估任务列表。 |
| avg_score | Map<String,String> | 各评估器的平均得分(键为评估器ID,值为平均得分字符串)。 |
| total_task_status | total_task_status object | 各状态任务数量的统计信息(success/partial_success/running/pending/failed/stopped)。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 评估任务的唯一标识符。 |
| name | String | 评估任务名称。 |
| description | String | 评估任务描述。 |
| eval_mode | String | 评估模式(OFFLINE/ONLINE)。 |
| status | String | 任务状态(PENDING/RUNNING/COMPLETED/STOPPED等)。 |
| dataset_id | String | 关联的评测集ID。 |
| dataset_name | String | 关联的评测集名称。 |
| input_source_type | String | 输入源类型(DATASET_STATIC/DATASET_DYNAMIC/TRACE_STREAM)。 |
| created_at | String | 创建时间。 |
| updated_at | String | 更新时间。 |
| tags | Array of OpsTmsTag objects | 参数解释 评估任务绑定的TMS标签列表。 取值范围 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | String | 参数解释: 标签键名称。 取值范围: 不涉及。 |
| value | String | 参数解释: 标签值,存储该标签键对应的具体内容。 取值范围: 由任意字符组成,长度为0~256个字符。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| success | Long | 成功任务数 |
| partial_success | Long | 部分成功任务数 |
| running | Long | 运行中任务数 |
| pending | Long | 待执行任务数 |
| failed | Long | 失败任务数 |
| stopped | Long | 已停止任务数 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 系统定义的标准化错误代码。 取值范围: 业务异常编码字符串。 |
| error_msg | String | 参数解释: 对错误的详细描述,包含异常原因或解决建议。 取值范围: 字符长度2-512,任意文本内容。 |
| encoded_authorization_message | String | 参数解释: 编码后的授权信息,用于客户端解析权限问题。 取值范围: Base64编码的字符串。 |
| details | Array of OpsErrorDetail objects | 参数解释: 错误详情列表,包含多个子错误的详细信息。 取值范围: 不涉及。 |
| request_id | String | 参数解释: 请求的唯一标识符,用于问题排查和链路追踪。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 |
请求示例
分页查询评估任务列表,通过设置offset和limit控制返回的数据范围,支持TMS标签过滤。
POST https://api.example.com/v1/ops/evaluation-tasks/list
{
"offset" : 1,
"limit" : 10,
"tag_key_exists" : [ "env" ],
"tag_key_matches" : [ "team" ],
"tag_value_matches" : [ "ai-platform" ],
"tag_match_policy" : "ALL"
} 响应示例
状态码:200
请求成功
{
"data" : {
"total" : 3,
"items" : [ {
"id" : "1769499746650415700514",
"name" : "hzx111asdf",
"eval_mode" : "OFFLINE",
"description" : "",
"dataset_id" : "8f245ce1-aac2-47bf-a6cf-4ea8839fb8c9",
"dataset_name" : "test1",
"input_source_type" : "DATASET_STATIC",
"status" : "PENDING",
"created_at" : 1772156542650,
"updated_at" : 1772156542650,
"tags" : [ {
"key" : "env",
"value" : "prod"
}, {
"key" : "team",
"value" : "ai-platform"
} ]
} ],
"avg_score" : { },
"total_task_status" : {
"success" : 0,
"partial_success" : 0,
"running" : 0,
"pending" : 3,
"failed" : 0,
"stopped" : 0
}
}
} 状态码:400
请求错误
{
"error_code" : "AgentArts.03400003",
"error_msg" : "评估对象不存在"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求错误 |
错误码
请参见错误码。