j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ / / 获取评测集导入任务列表 - listopsdatasetitemsimporttasks
更新时间：2026-07-17 gmt 08:00
查看pdf

获取评测集导入任务列表 -j9九游会登录

功能介绍

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

适用场景：

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

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

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:listopsdatasetitemsimporttasks

list

dataset *

g:resourcetag/

-

-

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个字符。

取值范围：

符合uuid标准的字符串。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表3 响应body参数

参数

参数类型

描述

import_tasks

array of opsimporttaskoutput objects

参数解释：

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

取值范围：

符合 opsimporttaskoutput 结构的对象数组。
表4 opsimporttaskoutput

参数

参数类型

描述

task_id

string

参数解释：

导入任务的唯一标识符。

取值范围：

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

status

string

参数解释：

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

取值范围：

  • pending: 等待中

  • running: 运行中

  • success: 成功

  • failed: 失败

progress

string

参数解释：

任务执行的百分比进度。

取值范围：

0%到100%。

success_count

string

参数解释：

导入成功的条目数量。

取值范围：

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

total_count

string

参数解释：

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

取值范围：

0-100的整数字符串。

error_detail

string

参数解释：

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

取值范围：

任意描述性字符串。

created_at

string

参数解释：

导入任务的发起时间。

取值范围：

utc时间格式字符串。

请求示例

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

get https://api.example.com/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" : "20",
    "error_detail" : "error",
    "created_at" : "2024-01-15t10:30:00z"
  } ]
}

状态码

状态码

描述

200

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

错误码

请参见错误码。

父主题：

相关文档

网站地图