更新评测集条目 - UpdateOpsDatasetItem
功能介绍
该接口用于对指定评测集草稿版本中已存在的特定数据行进行修改,确保条目内容符合Schema结构校验。
适用场景:
URI
PUT /v1/ops/datasets/{dataset_id}/items/{item_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
dataset_id |
是 |
String |
参数解释: 评测集的ID。 约束限制: 由英文、数字、“-”、“_”组成,长度为1到64个字符。 取值范围: 1-64位字符。 默认取值: 不涉及。 |
|
item_id |
是 |
String |
参数解释: 评测集条目的ID。 约束限制: 由英文、数字、“-”、“_”组成,长度为1到64个字符。 取值范围: 1-64位字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
turns |
是 |
Array of OpsTurnInput objects |
参数解释: 待更新的多轮对话或业务数据内容。 约束限制: 必填参数;数组长度限制 1 到 10000。 取值范围: 符合 OpsTurnInput 结构的对象数组。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
fields |
是 |
Array of OpsFieldValueInput objects |
参数解释: 当前轮次中包含的具体数据字段(如Input、Output、Rationale 等)集合。 约束限制: 包含0到10000个字段项。 取值范围: 参考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 |
更新成功 |
错误码
请参见错误码。