j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ / / 更新评测集条目 - updateopsdatasetitem
更新时间：2026-07-17 gmt 08:00
查看pdf

更新评测集条目 -j9九游会登录

功能介绍

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

适用场景：

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

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

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:updateopsdatasetitem

write

dataset *

g:resourcetag/

-

-

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 请求body参数

参数

是否必选

参数类型

描述

turns

是

array of opsturninput objects

参数解释：

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

约束限制：

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

取值范围：

符合 opsturninput 结构的对象数组。

默认取值：

不涉及。
表3 opsturninput

参数

是否必选

参数类型

描述

fields

是

array of opsfieldvalueinput objects

参数解释：

当前轮次中包含的具体数据字段（如input、output、rationale 等）集合。

约束限制：

包含0到10000个字段项。

取值范围：

参考opsfieldvalueinput定义。

默认取值：

不涉及。
表4 opsfieldvalueinput

参数

是否必选

参数类型

描述

key

否

string

参数解释：

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

约束限制：

字符串长度为0到10000个字符。

取值范围：

符合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://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

更新成功

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

状态码

状态码

描述

200

更新成功

错误码

请参见错误码。

父主题：

相关文档

网站地图