导入结果到评测集 - ImportOpsResults
功能介绍
将条目导入到目标评测集,支持导入到现有评测集或创建新评测集。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:dataset:importOpsResults | Write | dataset * | g:ResourceTag/<tag-key> | - | - |
URI
POST /v1/ops/datasets/import
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| type | 否 | String | 参数解释: 指定导入来源的任务类型。 约束限制: 枚举值。 取值范围: 字符长度1-100,evaluation-task(评测记录),datasets-synthesis(合成样本)。 默认取值: 不涉及。 |
| dataset_id | 否 | String | 参数解释: 目标评测集的唯一标识符。为空时将触发创建新评测集。 约束限制: 1-64个字符。 取值范围: 字符长度1-64,已存在的评测集ID。 默认取值: 不涉及。 |
| task_id | 否 | String | 参数解释: 待导入数据所属的源任务ID。 约束限制: 1-64个字符。 取值范围: 字符长度1-64,合法的任务ID。 默认取值: 不涉及。 |
| dataset_name | 否 | String | 参数解释: 当 dataset_id 为空时,定义新建评测集的名称。 约束限制: 2-100个字符。 取值范围: 任意字符串。 默认取值: 不涉及。 |
| dataset_description | 否 | String | 参数解释: 为新建评测集提供的详细功能或内容描述。 约束限制: 0-400个字符。 取值范围: 字符长度0-400,任意描述性文本。 默认取值: 不涉及。 |
| is_published | 否 | Boolean | 参数解释: 是否在导入完成后自动发布为一个正式版本。 约束限制: 布尔值。 取值范围: true(自动发布),false(存入草稿)。 默认取值: false。 |
| overwrite | 否 | Boolean | 参数解释: 当目标评测集已存在数据时,是否清空原有数据再执行导入。 约束限制: 布尔值。 取值范围: true(全量覆盖),false(增量追加)。 默认取值: false。 |
| schema_mapping | 否 | Array of schema_mapping objects | 参数解释: 字段映射规则列表,定义源字段如何对应到目标评测集字段。 约束限制: 数组长度1-100。 取值范围: 包含source, target, type的对象。 默认取值: 不涉及。 |
| ids | 否 | Array of strings | 参数解释: 需要执行导入操作的具体条目ID列表,通过数据集列表接口获取。 约束限制: 包含1-500个数据项ID。 取值范围: 每项1-64个字符。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| source | 是 | String | 参数解释: 源任务结果中的原始字段键名。 约束限制: 1-255个字符。 取值范围: 合法的字段键。 默认取值: 不涉及。 |
| target | 是 | String | 参数解释: 目标评测集定义的字段键名。 约束限制: 1-255个字符。 取值范围: 字符长度1-255,目标Schema定义的键。 默认取值: 不涉及。 |
| type | 是 | String | 参数解释: 字段的数据类型,确保数据校验准确性。 约束限制: 1-64个字符。 取值范围: 1-64个字符,String, Integer 等。 默认取值: 不涉及。 |
响应参数
状态码:200
返回导入成功
无
请求示例
将条目导入到目标评测集
POST https://*.com/agentarts/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" : ""
}, {
"source" : "trace_output",
"target" : "reference_output",
"type" : ""
} ],
"type" : "evaluation-task",
"task_id" : "e6c51b19-5977-4dcd-aaba-edb09535586b",
"ids" : [ "22e272540fb48c82f013122c7d60b151" ]
} 响应示例
状态码:200
返回导入成功
{
"body" : {
"dataset_id" : "3ae5941c-8a14-4928-943f-46c37a820abd"
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 返回导入成功 |
错误码
请参见错误码。