0 / 0
Go back to the English version of the documentation
管理过时的软件规范或框架
Last updated: 2024年11月21日
管理过时的软件规范或框架

当您更新引用过时的软件规范或框架的资产时,请使用这些准则。

在某些情况下,资产更新是无缝的。 在其他情况下,必须重新训练或重新部署资产。 有关一般准则,请参阅 迁移引用已停用的软件规范的资产迁移引用已停用的框架版本的资产

有关更多信息,请参阅以下各部分:

管理引用了已停用软件规范的资产

  • 在迁移期间,引用已停用的软件规范的资产将映射到可比较支持的缺省软件规范 (仅在模型类型仍受支持的情况下)。
  • 创建已迁移资产的新部署时,将使用资产元数据中更新的软件规范。
  • 已迁移资产的现有部署将更新为使用新的软件规范。 如果由于框架或库版本不兼容而导致部署或评分失败,请遵循 更新软件规范中的指示信息。 如果问题仍然存在,请遵循 更新机器学习模型中列出的步骤。

迁移引用了已停用框架版本的资产

  • 在迁移期间,不会更新模型类型。 您必须手动更新此数据。 有关更多信息,请参阅 更新机器学习模型
  • 迁移后,将除去现有部署,并且不允许不推荐使用的框架的新部署。

更新软件规范

您可以从 UI 或使用 API 更新软件规范。 有关更多信息,请参阅以下各部分:

从 UI 更新软件规范

  1. 在部署空间中,单击模型 (确保它没有任何活动部署。)
  2. 单击 i 符号以检查模型详细信息。
  3. 使用下拉列表来更新软件规范。

请参阅示例图像:

通过 UI 更新软件规范

使用 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:使用兼容的框架保存该模型

  1. 使用watsonx.aiRuntimeData and AI Common Core API或watsonx.ai Python客户端库下载模型。

    以下示例显示了如何下载模型:

    client.repository.download(<model-id>, filename="xyz.tar.gz")
    
  2. 使用当前发行版中支持的模型类型和版本编辑模型元数据。 有关更多信息,请参阅 部署的软件规范和硬件规范

    以下示例显示如何编辑模型元数据:

    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>")
    }
    
  3. 将模型保存到watsonx.aiRuntime 资源库。 以下示例显示如何将模型保存到存储库:

    model_details = client.repository.store_model(model="xyz.tar.gz", meta_props=model_metadata)
    
  4. 部署该模型。

  5. 对该模型进行评分以生成预测。

如果部署或评分失败,那么模型与用于保存模型的新版本不兼容。 在这种情况下,请使用 选项 2

选项 2:使用兼容的框架重新训练该模型

  1. 使用当前版本中支持的模型类型和版本重新训练模型。
  2. 使用受支持的模型类型和版本来保存模型。
  3. 部署该模型,并进行评分。

还可以使用 API 更新模型。 有关更多信息,请参阅 使用补丁 API 命令更新资产

更新 Python 函数

执行以下步骤以更新使用不推荐的框架构建的 Python 函数。

选项 1: 使用兼容的运行时或软件规范保存 Python 函数

  1. 使用 "watsonx.aiRuntime "REST API或 "watsonx.ai"Python客户图书馆下载 "Python函数。
  2. 使用受支持的运行时或软件规范版本保存 Python 函数。 有关更多信息,请参阅 部署的软件规范和硬件规范
  3. 部署该 Python 函数。
  4. 对该 Python 函数进行评分以生成预测。

如果 Python 函数在评分期间失败,那么该函数与用于保存 Python 函数的新运行时或软件规范版本不兼容。 在这种情况下,请使用 选项 2

选项 2:修改函数代码并使用兼容的运行时或软件规范进行保存

  1. 修改 Python 函数代码,使其与新的运行时或软件规范版本兼容。 在某些情况下,必须更新安装在 Python 函数代码中的从属库。
  2. 使用新的运行时或软件规范版本保存 Python 函数。
  3. 部署该 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 APIPython客户端,请使用SPSS Modeler重新训练模型,并将模型保存到watsonx.aiRuntime 资源库,模型类型为 "spss-modeler-18.2

父主题: 框架和软件规范

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more