文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估任务管理/ 查看评估任务列表 - ListOpsEvaluationTasks
更新时间:2026-10-16 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表示每页返回的记录数量。

取值范围:

0~10000。

默认取值:

0。

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。

filters

否

Object

参数解释:

可选的过滤条件,键值对形式,如 {"status": "SUCCESS"}。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码: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:已完成;FAILED:执行失败;STOPPED:已停止。

dataset_id

String

参数解释:

关联的评测集ID。

取值范围:

不涉及。

dataset_name

String

参数解释:

关联的评测集名称。

取值范围:

不涉及。

input_source_type

String

参数解释:

输入源类型。

取值范围:

DATASET_STATIC:数据集静态输入;DATASET_DYNAMIC:数据集动态输入;TRACE_STREAM:轨迹流输入。

created_at

String

参数解释:

创建时间,采用ISO 8601时间格式(yyyy-MM-ddTHH:mm:ssZ)。

取值范围:

不涉及。

updated_at

String

参数解释:

更新时间,采用ISO 8601时间格式(yyyy-MM-ddTHH:mm:ssZ)。

取值范围:

不涉及。

tags

Array of OpsTmsTag objects

参数解释

评估任务绑定的TMS标签列表。

取值范围

不涉及。

runtime_config

OpsRuntimeConfig object

参数解释:

任务运行时配置,包含离线任务Agent调用超时时间等。

表5 OpsTmsTag

参数

参数类型

描述

key

String

参数解释:

标签键名称。

取值范围:

不涉及。

value

String

参数解释:

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

取值范围:

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

表6 OpsRuntimeConfig

参数

参数类型

描述

execution_time

Long

参数解释:

任务的预定执行时间(Unix 时间戳),单位:秒。

取值范围:

单位为秒,0-9999999999999

concurrency

Integer

参数解释:

任务执行的并发数配置。

取值范围:

1-100。

continue_on_exception

Boolean

参数解释:

异常处理策略,是否在遇到非致命异常时继续。

取值范围:

true:遇到异常时继续执行,false:遇到异常时停止执行。

agent_call_timeout_minutes

Integer

参数解释:

离线任务Agent调用超时时间(分钟)。

取值范围:

仅支持5/10/15/20;不传(null)时后端填充配置项默认值。

gen_summary

Boolean

参数解释:

是否生成评估总结报告。

取值范围:

  • true:生成总结报告

  • false:不生成总结报告

表7 total_task_status

参数

参数类型

描述

success

Long

参数解释:

成功任务数。

取值范围:

不涉及。

partial_success

Long

参数解释:

部分成功任务数。

取值范围:

不涉及。

running

Long

参数解释:

运行中任务数。

取值范围:

不涉及。

pending

Long

参数解释:

待执行任务数。

取值范围:

不涉及。

failed

Long

参数解释:

失败任务数。

取值范围:

不涉及。

stopped

Long

参数解释:

已停止任务数。

取值范围:

不涉及。

状态码:400

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

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

取值范围:

业务异常编码字符串。

error_msg

String

参数解释:

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

取值范围:

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

encoded_authorization_message

String

参数解释:

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

取值范围:

Base64编码的字符串。

details

Array of OpsErrorDetail objects

参数解释:

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

取值范围:

不涉及。

request_id

String

参数解释:

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

取值范围:

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

表9 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"
      } ],
      "runtime_config" : {
        "agent_call_timeout_minutes" : 15
      }
    } ],
    "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" : "评估对象不存在",
  "encoded_authorization_message" : "",
  "details" : [ {
    "error_code" : "AgentArts.03400003",
    "error_msg" : "评估对象不存在"
  } ],
  "request_id" : "a3f5e2b1-4c6d-4e8f-9a2b-1c3d5e7f9a2b"
}

状态码

状态码

描述

200

请求成功

400

请求错误

错误码

请参见错误码。

相关文档