获取评测集条目列表 - ListOpsDatasetItems
功能介绍
该接口用于分页检索指定评测集的具体数据记录,支持查看当前草稿态数据或特定历史发布版本的数据样本。
适用场景:
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:dataset:listOpsDatasetItems | List | dataset * | g:ResourceTag/<tag-key> | - | - |
URI
GET /v1/ops/datasets/{dataset_id}/items
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| dataset_id | 是 | String | 参数解释: 评测集的唯一标识符(ID)。可通过调用创建评测集接口获取,或通过查询评测集列表接口获取。 约束限制: 不涉及。 取值范围: 由英文字母、数字、连字符(-)、下划线(_)组成的1~64个字符的字符串。 默认取值: 无。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| version_id | 否 | String | 参数解释: 评测集的版本标识符(ID),用于指定查询特定历史版本下的数据条目。获取方式:可通过调用发布评测集版本接口返回的ID获取,或通过查询评测集版本列表接口获取。 约束限制: 不涉及。 取值范围: 由英文字母、数字、连字符(-)、下划线(_)组成的0~100个字符的字符串。 默认取值: 若为空,默认指向当前的草稿版本(Draft)。 |
| offset | 否 | Integer | 参数解释: 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回,常与 limit参数配合实现分页功能。 约束限制: 与limit参数配合使用实现分页查询。 取值范围: 0~10000。 默认取值: 0。 |
| limit | 否 | Integer | 参数解释: 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 约束限制: 与offset参数配合使用实现分页查询。 取值范围: 1-100。 默认取值: 100。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| items | Array of OpsItemDetail objects | 参数解释: 当前分页返回的数据条目详细内容列表。列表元素为OpsItemDetail对象,参考OpsItemDetail结构定义。 |
| total | Long | 参数解释: 评测集中满足查询条件的记录总数。 取值范围: 由数字组成, 0~2147483647。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| turn_id | String | 参数解释: 轮次的唯一标识符。 取值范围: 不涉及。 |
| fields | Array of OpsFieldValue objects | 参数解释: 该轮次中具体字段的列表。数组元素为OpsFieldValue对象(参考OpsFieldValue定义),包含字段ID、名称、类型、内容类型、是否必填及实际值。 |
请求示例
分页查看评测集 "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" : [ {
"turn_id" : "1abdb9e1-f83c-4263-ab3f-72ea117fd860",
"fields" : [ {
"id" : "550e8400-e29b-41d4-a716-446655440000",
"key" : "input",
"type" : "String",
"content_type" : "text",
"value" : "中国首都是哪里",
"required" : true
}, {
"id" : "550e8400-e29b-41d4-a716-446655440005",
"key" : "reference_output",
"type" : "String",
"content_type" : "text",
"value" : "北京",
"required" : false
} ]
} ],
"created_at" : "2026-04-12T10:16:48Z",
"updated_at" : "2026-04-12T10:16:48Z"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。