文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评测集管理/ 导入结果到评测集 - ImportOpsResults
更新时间:2026-09-02 GMT+08:00
分享

导入结果到评测集 - ImportOpsResults

功能介绍

将条目导入到目标评测集,支持导入到现有评测集或创建新评测集。

调用方法

请参见如何调用API

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:dataset:importOpsResults

Write

dataset *

g:ResourceTag/<tag-key>

-

-

URI

POST /v1/ops/datasets/import

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

type

String

参数解释:

指定导入来源的任务类型。

约束限制:

不涉及。

取值范围:

字符长度1-100,evaluation-task(评测记录),datasets-synthesis(合成样本)。

默认取值:

不涉及。

dataset_id

String

参数解释:

目标评测集的唯一标识符。为空时将触发创建新评测集。通过数据集列表接口获取。

约束限制:

不涉及。

取值范围:

由英文字母、数字及连字符(-)、下划线(_)组成的1~64个字符的字符串。

默认取值:

不涉及。

task_id

String

参数解释:

待导入数据所属的源任务ID。通过查询任务列表接口获取。

约束限制:

不涉及。

取值范围:

由英文字母、数字及连字符(-)、下划线(_)组成的1~64个字符的字符串。

默认取值:

不涉及。

dataset_name

String

参数解释:

当 dataset_id 为空时,定义新建评测集的名称。

约束限制:

仅在dataset_id为空时生效。

取值范围:

只能由中文字符、英文字母、数字及「_」、「-」、「.」组成,长度2~100个字符。

默认取值:

不涉及。

dataset_description

String

参数解释:

为新建评测集提供的详细功能或内容描述。

约束限制:

不涉及。

取值范围:

任意字符组成的0~400个字符的字符串。

默认取值:

不涉及。

is_published

Boolean

参数解释:

是否在导入完成后自动发布为一个正式版本。

约束限制:

不涉及。

取值范围:

  • true:自动发布为正式版本

  • false:存入草稿

默认取值:

false。

overwrite

Boolean

参数解释:

当目标评测集已存在数据时,是否清空原有数据再执行导入。

约束限制:

不涉及。

取值范围:

  • true:全量覆盖

  • false:增量追加

默认取值:

false。

schema_mapping

Array of OpsImportResultsSchemaMapping objects

参数解释:

字段映射规则列表,定义源字段如何对应到目标评测集字段。数组内的元素为OpsImportResultsSchemaMapping对象,包含source(源字段键名)、target(目标字段键名)、type(字段数据类型)三个属性。

约束限制:

数组长度1-100。

取值范围:

不涉及。

默认取值:

不涉及。

ids

Array of strings

参数解释:

需要执行导入操作的具体条目ID列表,通过数据集列表接口获取。数组内的元素为String类型,长度为1~64个字符,表示单条数据项的唯一标识符。

约束限制:

数组长度1-500。

取值范围:

不涉及。

默认取值:

不涉及。

表2 OpsImportResultsSchemaMapping

参数

是否必选

参数类型

描述

source

String

参数解释:

源任务结果中的原始字段键名。

约束限制:

不涉及。

取值范围:

由英文字母、数字及下划线(_)组成的1~255个字符的字符串。

默认取值:

不涉及。

target

String

参数解释:

目标评测集定义的字段键名。通过查看目标评测集的字段定义获取。

约束限制:

不涉及。

取值范围:

由英文字母、数字及下划线(_)组成的1~255个字符的字符串。

默认取值:

不涉及。

type

String

参数解释:

字段的数据类型,确保数据校验准确性。

约束限制:

不涉及。

取值范围:

  • String:字符串类型

  • Integer:整数类型

  • Float:浮点数类型

  • Boolean:布尔值类型

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

dataset_id

String

参数解释:

数据导入完成后承载结果的目标评测集ID。

取值范围:

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

请求示例

将条目导入到目标评测集

POST https://api.example.com/v1/ops/datasets/import

{
  "dataset_id" : "3ae5941c-8a14-4928-943f-46c37a820abd",
  "dataset_name" : "测试",
  "dataset_description" : "测试",
  "is_published" : true,
  "overwrite" : false,
  "schema_mapping" : [ {
    "source" : "trace_input",
    "target" : "input",
    "type" : "Integer"
  }, {
    "source" : "trace_output",
    "target" : "reference_output",
    "type" : "Integer"
  } ],
  "type" : "evaluation-task",
  "task_id" : "e6c51b19-5977-4dcd-aaba-edb09535586b",
  "ids" : [ "22e272540fb48c82f013122c7d60b151" ]
}

响应示例

状态码:200

返回导入成功

{
  "dataset_id" : "3ae5941c-8a14-4928-943f-46c37a820abd"
}

状态码

状态码

描述

200

返回导入成功

错误码

请参见错误码

相关文档