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

评测集导入 - ImportOpsDatasetItems

功能介绍

该接口用于从本地文件或历史版本中将海量数据批量导入至指定评测集的草稿版本中,支持多种格式解析及灵活的写入模式。

适用场景:

  • 评测集同步:将存储在OBS(对象存储服务)中的海量生产数据或标注数据自动化同步至评测系统。

  • 评测集更替:利用全量覆盖模式(Overwrite),一键重置当前草稿版本的数据内容。

URI

POST /v1/ops/datasets/{dataset_id}/items/import

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

String

参数解释:

评测集的ID。

约束限制:

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

取值范围:

1-64位字符。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

source_version_id

String

参数解释:

源版本ID。用于指定在数据还原或复制操作中作为参考的基础版本。

约束限制:

长度为0到100个字符。

取值范围:

0到100字符。

默认取值:

不涉及。

overwrite

Boolean

参数解释:

覆盖模式开关。决定在导入新数据前是否清空草稿版本中的现有数据。

约束限制:

不涉及。

取值范围:

  • true: 覆盖模式,执行清空操作。

  • false: 追加模式,保留现有数据。

默认取值:

false。

get_obs_url

Boolean

参数解释:

获取OBS预签名URL标识。用于确定是否需要系统生成并返回用于大文件直传的临时上传链接。

约束限制:

仅在不使用 multipart/form-data 模式时启用。

取值范围:

true, false。

默认取值:

false。

obs_object_name

String

参数解释:

OBS对象名称。指定待导入文件在对象存储(OBS)中的完整存储路径或文件名。

约束限制:

字符串长度限制为0到10000个字符。

取值范围:

0到10000 字符。

默认取值:

不涉及。

obs_file_hash

String

参数解释:

文件哈希值(SHA-256)。用于在服务端进行文件完整性校验,确保上传过程中数据未损坏或被篡改。

约束限制:

十六进制字符串,最大长度 256 个字符。

取值范围:

0到256字符。

默认取值:

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

import_task_id

String

参数解释:

系统为本次导入操作生成的异步任务唯一标识符。

取值范围:

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

obs_url

String

参数解释:

用于将本地数据文件直接上传至对象存储(OBS)的预签名 URL 地址。

取值范围:

合法的 HTTP/HTTPS 协议 URL 字符串。

请求示例

数据批量导入至指定评测集的草稿版本

POST https://*.com/agentarts/v1/ops/datasets/7452bf21f819-6f91-4568-9f2f-57ef9562ab7/items/import





响应示例

状态码:200

导入任务下发成功

{
  "import_task_id" : "550e8400-e29b-41d4-a716-446655440001",
  "obs_url" : "http://obs.cn-north-7.ulanqab.huawei.com/doc"
}

状态码

状态码

描述

200

导入任务下发成功

错误码

请参见错误码

相关文档