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

更新评测集条目 - UpdateOpsDatasetItem

功能介绍

该接口用于对指定评测集草稿版本中已存在的特定数据行进行修改,确保条目内容符合Schema结构校验。

适用场景:

  • 样本内容完善:针对多轮对话或复杂数据集,补充缺失的字段信息或优化对话轮次逻辑。

  • 业务数值更新:当底层业务逻辑变化导致原有的评测基准数据失效时,手动更新特定条目的预期输出。

URI

PUT /v1/ops/datasets/{dataset_id}/items/{item_id}

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

String

参数解释:

评测集的ID。

约束限制:

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

取值范围:

1-64位字符。

默认取值:

不涉及。

item_id

String

参数解释:

评测集条目的ID。

约束限制:

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

取值范围:

1-64位字符。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

turns

Array of OpsTurnInput objects

参数解释:

待更新的多轮对话或业务数据内容。

约束限制:

必填参数;数组长度限制 1 到 10000。

取值范围:

符合 OpsTurnInput 结构的对象数组。

默认取值:

不涉及。

表4 OpsTurnInput

参数

是否必选

参数类型

描述

fields

Array of OpsFieldValueInput objects

参数解释:

当前轮次中包含的具体数据字段(如Input、Output、Rationale 等)集合。

约束限制:

包含0到10000个字段项。

取值范围:

参考OpsFieldValueInput定义。

默认取值:

不涉及。

表5 OpsFieldValueInput

参数

是否必选

参数类型

描述

key

String

参数解释:

字段的键名,需与评测集Schema中定义的字段名保持一致。

约束限制:

0到100。

取值范围:

符合Schema定义的Key字符串。

默认取值:

不涉及。

type

String

参数解释:

字段的数据存储类型,决定系统底层解析逻辑。

约束限制:

长度 0到10000字符。

取值范围:

常见值如 string, integer, float, boolean, object 等。

默认取值:

不涉及。

content_type

String

参数解释:

字段的内容表现形式,用于前端渲染或后端逻辑识别。

约束限制:

长度 0到10000字符。

取值范围:

常见值如 text, markdown, image_url, file_path 等。

默认取值:

text。

value

String

参数解释:

字段承载的实际业务数据值。

约束限制:

长度 0到10000字符。

取值范围:

根据type定义,需符合对应的解析要求。

默认取值:

不涉及。

响应参数

状态码:200

更新成功

请求示例

编辑某一条数据项的内容,成功后返回该数据项的ID

https://*.com/agentarts/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

更新成功

{
  "body" : {
    "item_id" : "69db711057456f5c7d422aa9"
  }
}

状态码

状态码

描述

200

更新成功

错误码

请参见错误码

相关文档