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

获取评测集条目列表 - ListOpsDatasetItems

功能介绍

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

适用场景:

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

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

调用方法

请参见如何调用API

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:dataset:listOpsDatasetItems

List

dataset *

g:ResourceTag/<tag-key>

-

-

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

String

参数解释:

评测集的唯一标识符(ID)。可通过调用创建评测集接口获取,或通过查询评测集列表接口获取。

约束限制:

不涉及。

取值范围:

由英文、数字、连字符(-)、下划线(_)组成的1~64个字符串。

默认取值:

无。

表2 Query参数

参数

是否必选

参数类型

描述

version_id

String

参数解释:

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

约束限制:

不涉及。

取值范围:

由英文、数字、连字符(-)、下划线(_)组成的0~100个字符的字符串。

默认取值:

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

offset

Integer

参数解释:

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

约束限制:

与limit参数配合使用实现分页查询。

取值范围:

0~10000。

默认取值:

0。

limit

Integer

参数解释:

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

约束限制:

与offset参数配合使用实现分页查询。

取值范围:

1-100。

默认取值:

10。

is_published

Boolean

参数解释:

查询评测集是否发布。

约束限制:

不涉及。

取值范围:

  • true:已发布

  • false:未发布

默认取值:

false。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

items

Array of OpsItemDetail objects

参数解释:

当前分页返回的数据条目详细内容列表。列表元素为OpsItemDetail对象,参考OpsItemDetail结构定义。

total

Long

参数解释:

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

取值范围:

由数字组成, 0~2147483647。

表4 OpsItemDetail

参数

参数类型

描述

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。

取值范围:

不涉及。

表5 OpsTurn

参数

参数类型

描述

fields

Map<String,OpsFieldValue>

参数解释:

该轮次中具体字段的键值对集合。Key为字段名称(String类型),Value为字段值(OpsFieldValue类型,参考OpsFieldValue定义)。

表6 OpsFieldValue

参数

参数类型

描述

id

String

参数解释:

字段值的唯一标识。

取值范围:

不涉及。

key

String

参数解释:

字段名。

取值范围:

不涉及。

type

String

参数解释:

字段的数据类型。

取值范围:

不涉及。

content_type

String

参数解释:

内容展示类型。

取值范围:

不涉及。

value

Object

参数解释:

字段承载的实际业务数据,具体数据类型和格式根据type字段确定。

required

Boolean

参数解释:

字段是否必填标识。

取值范围:

  • true:必填字段

  • false:选填字段

请求示例

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

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

响应示例

状态码:200

查询成功

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

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档