创建用例以在模型在 AI 生命周期中移动时跟踪与该模型关联的所有事实。 对于每个用例,创建 方法 以跟踪模型上的变体。 每种方法都可以表示解决问题的不同方法。 对于每种方法,您可以在处理用例解决方案时保存模型的版本。
方法提供了一种方法来跟踪用于解决问题的多条路径。 例如,在请求用于分析信用风险的模型的用例中,可以使用不同的算法来构建模型的方法,因此可以比较方法并最终为用例选择最佳解决方案。
观看此视频,了解如何使用方法创建模型用例
此视频提供了一种可视方法来学习本文档中的概念和任务。
在用例中创建方法
创建新用例时,首先使用缺省 方法 来解决业务问题,然后根据需要添加新方法。 方法是实现用例目标的一条途径。
- 从模型库存创建用例,或者从项目或空间中的 跟踪此模型 选项创建用例。
- 为用例分配名称和可选描述。
- 从 资产 选项卡中,单击缺省方法的磁贴或创建新方法。
- 输入或更新名称和描述。
- (可选) 更新方法的图标和颜色方案。
- 保存您的更改。
- 单击 新建方法 ,然后重复这些步骤为用例定义其他方法。
向方法添加模型
跟踪模型时,将其添加到用例中的方法。
从项目,空间或目录中打开模型详细信息页面。
单击 跟踪此模型。
选择现有用例或创建新的用例。
选择要在其中跟踪模型的现有方法,或者创建新方法。
选择与模型的状态最匹配的版本类型。 该类型会影响版本号,该版本号遵循
major.minor.patch
语义版本控制格式。 如果这是方法中的第一个模型,请选择:- 实验: 模型刚刚开始开发,输入和输出结构可能发生变化。 此选项将增加版本的补丁号。
- 稳定: 模型正在生产中,您不期望输入或输出发生重大更改。 此选项设置版本的主要编号。
- 定制: 定义您自己的起始点。 使用 custom 来创建新的版本号,遵循语义版本控制格式
major.minor.patch
。
注:如果要保存现有模型的版本,那么可以使用 补丁, 次要, 主要或 定制 版本更新的选项来更新版本。
(可选) 提供版本的注释。
将模型与模型记录关联后,单击 在模型库存中打开 以查看作为用例一部分跟踪的模型。 有关方法和版本的信息将显示在模型详细信息面板中。
查看,编辑和除去方法
您可以在模型用例中查看,编辑和除去方法。
在模型清单中打开用例以查看方法。 每个方法都显示针对该方法跟踪的所有版本。
要更新方法详细信息 (例如,名称和描述) ,请从方法操作菜单中选择 编辑方法 。
如果在方法下跟踪任何模型版本,那么无法删除方法。 要删除方法,请首先将所有模型移至其他方法。 然后,从方法操作菜单中选择 删除 。
注: 不能从用例中删除最后一种方法。
在此示例中,模型用例具有用于跟踪预生产中的资产的方法,以及用于跟踪生产中的资产的另一种方法。
更改模型版本或方法
从模型用例中,您可以编辑模型版本以更新版本或将模型分配给其他非议。 使用此过程将现有模型从缺省方法分配到其他方法或更新模型版本。
如果版本是 "N/A" 而不是数字版本,那么必须使用 API 方法 来更改版本。
- 从模型用例的 " 资产 " 页面中,单击模型条目的 编辑版本 。
- (可选) 将模型分配给其他方法。 您可以选择选择现有方法或创建新方法。
- 单击下一步。
- (可选) 更新版本号。 选择其中一个预定义的版本更改或创建定制版本号。
- 单击 跟踪模型 以保存更改并查看模型更新。
使用 API 将现有跟踪模型分配给方法
将集群升级到 Cloud Pak for Data 4.7时,将以缺省方法显示使用 不适用 版本的用例中的所有受跟踪模型。 您可以使用 AI Factsheets APIS 为现有模型分配和管理模型版本。
- 创建新方法以分配现有模型的新版本。
- 调用 API 方法
getModelUsecaseApproaches
。 - 从响应有效内容中,获取在第一步中创建的方法的标识。
- 使用 API 函数
getphysicalmodels
可列出现有受跟踪模型。 此命令将返回跟踪到用例的所有模型。 请注意,在模型跟踪详细信息中,在单个行中呈现的所有模型对于model_identity_key
具有相同的值。 - 从响应有效内容中,获取要分配给其他版本的模型行的
model_identity_key value
。 - 使用
updateModelApproachAndOrVersion
函数并提供以下参数值:
参数 | 值 |
---|---|
model_usecase_asset_id | 模型用例的资产标识。 可以从浏览器 URL 访存此信息 |
审批标识 | 00000000-0000-0000-0000-000000000000 |
版本号 | 0.0.0-model.%model_identity_key% 将 model_identity_key 替换为先前 API 响应中的值。 例如, 0.0.0-model.a30593ff-4eec-4241-b445-c2450b4fa6da |
catalog_id | 在其中创建模型用例的目录的标识。 您可以从浏览器 URL 获取 ID。 |
请遵循以下步骤来构造请求有效内容:
准备使用 API 命令
getModelUsecaseApproaches
。从请求有效内容中,获取先前为新模型版本创建的方法的标识。 请求有效内容将如下所示:
{ "target_approach_id": "Enter approach id value fetched from previous api response payload", "target_version_number": "Enter version number in version semantic format say x.y.z", "target_version_comment": "Information about the changes gone in this model version" }
执行 API 命令。
具有指定模型身份密钥的所有受跟踪模型都将分配给具有给定版本的新方法。 通过提供新的版本号,对每行重复该过程。