当您更新引用过时的软件规范或框架的资产时,请使用这些准则。
在某些情况下,资产更新是无缝的。 在其他情况下,必须重新训练或重新部署资产。 有关一般准则,请参阅 迁移引用已停用的软件规范的资产 或 迁移引用已停用的框架版本的资产。
有关更多信息,请参阅以下各部分:
管理引用了已停用软件规范的资产
迁移引用了已停用框架版本的资产
- 在迁移期间,不会更新模型类型。 您必须手动更新此数据。 有关更多信息,请参阅 更新机器学习模型。
- 迁移后,将除去现有部署,并且不允许不推荐使用的框架的新部署。
更新软件规范
您可以从 UI 或使用 API 更新软件规范。 有关更多信息,请参阅以下各部分:
从 UI 更新软件规范
- 在部署空间中,单击模型 (确保它没有任何活动部署。)
- 单击
i
符号以检查模型详细信息。 - 使用下拉列表来更新软件规范。
请参阅示例图像:
使用 API 更新软件规范
您可以使用 API 补丁命令来更新软件规范:
对于 software_spec
字段,输入 /software_spec
。 对于 value
字段,请使用新软件规范的标识或名称。
请参阅以下示例:
curl -X PATCH '<deployment endpoint url>/ml/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[
{
"op":"replace",
"path":"/software_spec",
"value":{
"id":"6f01d512-fe0f-41cd-9a52-1e200c525c84" // or "name":"tensorflow_rt22.1-py3.9"
}
}
]'
有关更多信息,请参阅 使用补丁 API 命令更新资产。
更新机器学习模型
要更新使用不推荐使用的框架构建的模型,请完成下列步骤。
选项 1:使用兼容的框架保存该模型
使用watsonx.aiRuntimeData and AI Common Core API或watsonx.ai Python客户端库下载模型。
以下示例显示了如何下载模型:
client.repository.download(<model-id>, filename="xyz.tar.gz")
使用当前发行版中支持的模型类型和版本编辑模型元数据。 有关更多信息,请参阅 部署的软件规范和硬件规范。
以下示例显示如何编辑模型元数据:
model_metadata = { client.repository.ModelMetaNames.NAME: "example model", client.repository.ModelMetaNames.DESCRIPTION: "example description", client.repository.ModelMetaNames.TYPE: "<new model type>", client.repository.ModelMetaNames.SOFTWARE_SPEC_UID: client.software_specifications.get_uid_by_name("<new software specification name>") }
将模型保存到watsonx.aiRuntime 资源库。 以下示例显示如何将模型保存到存储库:
model_details = client.repository.store_model(model="xyz.tar.gz", meta_props=model_metadata)
部署该模型。
对该模型进行评分以生成预测。
如果部署或评分失败,那么模型与用于保存模型的新版本不兼容。 在这种情况下,请使用 选项 2。
选项 2:使用兼容的框架重新训练该模型
- 使用当前版本中支持的模型类型和版本重新训练模型。
- 使用受支持的模型类型和版本来保存模型。
- 部署该模型,并进行评分。
还可以使用 API 更新模型。 有关更多信息,请参阅 使用补丁 API 命令更新资产。
更新 Python 函数
执行以下步骤以更新使用不推荐的框架构建的 Python 函数。
选项 1: 使用兼容的运行时或软件规范保存 Python 函数
- 使用 "watsonx.aiRuntime "REST API或 "watsonx.ai"Python客户图书馆下载 "Python函数。
- 使用受支持的运行时或软件规范版本保存 Python 函数。 有关更多信息,请参阅 部署的软件规范和硬件规范。
- 部署该 Python 函数。
- 对该 Python 函数进行评分以生成预测。
如果 Python 函数在评分期间失败,那么该函数与用于保存 Python 函数的新运行时或软件规范版本不兼容。 在这种情况下,请使用 选项 2。
选项 2:修改函数代码并使用兼容的运行时或软件规范进行保存
- 修改 Python 函数代码,使其与新的运行时或软件规范版本兼容。 在某些情况下,必须更新安装在 Python 函数代码中的从属库。
- 使用新的运行时或软件规范版本保存 Python 函数。
- 部署该 Python 函数,并进行评分。
还可以使用 API 来更新函数。 有关更多信息,请参阅 使用补丁 API 命令更新资产。
重新训练 SPSS Modeler 流程
2020 年 9 月 1 日前在IBM watsonx.aiStudio Cloud 中使用SPSS Modeler构建的某些模型无法再使用watsonx.aiRuntime 进行部署。 此问题是由受支持的 SPSS Modeler 运行时中的 Python 版本升级导致的。 如果您在SPSS Modeler流程中使用以下六个节点之一,则必须使用SPSS Modeler和watsonx.aiRuntime 重建并重新部署模型:
- XGBoost 树
- XGBoost 线性
- 一类 SVM
- HDBSCAN
- KDE 建模
- 高斯混合
要重新训练 SPSS Modeler 流程,请执行以下步骤:
- 如果您使用的是watsonx.aiStudio 用户界面,请在watsonx.aiStudio 中打开SPSS Modeler流程,重新训练并将模型保存到watsonx.aiRuntime。 将模型保存到项目后,可以将其提升到部署空间并创建新的部署。
- 如果您使用的是REST API或Python客户端,请使用SPSS Modeler重新训练模型,并将模型保存到watsonx.aiRuntime 资源库,模型类型为 "
spss-modeler-18.2
。
父主题: 框架和软件规范