文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 评测集管理/ 获取评测集条目详情 - ShowOpsDatasetItem
更新时间：2026-04-15 GMT+08:00
查看PDF
分享

获取评测集条目详情 - ShowOpsDatasetItem

功能介绍

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

适用场景：

  • 单条样本核对：在对模型评测结果产生疑问时，调取对应原始数据条目的全量信息进行比对。

  • 数据编辑回显：在用户进入单条数据编辑界面前，通过此接口加载该条目的当前配置与字段内容。

URI

GET /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对请求进行签名的过程中会自动填充该字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释：

数据条目的唯一标识符。

取值范围：

通常为符合 MongoDB ObjectID 规范的 24 位十六进制字符串。

turns

Array of OpsTurn objects

参数解释：

包含该条目具体业务内容的轮次数据列表，支持多轮对话格式。

取值范围：

符合OpsTurn定义的对象数组。

created_at

String

参数解释：

该条目被首次创建的时间。

取值范围：

UTC 时间字符串。

updated_at

String

参数解释：

该条目最后一次被修改的时间。

取值范围：

UTC 时间字符串。
表4 OpsTurn

参数

参数类型

描述

fields

Map<String,OpsFieldValue>

参数解释：

该轮次中具体字段的键值对集合。

取值范围：

Map 结构，Value 参考OpsFieldValue定义。
表5 OpsFieldValue

参数

参数类型

描述

type

String

参数解释：

字段的数据类型。

取值范围：

如 string, integer, float 等。

content_type

String

参数解释：

内容展示类型。

取值范围：

如 text, markdown, image 等。

value

AnyType

参数解释：

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

取值范围：

不涉及。

请求示例

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

https://*.com/agentarts/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items/69db711057456f5c7d422aa9

{
  "id" : "69db711057456f5c7d422aa9",
  "turns" : [ {
    "turn_id" : "4ae0dc64-e969-4bb8-8510-abba3509c511",
    "fields" : [ {
      "id" : "29f1fe93-8327-4077-bcf3-0039cf81dddb",
      "key" : "reference_output",
      "type" : "String",
      "content_type" : "text",
      "value" : "北京",
      "required" : false
    }, {
      "id" : "2470d5c8-28e6-4af6-b2cc-823391de43ed",
      "key" : "input",
      "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

查询成功

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

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

父主题： 评测集管理

相关文档