# 查询评测集合成任务详情 - ShowOpsSynthesisTask #### 功能介绍 该接口用于通过任务ID检索特定评测集合成任务的完整信息，涵盖任务配置快照、实时执行状态及生成统计。 #### 调用方法 请参见[如何调用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:showOpsSynthesisTask | Read | dataset \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/datasets-synthesis/{synthesis_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | synthesis_id | 是 | String | **参数解释：** 合成任务的唯一标识符（ID），该参数用于在路径中指定特定的合成任务，以便执行查询、停止或删除等操作。可通过调用创建合成任务接口获取，或通过查询合成任务列表接口获取。 **约束限制：** 字符串长度限制为1到64个字符。通常采用标准 UUID格式。 **取值范围：** 1\~64个字符。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 合成任务的唯一标识符。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 用户为合成任务定义的描述性名称。 **取值范围：** 不涉及。 | | scenario_type | String | **参数解释：** 合成任务所属的技术场景分类标识。 **取值范围：** 不涉及。 | | scenario_name | String | **参数解释：** 合成场景的友好展示名称。 **取值范围：** 不涉及。 | | scenario_description | String | **参数解释：** 该合成任务具体业务逻辑或目标的详细说明。 **取值范围：** 不涉及。 | | status | String | **参数解释：** 合成任务当前的生命周期运行状态。 **取值范围：** 字符长度1-100，pending(等待执行)，running(正在运行)，completed(已完成)，failed(执行失败)，stopped(已人工停止)，success（成功），partial_success（部分成功）。 | | stats | [OpsEvaluationSynthesisStats] object | **参数解释：** 数据合成任务的运行明细统计对象。 **取值范围：** 不涉及。 | | usage | [OpsEvaluationTokenUsage] object | **参数解释：** 大模型调用产生的Token资源消耗统计对象。 **取值范围：** 不涉及。 | | model_config | [OpsEvaluationModelConfig] object | **参数解释：** 任务发起时所采用的模型参数配置。 **取值范围：** 参考OpsEvaluationModelConfig定义。 | | seed_data | [OpsEvaluationSeedDataConfig] object | **参数解释：** 任务依赖的种子数据配置信息。 **取值范围：** 参考OpsEvaluationSeedDataConfig定义。 | | schemas | Array of [OpsEvaluationSynthesisSchema] objects | **参数解释：** 合成数据所遵循的字段结构定义（Schema）列表。 **取值范围：** 不涉及。 | | base_info | [OpsEvaluationTaskBaseInfo] object | **参数解释：** 任务基础元数据。 **取值范围：** 不涉及。 | 表3OpsEvaluationSynthesisStats | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释：** 任务计划生成的总样本条数。 **取值范围：** 0-500。 | | progress | Integer | **参数解释：** 当前任务执行的百分比进度。 **取值范围：** 0-100。 | | success | Integer | **参数解释：** 当前已成功生成的样本总数。 **取值范围：** 0-500。 | | failed | Integer | **参数解释：** 在合成过程中失败的样本总数。 **取值范围：** 0-500。 | | running | Integer | **参数解释：** 当前正处于活跃生成阶段的样本条数。 **取值范围：** 0-500。 | | pending | Integer | **参数解释：** 尚未开始执行、在队列中等待的样本条数。 **取值范围：** 0-500。 | 表4OpsEvaluationTokenUsage | 参数 | 参数类型 | 描述 | |:---|:---|:---| | prompt_tokens | Long | **参数解释：** 输入提示词所消耗的Token数量。 **取值范围：** 0-9,999,999,999。 | | completion_tokens | Long | **参数解释：** 模型生成内容所消耗的Token数量。 **取值范围：** 0-9,999,999,999。 | | total_tokens | Long | **参数解释：** 本次任务产生的Token消耗总量。 **取值范围：** 0-9,999,999,999。 | 表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 | **参数解释：** 种子评测集的可读版本号。 **取值范围：** 如0.0.1。 | | file_name | String | **参数解释：** 作为种子源的临时文件名称。 **取值范围：** 文件名。 | | obs_tmp_file_id | String | **参数解释：** 种子数据文件在对象存储中的路径。 **取值范围：** OBS路径。 | 表7OpsEvaluationSynthesisSchema | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 合成字段的id。 **取值范围：** 由字母、数字、下划线组成。 | | name | String | **参数解释：** 合成字段的名称。 **取值范围：** 长度1-100字符，由字母、数字、下划线组成。 | | description | String | **参数解释：** 合成字段的业务含义描述。 **取值范围：** 任意字符串。 | | synthesis_requirement | String | **参数解释：** 合成要求，用于指导LLM生成该字段的思考路径。 **取值范围：** 0-4000字符，详细的指令说明。 | 表8OpsEvaluationTaskBaseInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | created_at | String | **参数解释：** 任务在系统中创建的时间戳。 **取值范围：** 不涉及。 | | start_at | String | **参数解释：** 任务正式开始执行的精确时刻。 **取值范围：** 不涉及。 | | updated_at | String | **参数解释：** 任务状态或元数据最后一次变更的时间。 **取值范围：** 不涉及。 | | completed_at | String | **参数解释：** 任务执行完毕（无论成败）的时间。 **取值范围：** 不涉及。 | | duration_seconds | Long | **参数解释：** 任务的有效运行总时长（秒）。 **取值范围：** 非负整数。 | | created_by | [OpsUserInfoObj] object | **参数解释：** 创建该任务的用户详细信息。 **取值范围：** 参考OpsUserInfoObj。 | | started_by | [OpsUserInfoObj] object | **参数解释：** 启动该任务的用户详细信息。 **取值范围：** 参考OpsUserInfoObj。 | 表9OpsUserInfoObj | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 用户的显示名称。 **取值范围：** 任意字符串。 | | user_id | String | **参数解释：** 用户在账号系统中的唯一身份ID。 **取值范围：** 不涉及 | #### 请求示例 查询评测集合成任务详情 ``` GET https://api.example.com/v1/ops/datasets-synthesis/a67452bf21f819-6f91-4568-9f2f-57ef9562ab71 ``` #### 响应示例 **状态码：200** 查询成功 ``` { "id" : "task_uuid", "name" : "task_uuid", "scenario_type" : "seed_data", "scenario_name" : "基于种子数据泛化", "scenario_description" : "基于现有100条React问答，生成50条更复杂的面试题", "status" : "running", "stats" : { "total" : 50, "progress" : 65, "success" : 33, "failed" : 2, "running" : 5, "pending" : 10 }, "usage" : { "prompt_tokens" : 12500, "completion_tokens" : 8450, "total_tokens" : 20950 }, "model_config" : { "model_id" : "1749615103", "model_name" : "豆包·1.6·自动深度思考", "temperature" : 0.1, "max_tokens" : 4096, "top_p" : 0.7, "frequency_penalty" : 0.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" }, "schemas" : [ { "id" : "schema_input_001", "name" : "input", "description" : "作为输入投递给评测对象", "synthesis_requirement" : "生成技术深度适中、具有实践意义的React问题。" } ], "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" } } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。