# 创建模型调优训练作业 模型调优训练作业是指对已有模型的微调。模型有"具身广场-模型"（系统预置模型）和"空间资产-模型"（仅限[用户创建自定义的模型](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0012.html)）两类。 #### 前提条件 用户当前工作空间绑定的OBS桶需可用且OBS桶策略正常，否则功能无法正常使用。 - 如果OBS桶不可用，可根据界面提示重新选择存储地址。普通成员如遇配置失败，请联系管理员处理。 - 如果OBS桶策略异常，可根据界面提示重新配置OBS桶策略。普通成员如遇配置失败，请联系管理员处理。 - 如果因其他服务异常导致查询当前工作空间绑定的OBS桶详情失败，请联系华为云技术支持人员处理或[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)。 #### 创建模型调优训练作业（基于具身广场-模型） 1. [登录CloudRobo控制台](https://console.huaweicloud.com/cloudrobo/)。 2. 在左侧导航栏中单击"模型开发 \> 模型训练"，进入"模型训练"页面。 3. 单击右上角"创建训练作业"，进入创建页面，参照如下参数说明配置相关信息。 表1创建模型调优训练作业参数说明 | 参数 | 说明 | |:---|:---| | **基础信息** || | 作业名称 | 设置训练作业的名称，建议使用具有业务含义的名称以便于识别。 命名规则：由中文、数字、字母、下划线（_）、连字符（-）、点（.）、斜线（/）组成，长度为3\~64个字符。 | | 描述（可选） | 训练作业的简介。 长度为512个字符以内。 | | **训练配置** || | 训练方式 | 选择"模型调优"方式。 模型调优指对已有模型的微调。 | | 模型 | 选择"具身广场-模型"。 如选择的具身广场-模型为非免费模型且未订阅，请先单击"订阅模型"，到订阅模型页面[订阅模型](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0074.html)，订阅成功后才能被使用。 | | 调优方式 | 系统会根据您选择模型决定是否显示调优方式，如有多个调优方式，请您根据实际情况自行选择调优方式。 | | 算法 | 用户通过算法设置模型的调优方式。 如果选择的模型没有提供配套算法，用户自定义算法。算法支持"空间资产-算法"和"现在配置"2种方式。 - 空间资产-算法：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714172666.png "点击放大")在弹出的窗口中选择算法，也可以单击"创建算法"去空间资产自定义算法（参考[创建自定义算法](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0021.html)章节操作）后再进行选择。 - 现在配置：在当前页面自定义算法，算法不存入空间资产。 说明： 如配置了"调优方式"则不需要配置算法。 | | **数据设置**（仅当模型提供配套算法才需要进行数据设置） || | 数据 | 选择模型数据。 - 预置数据：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002744091541.png "点击放大")在弹出的窗口中选择预置数据（单击数据右侧"预览"可预览该数据详情）。 - 空间资产-数据：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714172668.png)在弹出的窗口中选择空间资产-数据（单击数据右侧"预览"可预览该数据详情）。 - 对象存储服务OBS：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002744091549.png)在弹出的窗口中选择数据在OBS下的存储路径。 说明： - 不支持选择跨区域（Region）的OBS桶。如果您的OBS桶中有需要特别保护的敏感数据，请自行对数据加密后再存放到OBS桶。 - 只能选择当前工作空间下的默认存储位置OBS路径下的文件夹，不能选择到具体文件。 | | **环境配置**（仅当模型没有提供配套算法才需进行环境配置） || | 输入模型本地目录 | 在训练镜像中，输入模型通过环境变量${MODEL_MAP}映射到本地目录。模型文件（权重、配置等）均存储在根路径下，可以获取根路径${MODEL}来定位模型资源。输入模型本地目录不能与本地代码目录、训练产物本地目录一致。 - ${MODEL}：模型根路径，如 /tmp/data/model - ${MODEL_MAP}：模型信息与本地目录的映射，如 {"modelInfo":"/tmp/data/model/model_0"} 示例：输入模型根路径为 /tmp/data/model， ${MODEL_MAP}={"modelInfo":"/tmp/data/model/model_0"}，即模型映射到根路径下的model_0子目录。 | | 镜像 | 选择训练需要的容器镜像。 | | 代码目录 | 执行本次训练作业所需的代码目录。 勾选"代码目录"，单击右侧的![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332642.png "点击放大")，选择训练代码文件所在的OBS目录。 需要提前将代码上传至OBS桶中，目录内文件总大小必须小于或等于5GB，文件数必须小于或等于1000个，文件深度必须小于或等于32。如果使用预训练模型，请将其放置在代码目录下。 说明： - 如果您的OBS桶中有需要特别保护的敏感数据，请自行对数据加密后再存放到OBS桶。 - 只能选择当前工作空间下的默认存储位置OBS路径下的文件夹，不能选择到具体文件。 | | 启动命令 | 镜像的启动命令。 运行训练作业时，当"代码目录"下载完成后，"启动命令"会被自动执行。 - 如果训练启动脚本用的是py文件，例如"train.py"，则启动命令如下所示。 ``` python ${MA_JOB_DIR}/demo-code/train.py ``` - 如果训练启动脚本用的是sh文件，例如"main.sh"，则启动命令如下所示。 ``` bash ${MA_JOB_DIR}/demo-code/main.sh ``` 启动命令支持使用";"和"\&\&"拼接多条命令，命令中的"demo-code"为存放代码目录的最后一级OBS目录，以实际情况为准。 | | 本地代码目录 | 用于指定训练容器中代码的本地目录，启动训练时系统会将代码目录中的文件下载至此目录下，下载内容为代码目录的最小子目录。 默认本地代码目录为"/home/ma-user/modelarts/user-job-dir"。例如代码目录为"/demo-test/code/"，本地代码目录为"/home/ma-user/modelarts-train/"，则下载整个code文件夹内容至本地代码目录下，即"/home/ma-user/modelarts-train/code/"。 需符合如下限制条件： - 用户可自定义本地代码目录，但不支持在/home/ma-user/modelarts/\*，/home/ma-user/modelarts-dev/\*，/home/ma-user/infer/\*目录下。 - 本地代码目录不能与输入模型本地目录、训练产物本地目录一致。 | | **资源配置** || | 资源 | 选择资源池类型，支持"公共资源池"和"专属资源池"。 - 专属资源池：专属资源池不与其他用户共享，资源更可控。在使用专属资源池之前，您需要先创建专属资源池，然后在开发过程中选择此专属资源池。不同业务使用的专属资源池有所不同，请参考[资源准备](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0147.html)创建对应的专属资源池。 说明： 选择的预置模型、镜像、数据如果是被保护的资产，为非公开资产，无法提交到专属资源池训练，则用户无法选择"专属资源池"类型。 - 公共资源池：公共资源池提供公共的大规模计算集群，根据用户作业参数分配使用，资源按作业隔离。用户下发训练作业、部署模型、使用开发环境实例等情况下，均可以使用公共资源池完成。开通账号并申请公测后即可使用CloudRobo的公共资源池。 | | 专属资源池 | 当"资源"选择"专属资源池"时，显示此参数。 请在下拉列表选择该业务拥有的专属资源池。 | | 实例规格 | 下拉选择资源池类型对应的实例规格。 | | 实例数 | 输入实例数值。输入值默认为1。 | | **超参配置** || | 超参用于训练调优。 界面默认显示选中的模型调优方式对应的内置算法中的预置超参，用户也可根据实际业务需求修改超参值。如果无内置算法，则用户根据实际业务需求配置超参。 - 单击"添加"，添加超参信息，总数不超过90条。 - 如不需要可单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714172674.png)删除。 || | **环境变量** || | 界面默认显示选中的模型调优方式对应的内置算法中预置环境变量，用户也可根据实际业务需求配置环境变量的参数名称、值。 - 单击"添加"，添加环境变量信息，总数不超过90条。 - 如不需要可单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002743931567.png)删除。 说明： 为了确保您的数据安全，在环境变量中，请勿输入敏感信息，如明文密码。 || | **输入输出**（仅当配置了"算法"需进行输入输出配置） || | 输入 | 单击"添加"，配置训练作业输入信息，最多可添加10个。 - 参数名称 算法代码需要通过"输入"的"参数名称"去读取训练的输入数据。 建议设置为"data_url"。训练输入参数要与所选算法的"输入"参数匹配。 - 输入路径类型 下拉选择输入路径类型，支持来源"OBS存储"、"预置数据"、"空间资产-数据"、"空间资产-模型"四种类型。 - 输入路径 单击"输入路径"右侧的![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332636.png)，在弹窗中选择输入路径。 训练启动时，系统将自动下载输入路径中的数据到训练运行容器。 - 获取方式 以参数名称为"data_path"的训练输入为例，说明获取方式的作用。 - 当参数的"获取方式"为"超参"时，可以参考如下代码来读取数据。 ``` import argparseparser = argparse.ArgumentParser() parser.add_argument('--data_path') args, unknown = parser.parse_known_args() data_path = args.data_path ``` - 当参数的"获取方式"为"环境变量"时，可以参考如下代码来读取数据。 ``` import osdata_path = os.getenv("data_path", "") ``` - 容器本地路径：数据输入的容器本地路径。 本地路径不支持修改，此路径由系统自动设置。 | | 输出 | 单击"添加"，配置训练作业输出信息，最多可添加5个。 - 参数名称 算法代码需要通过"输出"的"参数名称"去读取训练的输出目录。 建议设置为"train_url"。训练输出参数要与所选算法的"输出"参数匹配。 - 输出路径 单击"输出路径"参数右侧的![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002743931563.png)，从OBS桶中选择训练输出数据的存储位置。文件总大小必须小于或等于1GB，文件数必须小于或等于128个，单个文件大小必须小于或等于128MB。 训练过程中，系统将自动从训练容器的本地代码目录下同步文件到数据存储位置。 输出数据的存储位置仅支持OBS存储。为避免和训练输入数据存储冲突，建议选择一个空目录用作输出数据存储位置。 - 获取方式 以参数名称为"train_url"的训练输出为例，说明获取方式的作用。 - 当参数的"获取方式"为"超参"时，可以参考如下代码来读取数据。 ``` import argparse parser = argparse.ArgumentParser() parser.add_argument('--train_url') args, unknown = parser.parse_known_args() train_url = args.train_url ``` - 当参数的"获取方式"为"环境变量"时，可以参考如下代码来读取数据。 ``` import os train_url = os.getenv("train_url", "") ``` - 容器本地路径：数据输入通道映射的容器本地路径。 "输出"的本地路径不支持修改，此路径由系统自动设置。 | | **访问配置** || | 访问 JupyterLab | 设置是否访问JupyterLab。仅当"资源池"选择"专属资源池"时有效。 勾选后，训练任务运行期间可访问JupyterLab进行交互调试，例如追踪训练指标。具体操作请参考Notebook的[在JupyterLab中使用TensorBoard可视化作业](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0157.html)，流程一致。 | | **训练产物** || | 训练产物本地目录 | 在训练镜像中，将训练产物保存至系统内置的环境变量 ${RESULT} 指定的本地目录。系统检测到该目录内容后，将自动将其上传到模型资产中。 训练产物本地目录不能与本地代码目录、输入模型本地目录一致。 说明： 配置算法后，该字段才需要配置。当"保存方式"设置为"不发布"，该字段无需配置。 | | 保存方式 | 设置训练产物的保存方式，模型训练的最终产物将发布至**空间资产-模型**。 - 当"保存方式"设置为"新模型"时，可自定义新模型的名称。模型训练的最终产物将发布至**空间资产-模型**。 - 当"保存方式"设置为"已有模型新版本"时，下拉选择已有的模型（当"保存方式"设置为"新模型"时产生的模型）。模型训练的最终产物将发布至**空间资产-模型**。 - 当"保存方式"设置为"不发布"时，模型训练的最终产物将不发布至**空间资产-模型**。 | | 模型名称 | 选择调优后产生的新模型的名称。 模型名称长度范围为3\~64个字符，由中文、数字、字母、下划线（_）、连字符（-）、点（.）、斜线（/）组成。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | 模型版本号 | 填写新模型版本号。 当保存为"已有模型新版本"时，填写的模型版本号不能和该模型已有的版本号重复，如未填写版本号时，模型版本号会自动新增一个版本。 模型版本号长度范围为2\~128个字符，以字母或数字开头，仅支持大小写字母、数字、连字符（-）、点号（.）、下划线（_）。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | 模型类型 | 系统自动匹配模型类型，不可修改。 新模型的模型类型，需要与源模型的模型类型保持一致。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | Checkpoints 最大保留数 | 设置Checkpoints在OBS上最大保留数，设置范围为1\~50次。 该参数仅当选择的算法支持Checkpoints才有效。 训练结束后OBS仅保留N个未保存到空间资产的Checkpoints（中间产物），超出部分将被删除。已保存到空间资产Checkpoints不受此数量限制。但均按"Checkpoints 保存天数"到期后自动删除。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | Checkpoints 保留天数 | 设置Checkpoint在OBS上最大保留天数。设置范围为1\~9999次。 该参数仅当选择的算法支持Checkpoints才有效。 设置后，Checkpoints（中间训练产物）从生成时间起保留N天后自动删除。该规则与"Checkpoints 最大保留数"叠加生效。训练结束后先按数量保留最近N个Checkpoints，再按本天数到期删除。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | 模型优势技能 | 指模型经过训练后，在各项能力中表现相对优异、可作为该模型优势能力的技能。 单击"添加"，配置模型优势技能。需配置"技能名称"和"prompt"信息。 - 技能名称：仅支持中文、大小写字母、数字、连字符（-）、下划线（_），不能以空格开头和结尾，长度为1\~64个字符。 - prompt：长度在 1\~1024个字符之间的字符串。 如不需要可单击删除。最多添加50个模型优势技能。 说明： - 如果"模型类型"是"操作模型"和"导航模型"，才需配置模型优势技能，其他类模型则无需配置。 - 当"保存方式"设置为"不发布"该字段无效。 | | 仅执行模型优势技能 | 开启是否仅执行模型优势技能。 开启后，部署后的模型服务在**智能体调试**时仅能执行当前的模型优势技能。未开启则默认可执行模型的全部技能。 说明： 仅添加了"模型优势技能"时有效。 | 4. 单击"立即创建"，模型训练作业创建完成。 创建完成后，系统自动返回模型训练列表页面，等待一段时间后，状态为"运行中"即为创建成功。 #### 创建模型调优训练作业（基于空间资产-模型） 1. [登录CloudRobo控制台](https://console.huaweicloud.com/cloudrobo/)。 2. 在左侧导航栏中单击"模型开发 \> 模型训练"，进入"模型训练"页面。 3. 单击右上角"创建训练作业"，进入创建页面，参照如下参数说明配置相关信息。 表2创建模型调优训练作业参数说明 | 参数 | 说明 | |:---|:---| | **基础信息** || | 作业名称 | 设置训练作业的名称，建议使用具有业务含义的名称以便于识别。 命名规则：由中文、数字、字母、下划线（_）、连字符（-）、点（.）、斜线（/）组成，长度为3\~64个字符。 | | 描述（可选） | 训练作业的简介。 长度为512个字符以内。 | | **训练配置** || | 训练方式 | 选择"模型调优"方式。 模型调优指对已有模型的微调。 | | 模型 | 选择"空间资产-模型"。 | | 调优方式 | 系统会根据您选择模型来决定是否显示调优方式，如有多个调优方式，请您根据实际情况自行选择调优方式。 | | 算法 | 用户通过算法设置模型的调优方式。系统会根据您选择的模型来决定是否需要配置算法，算法支持"空间资产-算法"和"现在配置"2种方式。 - 空间资产-算法：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714172676.png "点击放大")在弹出的窗口中选择算法，也可以单击"创建算法"去空间资产自定义算法（参考[创建自定义算法](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0021.html)章节操作）后再进行选择。 - 现在配置：在当前页面自定义算法，不存入空间资产-算法。 说明： 配置了"调优方式"则不需要配置算法。 | | **数据设置**（仅当设置了"调优方式"参数才需进行数据设置） || | 数据 | 选择模型数据。 - 预置数据：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332638.png "点击放大")在弹出的窗口中选择预置数据（单击数据右侧"预览"可预览该数据详情）。 - 空间资产-数据：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002744091551.png)在弹出的窗口中选择空间资产-数据（单击数据右侧"预览"可预览该数据详情）。 - 对象存储服务OBS：单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002744091545.png)在弹出的窗口中选择数据在OBS下的存储路径。 说明： - 不支持选择跨区域（Region）的OBS桶。如果您的OBS桶中有需要特别保护的敏感数据，请自行对数据加密后再存放到OBS桶。 - 只能选择当前工作空间下的默认存储位置OBS路径下的文件夹，不能选择到具体文件。 | | **资源配置** || | 资源 | 选择资源池类型，支持"公共资源池"和"专属资源池"。 - 专属资源池：专属资源池不与其他用户共享，资源更可控。在使用专属资源池之前，您需要先创建专属资源池，然后在开发过程中选择此专属资源池。不同业务使用的专属资源池有所不同，请参考[资源准备](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0147.html)创建对应的专属资源池。 说明： 选择的模型、数据如果是被保护的资产，为非公开资产，无法提交到专属资源池训练，则用户无法选择"专属资源池"类型。 - 公共资源池：公共资源池提供公共的大规模计算集群，根据用户作业参数分配使用，资源按作业隔离。用户下发训练作业、部署模型、使用开发环境实例等情况下，均可以使用公共资源池完成。开通账号并申请公测后即可使用CloudRobo的公共资源池。 | | 专属资源池 | 当"资源"选择"专属资源池"时，显示此参数。 请在下拉列表选择该业务拥有的专属资源池。 | | 实例规格 | 下拉选择资源池类型对应的实例规格。 | | 实例数 | 输入实例数值。输入值默认为1。 | | **超参配置** || | 超参用于训练调优。 如果选择的模型为具身广场-模型迭代训练后生成的模型，界面默认显示该模型调优方式对应的内置算法中的预置超参，用户也可根据实际业务需求修改超参值；如选择其他模型，用户可根据实际业务需求配置超参。 - 单击"添加"，添加超参信息，总数不超过90条。 - 如不需要可单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332640.png)删除。 || | **环境配置**（仅当设置了"算法"参数才需进行环境配置） || | 输入模型本地目录 | 在训练镜像中，输入模型通过环境变量${MODEL_MAP}映射到本地目录。模型文件（权重、配置等）均存储在根路径下，可以获取根路径${MODEL}来定位模型资源。输入模型本地目录不能与本地代码目录、训练产物本地目录一致。 - ${MODEL}：模型根路径，如 /tmp/data/model - ${MODEL_MAP}：模型信息与本地目录的映射，如 {"modelInfo":"/tmp/data/model/model_0"} 示例：输入模型根路径为 /tmp/data/model， ${MODEL_MAP}={"modelInfo":"/tmp/data/model/model_0"}，即模型映射到根路径下的model_0子目录。 | | 镜像 | 选择训练需要的容器镜像。 | | 代码目录 | 执行本次训练作业所需的代码目录。 勾选"代码目录"，单击右侧的![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002743931565.png "点击放大")，选择训练代码文件所在的OBS目录。 需要提前将代码上传至OBS桶中，目录内文件总大小必须小于或等于5GB，文件数必须小于或等于1000个，文件深度必须小于或等于32。如果使用预训练模型，请将其放置在代码目录下。 说明： - 如果您的OBS桶中有需要特别保护的敏感数据，请自行对数据加密后再存放到OBS桶。 - 只能选择当前工作空间下的默认存储位置OBS路径下的文件夹，不能选择到具体文件。 | | 启动命令 | 镜像的启动命令。 运行训练作业时，当"代码目录"下载完成后，"启动命令"会被自动执行。 - 如果训练启动脚本用的是py文件，例如"train.py"，则启动命令如下所示。 ``` python ${MA_JOB_DIR}/demo-code/train.py ``` - 如果训练启动脚本用的是sh文件，例如"main.sh"，则启动命令如下所示。 ``` bash ${MA_JOB_DIR}/demo-code/main.sh ``` 启动命令支持使用";"和"\&\&"拼接多条命令，命令中的"demo-code"为存放代码目录的最后一级OBS目录，以实际情况为准。 | | 本地代码目录 | 用于指定训练容器中代码的本地目录，启动训练时系统会将代码目录中的文件下载至此目录下，下载内容为代码目录的最小子目录。 默认本地代码目录为"/home/ma-user/modelarts/user-job-dir"。例如代码目录为"/demo-test/code/"，本地代码目录为"/home/ma-user/modelarts-train/"，则下载整个code文件夹内容至本地代码目录下，即"/home/ma-user/modelarts-train/code/"。 需符合如下限制条件： - 用户可自定义本地代码目录，但不支持在/home/ma-user/modelarts/\*，/home/ma-user/modelarts-dev/\*，/home/ma-user/infer/\*目录下。 - 本地代码目录不能与输入模型本地目录、训练产物本地目录一致。 | | **环境变量** || | 如果选择的模型为具身广场-模型迭代训练后生成的模型，界面默认该模型调优方式对应的内置算法中预置环境变量，用户也可根据实际业务需求配置环境变量；如选择其他模型，用户则需根据实际业务需求配置环境变量。 - 单击"添加"，添加环境变量信息，总数不超过90条。 - 如不需要可单击![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002744091547.png)删除。 说明： 为了确保您的数据安全，在环境变量中，请勿输入敏感信息，如明文密码。 || | **输入输出**（仅当配置了"算法"需进行输入输出配置） || | 输入 | 单击"添加"，配置训练作业输入信息，最多可添加10个。 - 参数名称 算法代码需要通过"输入"的"参数名称"去读取训练的输入数据。 建议设置为"data_url"。训练输入参数要与所选算法的"输入"参数匹配。 - 输入路径类型 下拉选择输入路径类型，支持来源"OBS存储"、"预置数据"、"空间资产-数据"、"空间资产-模型"四种类型。 - 输入路径 单击"输入路径"右侧的![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002744091543.png)，在弹窗中选择输入路径。 训练启动时，系统将自动下载输入路径中的数据到训练运行容器。 - 获取方式 以参数名称为"data_path"的训练输入为例，说明获取方式的作用。 - 当参数的"获取方式"为"超参"时，可以参考如下代码来读取数据。 ``` import argparseparser = argparse.ArgumentParser() parser.add_argument('--data_path') args, unknown = parser.parse_known_args() data_path = args.data_path ``` - 当参数的"获取方式"为"环境变量"时，可以参考如下代码来读取数据。 ``` import osdata_path = os.getenv("data_path", "") ``` - 容器本地路径：数据输入的容器本地路径。 本地路径不支持修改，此路径由系统自动设置。 | | 输出 | 单击"添加"，配置训练作业输出信息，最多可添加5个。 - 参数名称 算法代码需要通过"输出"的"参数名称"去读取训练的输出目录。 建议设置为"train_url"。训练输出参数要与所选算法的"输出"参数匹配。 - 输出路径 单击"输出路径"参数右侧的![](https://support.huaweicloud.com/usermanual-cloudrobo/zh-cn_image_0000002714332644.png)，从OBS桶中选择训练输出数据的存储位置。文件总大小必须小于或等于1GB，文件数必须小于或等于128个，单个文件大小必须小于或等于128MB。 训练过程中，系统将自动从训练容器的本地代码目录下同步文件到数据存储位置。 输出数据的存储位置仅支持OBS存储。为避免和训练输入数据存储冲突，建议选择一个空目录用作输出数据存储位置。 - 获取方式 以参数名称为"train_url"的训练输出为例，说明获取方式的作用。 - 当参数的"获取方式"为"超参"时，可以参考如下代码来读取数据。 ``` import argparse parser = argparse.ArgumentParser() parser.add_argument('--train_url') args, unknown = parser.parse_known_args() train_url = args.train_url ``` - 当参数的"获取方式"为"环境变量"时，可以参考如下代码来读取数据。 ``` import os train_url = os.getenv("train_url", "") ``` - 容器本地路径：数据输入通道映射的容器本地路径。 "输出"的本地路径不支持修改，此路径由系统自动设置。 | | **访问配置** || | 访问 JupyterLab | 设置是否访问JupyterLab。仅当"资源池"选择"专属资源池"时有效。 勾选后，训练任务运行期间可访问JupyterLab进行交互调试，例如追踪训练指标。具体操作请参考Notebook的[在JupyterLab中使用TensorBoard可视化作业](https://support.huaweicloud.com/usermanual-cloudrobo/cloudrobo_02_0157.html)，流程一致。 | | **训练产物** || | 训练产物本地目录 | 在训练镜像中，将训练产物保存至系统内置的环境变量 ${RESULT} 指定的本地目录。系统检测到该目录内容后，将自动将其上传到模型资产中。 训练产物本地目录不能与本地代码目录、输入模型本地目录一致。 说明： 配置算法后，该字段才需要配置。当"保存方式"设置为"不发布"，该字段无需配置。 | | 保存方式 | 设置训练产物的保存方式。 - 当"保存方式"设置为"新模型"时，可自定义新模型的名称。模型训练的最终产物将发布至**空间资产-模型**。 - 当"保存方式"设置为"已有模型新版本"时，下拉选择已有的模型（下拉选项值为当"保存方式"设置为"新模型"时产生的模型）。模型训练的最终产物将发布至**空间资产-模型**。 - 当"保存方式"设置为"不发布"时，模型训练的最终产物将不发布至**空间资产-模型**。 | | 模型名称 | 设置调优后产生的新模型的名称。当"保存方式"设置为"不发布"该字段无效。 模型名称长度范围为3\~64个字符，由中文、数字、字母、下划线（_）、连字符（-）、点（.）、斜线（/）组成。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | 模型版本号 | 填写新模型版本号。 当保存为"已有模型新版本"时，填写的模型版本号不能和该模型已有的版本号重复，如未填写版本号时，模型版本号会自动新增一个版本。当"保存方式"设置为"不发布"该字段无效。 模型版本号长度范围为2\~128个字符，以字母或数字开头，仅支持大小写字母、数字、连字符（-）、点号（.）、下划线（_）。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | 模型类型 | 系统自动匹配模型类型，不可修改。当"保存方式"设置为"不发布"该字段无效。 新模型的模型类型，需要与源模型的模型类型保持一致。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | Checkpoints 最大保留数 | 设置Checkpoints在OBS上最大保留数，设置范围为1\~50次。 该参数仅当选择的算法支持Checkpoints才有效。 训练结束后OBS仅保留N个未保存到空间资产的Checkpoints（中间产物），超出部分将被删除。已保存到空间资产Checkpoints不受此数量限制。但均按"Checkpoints 保存天数"到期后自动删除。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | Checkpoints 保留天数 | 设置Checkpoint在OBS上最大保留天数。设置范围为1\~9999次。 该参数仅当选择的算法支持Checkpoints才有效。 设置后，Checkpoints（中间训练产物）从生成时间起保留N天后自动删除。该规则与"Checkpoints 最大保留数"叠加生效。训练结束后先按数量保留最近N个Checkpoints，再按本天数到期删除。 说明： 当"保存方式"设置为"不发布"该字段无需配置。 | | 模型优势技能 | 指模型经过训练后，在各项能力中表现相对优异、可作为该模型优势能力的技能。 单击"添加"，配置模型优势技能。需配置"技能名称"和"prompt"信息。 - 技能名称：仅支持中文、大小写字母、数字、连字符（-）、下划线（_），不能以空格开头和结尾，长度为1\~64个字符。 - prompt：长度在 1\~1024个字符之间的字符串。 如不需要可单击删除。最多添加50个模型优势技能。 说明： - 如果"模型类型"是"操作模型"和"导航模型"，才需配置模型优势技能，其他类模型则无需配置。 - 当"保存方式"设置为"不发布"该字段无效。 | | 仅执行模型优势技能 | 开启是否仅执行模型优势技能。 开启后，部署后的模型服务在**智能体调试**时仅能执行当前的模型优势技能。未开启则默认可执行模型的全部技能。 说明： 仅添加了"模型优势技能"时有效。 | 4. 单击"立即创建"，模型训练作业创建完成。 创建完成后，系统自动返回模型训练列表页面，等待一段时间后，状态为"运行中"即为创建成功。 #### 常见问题 创建模型调优训练任务时，如果系统提示配额或资源不足，请参考"[创建执行作业时遇到系统提示配额或资源不足怎么解决](https://support.huaweicloud.com/cloudrobo_faq/cloudrobo_06_0003.html)"章节描述来解决。