# 创建、调度与结果恢复

先保存可查询的任务，再启动和读取终态。一个HTTP成功不能代替后续状态检查。

## 创建与重放

request_id位于请求体，作用域为工作区。相同标识且基础模型、归一后的训练/验证集、recipe及计算实例摘要匹配时返回原任务；改变这些输入可409冲突。保持原始recipe和标识，不能承诺任意JSON语义重排都视为同一摘要。

launch不进入创建摘要。launch=true在保存后另调用启动，启动失败时任务可能已经持久化，甚至已进入failed。恢复时保留request_id及原训练参数，先以launch=false重放创建取得既有job_id，再GET核对；不要保持launch=true反复触发调度，也不要换标识制造重复任务。

## 启动与工作流关联

启动先读取并补齐训练输入，再用条件写入claim标识；认领时可写running和started_at，这些值不证明Worker已经接收任务。随后准备、绑定并唤醒工作流，mowl_task_id/case_id才替换为真实关联。

已有真实绑定时返回或推进现有任务，不另建训练；遇到并发claim可返回当前记录。claim值带launching:前缀，只是内部占位，不能当工作流task/case调用。准备、绑定或唤醒失败会尝试写失败状态，响应错误后仍须回读任务。

创建者actor用于Catalog trace读取；运行WorkItem按正式延续身份恢复并校验任务工作区。工作区create权限、原任务身份和实际数据访问不能互相替代。

## 终态和取消

训练WorkItem需完成并返回非空适配器URI，启用存储时还校验URI前缀，然后保存succeeded。日志/指标持久化可独立失败，不能把成功训练状态写成诊断完整保存或模型发布成功。

取消针对非终态任务。有真实工作流绑定时先请求取消工作流，再保存cancelled；只有claim占位时不把占位值传入工作流取消。重复取消已终态任务409，不承诺无限幂等成功。实际训练按检查点处理取消，不能承诺请求返回时所有子进程已停止。

后台训练返回成功前会再次检查已取消状态；取消/完成竞态及多事务失败仍需实际环境复测。失败任务没有这些接口重试、删除、列举或发布入口，不能因为内部模型字段存在就补造端点。

<span id="errors"></span>

## 错误与结果

| HTTP/字符串code | 选定合同 |
| --- | --- |
| 400 / ErrParamInvalid | 必填字段、训练集划分、JSON或训练目标不合法。 |
| 400 / ErrWorkspaceRequired | 工作区头与路径不匹配等输入错误。 |
| 401 / ErrUnauthenticated | handler要求的用户身份缺失；身份中间件拒绝另按正式认证合同。 |
| 403 / ErrPermissionDenied | 业务授权拒绝。 |
| 404 / ErrNotFound | 当前作用域下任务不可读取。 |
| 409 / ErrConflict | request_id输入冲突、任务不可启动或已不可取消。 |
| 500 / ErrServer | 其他依赖或执行准备错误；任务可能已保存或发生部分调度。 |

错误说明和状态必须结合读取结果判断；没有为这些接口自动套上通用503错误表。完整运行错误、部署错误与认证包还需真实环境核对。
