更新时间：2026-09-02 GMT+08:00

获取评测集条目详情 - ShowOpsDatasetItem

功能介绍

该接口用于精确获取评测集中某一行特定数据条目的完整内容，通过评测集ID与条目ID的双重定位。

适用场景：

单条样本核对：在对模型评测结果产生疑问时，调取对应原始数据条目的全量信息进行比对。
数据编辑回显：在用户进入单条数据编辑界面前，通过此接口加载该条目的当前配置与字段内容。

调用方法

请参见如何调用API。

授权信息

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
agentarts:dataset:showOpsDatasetItem	Read	dataset *	g:ResourceTag/<tag-key>	-	-

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
dataset_id	是	String	参数解释：评测集的唯一标识符（ID）。可通过调用创建评测集接口获取，或通过查询评测集列表接口获取。约束限制：不涉及。取值范围：由英文、数字、连字符(-)、下划线(_)组成的1~64个字符串。默认取值：无。
item_id	是	String	参数解释：评测集条目的ID。可通过调用批量添加评测集条目接口获取，或通过查询评测集条目列表接口获取。约束限制：由英文、数字、“-”、“”组成，长度为1到64个字符。取值范围：* 由英文、数字、连字符(-)、下划线()组成的1-64位字符串。默认取值：* 不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
id	String	参数解释：字段值的唯一标识。取值范围：不涉及。
turns	Array of OpsTurn objects	参数解释：包含该条目具体业务内容的轮次数据列表，支持多轮对话格式，列表元素为OpsTurn对象，参考OpsTurn结构定义。
created_at	String	参数解释：该条目被首次创建的时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。取值范围：不涉及。
updated_at	String	参数解释：该条目最后一次被修改的时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。取值范围：不涉及。

表3 OpsTurn
参数	参数类型	描述
fields	Map<String,OpsFieldValue>	参数解释：该轮次中具体字段的键值对集合。Key为字段名称（String类型），Value为字段值（OpsFieldValue类型，参考OpsFieldValue定义）。

表4 OpsFieldValue
参数	参数类型	描述
id	String	参数解释：字段值的唯一标识。取值范围：不涉及。
key	String	参数解释：字段名。取值范围：不涉及。
type	String	参数解释：字段的数据类型。取值范围：不涉及。
content_type	String	参数解释：内容展示类型。取值范围：不涉及。
value	Object	参数解释：字段承载的实际业务数据，具体数据类型和格式根据type字段确定。
required	Boolean	参数解释：字段是否必填标识。取值范围： true：必填字段 false：选填字段

请求示例

查看评测集下某一条具体的数据项

GET https://api.example.com/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items/69db711057456f5c7d422aa9

响应示例

状态码：200

查询成功

{
  "id" : "69db711057456f5c7d422aa9",
  "turns" : [ {
    "fields" : {
      "input" : {
        "id" : "field_001",
        "key" : "input",
        "type" : "String",
        "content_type" : "text",
        "value" : "中国首都是哪里",
        "required" : true
      },
      "reference_output" : {
        "id" : "field_002",
        "key" : "reference_output",
        "type" : "String",
        "content_type" : "text",
        "value" : "北京",
        "required" : false
      }
    }
  } ],
  "created_at" : "2026-04-12T10:16:48.837Z",
  "updated_at" : "2026-04-12T10:16:48.837Z"
}

状态码

状态码	描述
200	查询成功

错误码

请参见错误码。

父主题： 评测集管理