# 更新评测集条目 - UpdateOpsDatasetItem #### 功能介绍 该接口用于对指定评测集草稿版本中已存在的特定数据行进行修改，确保条目内容符合Schema结构校验。 适用场景： - 样本内容完善：针对多轮对话或复杂数据集，补充缺失的字段信息或优化对话轮次逻辑。 - 业务数值更新：当底层业务逻辑变化导致原有的评测基准数据失效时，手动更新特定条目的预期输出。 #### 调用方法 请参见[如何调用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:updateOpsDatasetItem | Write | dataset \* | g:ResourceTag/\ | - | - | #### URI PUT /v1/ops/datasets/{dataset_id}/items/{item_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | **参数解释：** 评测集的唯一标识符（ID）。可通过调用创建评测集接口获取，或通过查询评测集列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 由英文、数字、连字符(-)、下划线(_)组成的1\~64个字符串。 **默认取值：** 无。 | | item_id | 是 | String | **参数解释：** 评测集条目的ID。可通过调用批量添加评测集条目接口获取，或通过查询评测集条目列表接口获取。 **约束限制：** 由英文、数字、"-"、"*"组成，长度为1到64个字符。 **取值范围：** 由英文、数字、连字符(-)、下划线(*)组成的1-64位字符串。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | turns | 是 | Array of [OpsTurnInput] objects | **参数解释：** 待更新的多轮对话或业务数据内容。列表元素为OpsTurnInput对象，参考OpsTurnInput结构定义。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表3OpsTurnInput | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | fields | 是 | Array of [OpsFieldValueInput] objects | **参数解释：** 当前轮次中包含的具体数据字段（如Input、Output、Rationale 等）集合。列表元素为OpsFieldValueInput对象，参考OpsFieldValueInput结构定义。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表4OpsFieldValueInput | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 否 | String | **参数解释：** 字段的键名，需与评测集Schema中定义的字段名保持一致。 **约束限制：** 不涉及。 **取值范围：** 需与评测集Schema中定义的字段名一致，长度为0\~10000个字符。 **默认取值：** 不涉及。 | | type | 否 | String | **参数解释：** 字段的数据存储类型，决定系统底层解析逻辑。 **约束限制：** 不涉及。 **取值范围：** - string：字符串类型 - integer：整数类型 - float：浮点数类型 - boolean：布尔值类型 - object：对象类型 **默认取值：** 不涉及。 | | content_type | 否 | String | **参数解释：** 字段的内容表现形式，用于前端渲染或后端逻辑识别。 **约束限制：** 不涉及。 **取值范围：** - text：纯文本 - markdown：Markdown格式文本 - image_url：图片URL - file_path：文件路径 **默认取值：** text。 | | value | 否 | String | **参数解释：** 字段承载的实际业务数据值。 **约束限制：** 不涉及。 **取值范围：** 根据type定义，需符合对应解析要求，长度为0\~10000个字符。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | item_id | String | **参数解释：** 更新特定数据条目的id。 **取值范围：** 不涉及。 | #### 请求示例 编辑某一条数据项的内容，成功后返回该数据项的ID ``` PUT https://api.example.com/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items/69db711057456f5c7d422aa9 { "turns" : [ { "fields" : [ { "key" : "question", "type" : "string", "content_type" : "text", "value" : "更新后的问题内容" }, { "key" : "expected_answer", "type" : "string", "content_type" : "text", "value" : "更新后的期望答案" } ] } ] } ``` #### 响应示例 **状态码：200** 更新成功 ``` { "item_id" : "69db711057456f5c7d422aa9" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 更新成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。