更新时间：2026-09-02 GMT+08:00

查看评估任务列表 - ListOpsEvaluationTasks

功能介绍

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

调用方法

授权信息

账号根用户具备所有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	参数解释：需要匹配的包含该标签名称的资源。约束限制：支持批量查询多个标签名，最多支持10个标签。取值范围：数组元素最小数量0，最大数量10。每个元素最大长度128。默认取值：不涉及。
tag_key_matches	否	Array of strings	参数解释：需要匹配的包含该标签的资源，需要和tag_value_matches条件配合使用。约束限制： tag_key_matches和tag_value_matches按索引位置配对。支持批量查询多个标签，最多支持10个标签。取值范围：数组元素最小数量0，最大数量10。每个元素最大长度128。默认取值：不涉及。
tag_value_matches	否	Array of strings	参数解释：需要匹配的包含该标签值的资源，需要和tag_key_matches条件配合使用。约束限制： tag_key_matches和tag_value_matches按索引位置配对。支持批量查询多个标签值，最多支持10个标签值。取值范围：数组元素最小数量0，最大数量10。每个元素最大长度255。默认取值：不涉及。
tag_match_policy	否	String	参数解释：标签匹配模式，仅针对tag_key_exists、tag_key_matches、tag_value_matches参数生效。 ALL: 所有标签都必须匹配 ANY: 任意一个标签匹配即可 ALL ANY 约束限制：不涉及。取值范围：长度为1-3个字符。允许的值为：默认取值： ALL。

响应参数

状态码：200

请求成功

状态码：400

表2 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：系统定义的标准化错误代码。取值范围：业务异常编码字符串。
error_msg	String	参数解释：对错误的详细描述，包含异常原因或解决建议。取值范围：字符长度2-512，任意文本内容。
encoded_authorization_message	String	参数解释：编码后的授权信息，用于客户端解析权限问题。取值范围： Base64编码的字符串。
details	Array of OpsErrorDetail objects	参数解释：错误详情列表，包含多个子错误的详细信息。取值范围：不涉及。
request_id	String	参数解释：请求的唯一标识符，用于问题排查和链路追踪。取值范围：符合通用唯一识别码(UUID)标准的字符串。

表3 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",
      "evaluation_object_type" : "workflow",
      "dataset_name" : "test1",
      "input_source_type" : "DATASET_STATIC",
      "status" : "PENDING",
      "created_at" : "2026-01-27T15:42:26.650415+08:00",
      "tags" : [ {
        "key" : "env",
        "value" : "prod"
      }, {
        "key" : "team",
        "value" : "ai-platform"
      } ]
    } ]
  }
}

状态码：400

请求错误

{
  "error_code" : "AgentArts.03400003",
  "error_msg" : "评估对象不存在"
}

状态码

状态码	描述
200	请求成功
400	请求错误

错误码

请参见错误码。

父主题： 评估任务管理