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

获取评测集条目列表 - ListOpsDatasetItems

功能介绍

该接口用于分页检索指定评测集的具体数据记录,支持查看当前草稿态数据或特定历史发布版本的数据样本。

适用场景:

  • 内容预览:在评测集详情页分页展示具体的数据行,供用户直观核查数据质量。

  • 版本溯源:通过指定版本ID,检索并对比历史发布版本中的样本数据。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

String

参数解释:

评测集的ID。

约束限制:

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

取值范围:

1-64位字符。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回,常与 limit参数配合实现分页功能。

约束限制:

必须为整数,且大小在0到10,000 之间。

取值范围:

0-10000。

默认取值:

0。

limit

Integer

参数解释:

单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。

约束限制:

必须为整数,且大小在1到100之间。

取值范围:

1-100。

默认取值:

10。

version_id

String

参数解释:

评测集的版本标识符。用于指定查询特定历史版本下的数据条目。

约束限制:

字符串长度限制为0到100个字符。

取值范围:

有效的版本ID字符串。

默认取值:

若为空,默认指向当前的草稿版本(Draft)。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

items

Array of OpsItemDetail objects

参数解释:

当前分页返回的数据条目详细内容列表。

取值范围:

参考OpsItemDetail 结构。

total

Long

参数解释:

评测集中满足查询条件的记录总数。

取值范围:

0到2147483647。

表5 OpsItemDetail

参数

参数类型

描述

id

String

参数解释:

数据条目的唯一标识符。

取值范围:

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

turns

Array of OpsTurn objects

参数解释:

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

取值范围:

符合OpsTurn定义的对象数组。

created_at

String

参数解释:

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

取值范围:

UTC 时间字符串。

updated_at

String

参数解释:

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

取值范围:

UTC 时间字符串。

表6 OpsTurn

参数

参数类型

描述

fields

Map<String,OpsFieldValue>

参数解释:

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

取值范围:

Map 结构,Value 参考OpsFieldValue定义。

表7 OpsFieldValue

参数

参数类型

描述

type

String

参数解释:

字段的数据类型。

取值范围:

如 string, integer, float 等。

content_type

String

参数解释:

内容展示类型。

取值范围:

如 text, markdown, image 等。

value

AnyType

参数解释:

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

取值范围:

不涉及。

请求示例

分页查看评测集 "8a77718d..." 中的数据项,包含具体的输入问题和参考答案。

https://*.com/agentarts/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items?offset=0&limit=100

响应示例

状态码:200

查询成功

{
  "total" : 1,
  "items" : [ {
    "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:48Z",
    "updated_at" : "2026-04-12T10:16:48Z"
  } ]
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档