文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估任务管理/ 查看评估任务列表 - ListOpsEvaluationTasks
更新时间:2026-09-24 GMT+08:00
分享

查看评估任务列表 - ListOpsEvaluationTasks

功能介绍

该接口用于获取评估任务列表信息,支持条件筛选和分页查询,返回任务的基本信息和执行状态,适用于任务管理和监控的场景。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluationTask:listOpsEvaluationTasks

List

evaluationTask *

g:ResourceTag/<tag-key>

-

-

URI

POST /v1/ops/evaluation-tasks/list

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

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:所有标签都必须匹配

  • ANY:任意一个标签匹配即可

默认取值:

ALL。

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

data

data object

响应数据。

表3 data

参数

参数类型

描述

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)。

表4 OpsEvaluationTaskSummary

参数

参数类型

描述

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标签列表。

取值范围

不涉及。

表5 OpsTmsTag

参数

参数类型

描述

key

String

参数解释:

标签键名称。

取值范围:

不涉及。

value

String

参数解释:

标签值,存储该标签键对应的具体内容。

取值范围:

由任意字符组成,长度为0~256个字符。

表6 total_task_status

参数

参数类型

描述

success

Long

成功任务数

partial_success

Long

部分成功任务数

running

Long

运行中任务数

pending

Long

待执行任务数

failed

Long

失败任务数

stopped

Long

已停止任务数

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

系统定义的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对错误的详细描述,包含异常原因或解决建议。

取值范围:

字符长度2-512,任意文本内容。

encoded_authorization_message

String

参数解释:

编码后的授权信息,用于客户端解析权限问题。

取值范围:

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释:

错误详情列表,包含多个子错误的详细信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求的唯一标识符,用于问题排查和链路追踪。

取值范围:

符合通用唯一识别码(UUID)标准的字符串。

表8 OpsErrorDetail

参数

参数类型

描述

error_code

String

参数解释:

子错误的标准化错误代码。

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

对子错误的详细描述。

取值范围:

任意文本内容。

请求示例

分页查询评估任务列表,通过设置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

请求错误

错误码

请参见错误码。

相关文档