# 导入结果到评测集 - ImportOpsResults #### 功能介绍 将条目导入到目标评测集，支持导入到现有评测集或创建新评测集。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:dataset:importOpsResults | Write | dataset \* | g:ResourceTag/\ | - | - | #### 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。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表2OpsImportResultsSchemaMapping | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 返回导入成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。