# 训练输入与执行环境

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

这些接口是微调训练节点控制面。源码handler标为local-debug，但当前路由和生产装配链并无同名调试开关保护；是否作为对外公开能力承诺仍需部署和产品范围证据。

<span id="prepare"></span>

## 调用前准备

准备同环境BASE_URL、MOI_KEY和WORKSPACE_ID。BASE_URL已包含产品前缀；

创建及启动使用finetune_job.create工作区权限，详情使用finetune_job.read对象权限，取消使用finetune_job.cancel。指定计算实例时，创建另需compute_resource.use。当前有效角色和依赖资源授权仍由正式边界验证，不能用任务ID或创建者身份自行代替。

准备Worker可取得的基础模型、互不相交的训练/验证run_id，以及recipe.training_objective=tool_selector。run_id应来自有权读取的astra_trace运行数据，不是会话ID或工作流case_id；未给自备数据来源时，启动按创建者actor读取对应agent_runs与非空agent_events。

## 输入冻结和recipe

创建对run_id去首尾空白、去重、排序，再拒绝空集合和两集重叠。它只验证recipe中当前启用的训练目标及基本JSON形状，不证明模型存在、训练样本可用或Worker已就绪。

| recipe来源 | 选定源码处理 |
| --- | --- |
| 未提供自备来源 | 启动读取创建者可访问的Catalog astra_trace，并补入run_traces。 |
| run_traces、trace_records、train_run_events或holdout_run_events非空 | 启动保留自备来源；Worker按冻结run_id收集并投影tool_selector样本。 |
| dataset_uri非空 | Worker直接采用该数据集地址，不等于证明它与run_id完整对应。 |
| samples非空 | Worker写入SFT JSONL，属于另一路样本输入；不承诺已执行trace治理。 |

存在来源只说明采用对应分支。完整事件/样本联合类型、治理质量、模型支持和跨路径输入限制仍需后续核对；一个training_objective字段不足以保证实际训练能完成。当前治理要求训练投影非空，验证投影可为空，不可把两组run_id合法当成已完成模型评测。

已定义但未启用的目标会被拒绝；不能把state_update、preference等保留枚举列为当前可选训练能力。

## Worker与适配器

真实训练依赖本地可用的Morpheus训练核心；桥接为SFT-only，不调用远程Morpheus HTTP服务。Worker按能力条件注册moi:finetune.train：显式禁用不注册，显式启用或dry_run/stub可注册，其余需找到有效Morpheus目录。普通CPU Worker不保证具备训练能力。

recipe.executor或环境决定执行模式。dry_run/stub写标记文件，也能返回succeeded及适配器URI；这不能证明真实权重训练。GET任务DTO没有mode，需要结合已确认执行配置或运行证据判断。

对象存储启用时，Worker上传适配器文件及manifest并返回s3://前缀；控制面校验地址位于配置前缀且以斜线结尾。这个校验不是对象存储可访问性证明。未启用时可返回Worker本地file://地址，其他客户端不一定能访问。

Backend只传对象存储目标信息，不把配置密钥塞入训练payload；Worker使用自己的对象存储凭据环境。Backend配置合法不等于Worker凭据与存储链已配置完成。适配器上传不注册推理后端、不执行评测或模型发布。
