# 查询合成的条目列表 - ListOpsSynthesisItems
#### 功能介绍
该接口用于分页查询特定合成任务所生成的详细条目数据，支持在任务运行中和检索样本内容。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。
| 授权项                                     | 访问级别 | 资源类型（\*为必须） | 条件键                       | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| agentarts:dataset:listOpsSynthesisItems | List | dataset \*  | g:ResourceTag/\<tag-key\> | -  | -      |
   
#### URI
GET /v1/ops/datasets-synthesis/{synthesis_id}/items
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| synthesis_id | 是    | String | **参数解释：** 合成任务的唯一标识符（ID），该参数用于在路径中指定特定的合成任务，以便执行查询、停止或删除等操作。通过创建评测集合成任务接口返回获取，或通过查询评测集合成任务列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及连字符组成，长度为1\~64个字符。 **默认取值：** 不涉及。 |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| offset | 否    | Integer | **参数解释：** 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与 limit参数配合实现分页功能。 **约束限制：** 与limit参数配合使用实现分页查询。 **取值范围：** 0\~10000。 **默认取值：** 0。 |
| limit  | 否    | Integer | **参数解释：** 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 **约束限制：** 与offset参数配合使用实现分页查询。 **取值范围：** 1\~100。 **默认取值：** 10。                  |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数    | 参数类型                                                                                   | 描述                                                                                                                  |
|:---|:---|:---|
| items | Array of [OpsSynthesisItem] objects | **参数解释：** 单个对话记录对象。**取值范围：** 不涉及。 |
   
 表4OpsSynthesisItem 
| 参数         | 参数类型                                                                                           | 描述                                                                                                                        |
|:---|:---|:---|
| id         | String                                                                                         | **参数解释：** 对话的唯一标识符。**取值范围：** 不涉及。       |
| turns      | Array of [OpsSynthesisItemTurn] objects | **参数解释：** 对话轮次列表。**取值范围：** 不涉及。         |
| created_at | String                                                                                         | **参数解释：** 对话创建时间。**取值范围：** ISO 8601 格式。 |
   
 表5OpsSynthesisItemTurn 
| 参数      | 参数类型                                                                                                     | 描述                                                                                                                    |
|:---|:---|:---|
| turn_id | String                                                                                                   | **参数解释：** 轮次的唯一标识符。**取值范围：** 不涉及。   |
| fields  | Array of [OpsSynthesisItemTurnField] objects | **参数解释：** 该轮次中的字段键值对。**取值范围：** 不涉及。 |
   
 表6OpsSynthesisItemTurnField 
| 参数    | 参数类型   | 描述                                                                                                                                               |
|:---|:---|:---|
| key   | String | **参数解释：** 字段的键名，如 input、output、reference_output。**取值范围：** 不涉及。 |
| value | String | **参数解释：** 字段的值，如用户问题、模型输出等。**取值范围：** 不涉及。                      |
   
#### 请求示例
查询特定合成任务所生成的详细条目数据
```
GET https://api.example.com/v1/ops/datasets-synthesis/67452bf21f819-6f91-4568-9f2f-57ef9562ab7/items
```
#### 响应示例
**状态码：200**
返回查询成功
```
{
  "items" : [ {
    "id" : "6a75430a8ddbc9705d983b52",
    "turns" : [ {
      "turn_id" : "1abdb9e1-f83c-4263-ab3f-72ea117fd860",
      "fields" : [ {
        "key" : "reference_output",
        "value" : "美苏太空竞赛具有诸多重要特征,这些特征不仅产生了持久影响,更在科技竞争和国际政治领域持续发挥着重要作用.其中最显著的特征之一是用超级大国对抗推动航天技术突破,为人类进入太空铺平道路.另一关键特征是形成了以卫星侦察、洲际导弹和载人航天为核心的军事科技体系,对国防战略和情报收集产生了深远影响.此外,太空竞赛催生了大量民用技术转化,推动通信、气象和导航卫星在全球范围的普及.最后,太空竞赛成为意识形态博弈的重大转折点,它通过首次登月、空间站建设以及国际合作与竞争并存,标志着科技实力作为国家威望核心指标的新时代."
      }, {
        "key" : "output",
        "value" : "美苏太空竞赛具有诸多重要特征,这些特征不仅产生了持久影响,更在科技竞争和国际政治领域持续发挥着重要作用.其中最显著的特征之一是用超级大国对抗推动航天技术突破,为人类进入太空铺平道路.另一关键特征是形成了以卫星侦察、洲际导弹和载人航天为核心的军事科技体系,对国防战略和情报收集产生了深远影响.此外,太空竞赛催生了大量民用技术转化,推动通信、气象和导航卫星在全球范围的普及.最后,太空竞赛成为意识形态博弈的重大转折点,它通过首次登月、空间站建设以及国际合作与竞争并存,标志着科技实力作为国家威望核心指标的新时代."
      }, {
        "key" : "input",
        "value" : "冷战时期的美苏太空竞赛有哪些关键特征使其在科技竞争和国际政治领域产生持续影响?"
      } ]
    } ],
    "created_at" : "2026-08-07T02:29:30.459Z"
  } ]
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 返回查询成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。