文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 评测集管理/ 获取评测集导入任务列表 - ListOpsDatasetItemsImportTasks
更新时间:2026-04-15 GMT+08:00
分享

获取评测集导入任务列表 - ListOpsDatasetItemsImportTasks

功能介绍

该接口用于分页查询指定评测集下所有异步导入任务的执行状态、实时进度及详细统计信息,支持通过任务ID进行精确过滤。

适用场景:

  • 进度查看:在提交大规模数据导入请求后,实时跟踪任务的完成百分比与当前处理状态。

  • 历史追溯:复盘评测集内容的来源、导入时间及各批次任务的执行结果。

URI

GET /v1/ops/datasets/{dataset_id}/items/import/tasks

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

String

参数解释:

评测集的ID。

约束限制:

由英文、数字、“-”、“_”组成,长度为1到64个字符。

取值范围:

1-64位字符。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

task_id

String

参数解释:

导入任务的唯一标识符(ID)。通过此参数可以筛选出特定导入任务产生的评测集记录。

约束限制:

长度为0到100个字符。

取值范围:

0到100字符。

默认取值:

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

import_tasks

Array of OpsImportTaskOutput objects

参数解释:

包含多个导入任务详细执行状态的集合。

取值范围:

符合 OpsImportTaskOutput 结构的对象数组。

表5 OpsImportTaskOutput

参数

参数类型

描述

task_id

String

参数解释:

导入任务的唯一标识符。

约束限制:

固定长度 36 字符的 UUID格式。

取值范围:

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

默认取值:

不涉及。

status

String

参数解释:

导入任务的当前运行状态。

约束限制:

字符串格式。

取值范围:

  • PENDING: 等待中

  • RUNNING: 运行中

  • SUCCESS: 成功

  • FAILED: 失败

默认取值:

PENDING。

progress

String

参数解释:

任务执行的百分比进度。

约束限制:

带百分号的字符串格式。

取值范围:

0/ %到 100%。

默认取值:

0%。

success_count

String

参数解释:

导入成功的条目数量。

约束限制:

数字字符串。

取值范围:

大于等于 0 的整数字符串。

默认取值:

"0"。

total_count

String

参数解释:

本次导入任务涉及的总数据条目数量。

约束限制:

数字字符串。

取值范围:

大于等于 0 的整数字符串。

默认取值:

"0"。

error_detail

String

参数解释:

当任务状态为 FAILED 时,记录的详细错误信息或异常堆栈。

约束限制:

最大长度10000字符。

取值范围:

任意描述性字符串。

默认取值:

空字符串。

created_at

String

参数解释:

导入任务的发起时间。

约束限制:

符合 ISO 8601 标准的时间戳。

取值范围:

UTC时间格式字符串。

默认取值:

不涉及。

请求示例

查询指定评测集下所有异步导入任务

GET https://*.com/agentarts/v1/ops/datasets/52bf21f819-6f91-4568-9f2f-57ef956/items/import/tasks

响应示例

状态码:200

返回查询指定评测集下所有异步导入任务

{
  "import_tasks" : [ {
    "task_id" : "550e8400-e29b-41d4-a716-446655440001",
    "status" : "RUNNING",
    "progress" : "50%",
    "success_count" : "10",
    "total_count" : "1",
    "error_detail" : "error",
    "created_at" : "2024-01-15T10:30:00Z"
  } ]
}

状态码

状态码

描述

200

返回查询指定评测集下所有异步导入任务

错误码

请参见错误码

相关文档