# 微调任务对象

四个控制接口返回同一任务DTO，成功包为字符串code=OK、msg=OK和data。这里只列当前HTTP实际返回的字段；持久模型中的其他字段不自动成为API能力。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `job_id` | string | 稳定任务ID，后续查询、启动和取消使用此值。 |
| `workspace_id` | string | 任务所属工作区。 |
| `request_id` | string | 创建请求的业务幂等标识。 |
| `base_model` | string | 冻结的基础模型标识。 |
| `status` | string | pending/running/succeeded/failed/cancelled。 |
| `train_run_ids` | array（字符串数组） | 冻结并排序的训练run_id集合。 |
| `holdout_run_ids` | array（字符串数组） | 冻结并排序的验证run_id集合。 |
| `recipe` | object | 已保存训练配置，启动可能补入run_traces；无内容时省略。 |
| `compute_resource_id` | string | 指定计算实例，空时省略。 |
| `adapter_uri` | string | 完成后的适配器地址，空时省略；不是推理服务URL。 |
| `mowl_task_id` | string | 编排任务关联，空时省略；临时launching:值不是可用工作流任务ID。 |
| `mowl_case_id` | string | 编排实例关联，空时省略；临时launching:值同样不可作为运行ID使用。 |
| `error_code` | string | 任务失败或取消代码，空时省略。 |
| `error_message` | string | 任务错误说明，空时省略。 |
| `started_at` | string | 控制面启动/认领时间，不保证是GPU训练开始时间；未设置时省略。 |
| `finished_at` | string | 任务写入终态的时间；未设置时省略。 |
| `created_at` | string | 任务创建时间。 |
| `updated_at` | string | 最近修改时间。 |

时间使用UTC RFC3339，可有小数秒。当前创建要求两组run_id均非空；示例按当前有效创建数据展示。

后端完整DTO有18个字段，当前Go/Python专用任务类型只保留九个：job_id、workspace_id、request_id、base_model、status、compute_resource_id、adapter_uri、error_code、error_message。其余九个字段不能从这些专用返回类型取得。

## 状态判断

| 状态 | 当前含义 | 下一步 |
| --- | --- | --- |
| pending | 已保存，尚未完成启动认领。 | 按需要启动；未启动的保存结果不是训练完成。 |
| running | 控制面已经认领或进入运行；可能仍在准备/派发。 | 继续查询任务，不能以此确认GPU已工作。 |
| succeeded | 当前执行器返回可接受结果并保存adapter_uri。 | 确认执行模式和适配器实际可访问性，再进入独立部署流程。 |
| failed | 准备、派发、训练、产物或其他阶段失败。 | 读取error_code/error_message并核对恢复条件。 |
| cancelled | 控制面已记录取消终态。 | 停止轮询；子进程停止与外部资源清理由各自协议确认。 |

succeeded、failed、cancelled均为终态。GET没有返回执行模式、指标列表、日志列表、模型后端ID、端点ID或发布状态；不能从该DTO声称模型已经发布，或所有运行诊断均已完整保存。
