# 查询评测集合成任务列表 - ListOpsSynthesisTasks #### 功能介绍 该接口用于分页查询当前租户下所有已提交的评测集合成异步任务，支持按任务名称、状态等多种过滤条件进行检索，提供任务执行进度。 适用场景： - 任务进度查看：在发起大规模数据合成后，通过此接口批量获取任务的运行状态（如：进行中、已完成、已失败）。 - 历史合成记录管理：复盘并管理过往提交的数据生成任务，审计合成任务的执行频率与成功率。 #### 调用方法 请参见[如何调用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:listOpsSynthesisTasks | List | dataset \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/datasets-synthesis 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | status | 否 | String | **参数解释：** 任务状态过滤条件。用于筛选处于特定生命周期阶段的合成任务。 **约束限制：** 不涉及。 **取值范围：** - *pending*: 等待中 - *running*: 运行中 - *completed*: 已完成 - *failed*: 失败 - *stopped*: 已停止 - *success*: 成功 - *partial_success*: 部分成功 **默认取值：** 不涉及。 | | name | 否 | String | **参数解释：** 任务名称检索字段。支持根据创建任务时自定义的名称进行筛选。 **约束限制：** 支持模糊匹配，字符串长度限制为0\~100个字符。 **取值范围：** 0到100字符。 **默认取值：** 不涉及。 | | offset | 否 | Integer | **参数解释：** 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与 limit参数配合实现分页功能。 **约束限制：** 必须为整数，且大小在0到10,000之间。 **取值范围：** 0-10000。 **默认取值：** 0。 | | limit | 否 | Integer | **参数解释：** 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 **约束限制：** 必须为整数，且大小在1到100之间。 **取值范围：** 1-100。 **默认取值：** 10。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | syntheses | Array of [OpsEvaluationSynthesisTaskSummary] objects | **参数解释：** 包含合成任务摘要信息的对象列表，参考OpsEvaluationSynthesisTaskSummary定义。 | | total | Integer | **参数解释：** 符合当前筛选条件的任务总记录数。 **取值范围：** 0-500。 | 表3OpsEvaluationSynthesisTaskSummary | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 合成任务的唯一标识符。 **取值范围：** UUID或系统生成的ID。 | | name | String | **参数解释：** 用户为合成任务定义的名称。 **取值范围：** 不涉及。 | | scenario_type | String | **参数解释：** 合成任务的技术场景类型。 **取值范围：** 不涉及。 | | scenario_name | String | **参数解释：** 场景的友好展示名称。 **取值范围：** 不涉及。 | | scenario_description | String | **参数解释：** 合成任务背景的详细描述。 **取值范围：** 不涉及。 | | stats | Array of [SynthesisTaskStats] objects | **参数解释：** 合成任务当前的生命周期状态。 **取值范围：** 不涉及 | | status | String | **参数解释：** 合成任务当前的生命周期状态。 **取值范围：** - pending：等待执行 - running：正在运行 - completed：已完成 - failed：执行失败 - stopped：已人工停止 - success：成功 - partial_success：部分成功 | | progress | Integer | **参数解释：** 当前合成进度百分比。 **取值范围：** 0-100。 | | sample_count | Integer | **参数解释：** 预设需要生成的总样本数量。 **取值范围：** 1-500。 | | generated_count | Integer | **参数解释：** 截至当前已生成的有效样本数。 **取值范围：** 0-500。 | | model_config | [OpsEvaluationModelConfig] object | **参数解释：** 任务使用的模型配置。 **取值范围：** 不涉及。 | | seed_data | [OpsEvaluationSeedDataConfig] object | **参数解释：** 任务使用的种子数据配置。 **取值范围：** 不涉及。 | | base_info | [OpsEvaluationTaskBaseInfo] object | **参数解释：** 任务基础元数据。 **取值范围：** 不涉及。 | 表4SynthesisTaskStats | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释：** 合成数据总条数。 **取值范围：** 0-10000。 | | change_uncommitted | Integer | **参数解释：** 标识当前草稿态相对于最新发布版本是否有尚未提交的变更。 **取值范围：** 0-10000。 | | success | Integer | **参数解释：** 合成数据success状态总条数。 **取值范围：** 0-10000。 | | failed | Integer | **参数解释：** 合成数据failed状态总条数。 **取值范围：** 0-10000。 | | running | Integer | **参数解释：** 合成数据running状态总条数。 **取值范围：** 0-10000。 | | pending | Integer | **参数解释：** 合成数据pending状态总条数。 **取值范围：** 0-10000。 | | progress | String | **参数解释：** 任务执行的百分比进度。 **取值范围：** 0%到100%。 | 表5OpsEvaluationModelConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | model_id | String | **参数解释：** 模型的唯一标识符。可通过调用获取模型列表接口获取。 **取值范围：** 不涉及。 | | model_name | String | **参数解释：** 模型的显示名称。 **取值范围：** 不涉及。 | | temperature | Float | **参数解释：** 采样温度参数，用于控制输出的随机性。数值低更聚焦，数值高更具创造性。 **取值范围：** 0.0\~2.0。 | | max_tokens | Integer | **参数解释：** 单次推理生成的最大Token数量限制，单位：个。 **取值范围：** 1\~32000。 | | top_p | Float | **参数解释：** 核采样参数，用于控制生成时考虑的概率分布范围，值越小生成内容越确定，值越大生成内容越多样。 **取值范围：** 0.0\~1.0。 | | frequency_penalty | Float | **参数解释：** 频率惩罚系数，降低内容重复倾向。 **取值范围：** -2.0\~2.0。 | 表6OpsEvaluationSeedDataConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释：** 种子数据的来源类型。 **取值范围：** - dataset：评测集 - file：文件 | | dataset_id | String | **参数解释：** 种子评测集的唯一ID。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | | dataset_name | String | **参数解释：** 种子评测集的展示名称。 **取值范围：** 不涉及。 | | dataset_version_id | String | **参数解释：** 种子评测集版本的内部唯一标识符。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | | dataset_version | String | **参数解释：** 种子评测集的可读版本号。由数字和点组成，格式为x.y.z。 **取值范围：** 不涉及。 | | file_name | String | **参数解释：** 作为种子源的临时文件名称。 **取值范围：** 不涉及。 | | obs_tmp_file_id | String | **参数解释：** 种子数据文件在对象存储中的路径。格式为bucketName/objectKey。 **取值范围：** 不涉及。 | 表7OpsEvaluationTaskBaseInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | created_at | String | **参数解释：** 任务在系统中创建的时间戳。格式为yyyy-MM-ddTHH:mm:ssZ（ISO 8601，UTC），示例：2024-01-15T08:30:00Z | | start_at | String | **参数解释：** 任务正式开始执行的精确时刻。格式为yyyy-MM-ddTHH:mm:ssZ（ISO 8601，UTC），示例：2024-01-15T08:30:00Z | | updated_at | String | **参数解释：** 任务状态或元数据最后一次变更的时间。格式为yyyy-MM-ddTHH:mm:ssZ（ISO 8601，UTC），示例：2024-01-15T08:30:00Z | | completed_at | String | **参数解释：** 任务执行完毕（无论成败）的时间。格式为yyyy-MM-ddTHH:mm:ssZ（ISO 8601，UTC），示例：2024-01-15T08:30:00Z | | duration_seconds | Long | **参数解释：** 任务的有效运行总时长，单位：秒。 **取值范围：** 非负整数。 | | created_by | [OpsUserInfoObj] object | **参数解释：** 创建该任务的用户详细信息，参考OpsUserInfoObj。 | | started_by | [OpsUserInfoObj] object | **参数解释：** 启动该任务的用户详细信息，参考OpsUserInfoObj。 | 表8OpsUserInfoObj | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 用户的显示名称。 **取值范围：** 任意字符串。 | | user_id | String | **参数解释：** 用户在账号系统中的唯一身份ID。 **取值范围：** 不涉及 | #### 请求示例 ``` GET https://api.example.com/v1/ops/datasets-synthesis ``` #### 响应示例 **状态码：200** 查询成功 ``` { "syntheses" : [ { "id" : "task_uuid", "name" : "task_uuid", "scenario_type" : "seed_data", "scenario_name" : "基于种子数据泛化", "scenario_description" : "基于现有100条React问答，生成50条更复杂的面试题", "status" : "running", "progress" : 65, "sample_count" : 50, "generated_count" : 33, "model_config" : { "model_id" : "1749615103", "model_name" : "豆包·1.6·自动深度思考", "temperature" : 0.1, "max_tokens" : 4096, "top_p" : 0.7, "frequency_penalty" : 0 }, "seed_data" : { "type" : "dataset", "dataset_id" : "c3c2571d-a8b0-4447-8b79-a67cac076768", "dataset_name" : "种子评测集名称", "dataset_version_id" : "c3c2571d-a8b0-4447-8b79-a67cac076768", "dataset_version" : "0.0.1", "file_name" : "seed.jsonl", "obs_tmp_file_id" : "obs:../path/to/seed.jsonl" }, "base_info" : { "created_at" : "2026-02-27T03:09:53.799Z", "start_at" : "2026-02-27T03:09:53.799Z", "updated_at" : "2026-02-27T03:09:53.799Z", "completed_at" : "2026-02-27T03:09:53.799Z", "duration_seconds" : 325, "created_by" : { "name" : "op_svc_modelartsversatile_container0", "user_id" : "6f80301edacc43728bf47b6a6484d512" }, "started_by" : { "name" : "op_svc_modelartsversatile_container0", "user_id" : "6f80301edacc43728bf47b6a6484d512" } } } ], "total" : 10 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。