ユースケースを作成して、モデルが AI ライフサイクルを移動する際に、モデルに関連するすべての事実を追跡します。 ユース・ケースごとに、モデルのバリエーションを追跡するための アプローチ を作成します。 それぞれのアプローチは、問題を解決するための異なる方法を表すことができます。 それぞれの方法について、ユース・ケース・ソリューションに向かって作業する際にモデルのバージョンを保存できます。
アプローチは、問題を解決するための複数のパスを追跡する手段を提供します。 例えば、クレジット・リスクを分析するためのモデルを要求するユース・ケースでは、さまざまなアルゴリズムを使用して作成されたモデルのアプローチを使用できます。これにより、それらのアプローチを比較し、最終的にユース・ケースに最適なソリューションを選択できます。
このビデオを視聴して、アプローチを使用してモデル・ユース・ケースを作成する方法を確認してください。
このビデオは、本書の概念とタスクを学習するためのビジュアル・メソッドを提供します。
ユース・ケースでのアプローチの作成
新しいユース・ケースを作成する場合は、ビジネス上の問題に対処するためにデフォルトの アプローチ から開始し、必要に応じて新しいアプローチを追加します。 アプローチは、ユース・ケースの目標を達成するための 1 つの方法です。
- ユース・ケースをモデル・インベントリーから作成するか、プロジェクトまたはスペースの 「このモデルを追跡する」 オプションから作成します。
- ユース・ケースの名前とオプションの説明を割り当てます。
- 「アセット」 タブで、デフォルトのアプローチのタイルをクリックするか、新しいアプローチを作成します。
- 名前と説明を入力または更新します。
- オプションで、アプローチのアイコンとカラー・スキームを更新します。
- 変更を保存します。
- 「新規アプローチ」 をクリックし、ステップを繰り返して、ユース・ケースに別のアプローチを定義します。
アプローチへのモデルの追加
モデルを追跡する場合は、モデルをユース・ケースのアプローチに追加します。
プロジェクト、スペース、またはカタログからモデル詳細ページを開きます。
「このモデルを追跡する」をクリックします。
既存のユース・ケースを選択するか、新しいユース・ケースを作成します。
モデルを追跡する既存のアプローチを選択するか、新しいアプローチを作成します。
モデルの状態に最もよく一致するバージョンのタイプを選択します。 このタイプは、
major.minor.patch
セマンティック・バージョン管理フォーマットに従うバージョン番号に影響します。 これがアプローチの最初のモデルである場合は、以下のいずれかを選択します。- Experimental: モデルは開発を開始するばかりであり、入出力構造は変更される可能性があります。 このオプションは、バージョンのパッチ番号を増分します。
- 安定: モデルは実動中であり、入力または出力に大きな変化は予想されません。 このオプションは、バージョンのメジャー番号を設定します。
- カスタム: 独自の開始点を定義します。
major.minor.patch
のセマンティック・バージョン管理フォーマットに従って、新規バージョン番号を作成するには、カスタムを使用します。
注:既存のモデルのバージョンを保存する場合は、 「パッチ」、 「マイナー」、 「メジャー」、または 「カスタム」 のバージョン更新のオプションを使用してバージョンを更新できます。
オプションで、バージョンのコメントを入力します。
モデルがモデル・レコードに関連付けられたら、 「モデル・インベントリーで開く」 をクリックして、ユースケースの一部として追跡されているモデルを表示します。 モデルの詳細パネルに、アプローチとバージョンに関する情報が表示されます。
アプローチの表示、編集、および削除
モデル・ユース・ケースのアプローチを表示、編集、および削除できます。
モデル・インベントリー内のユース・ケースを開いて、アプローチを表示します。 各アプローチでは、そのアプローチで追跡されるすべてのバージョンが表示されます。
名前や説明などのアプローチの詳細を更新するには、アプローチ・アクション・メニューから 「アプローチの編集 (Edit approach)」 を選択します。
いずれかのモデル・バージョンがそのアプローチで追跡されている場合、そのアプローチを削除することはできません。 アプローチを削除するには、まずすべてのモデルを別のアプローチに移動します。 次に、アプローチ・アクション・メニューから 「削除」 を選択します。
注: ユース・ケースから最後のアプローチを削除することはできません。
この例では、モデル・ユース・ケースには、実動前の資産を追跡するためのアプローチと、実動の資産を追跡するための別のアプローチがあります。
モデルのバージョンまたは方法の変更
モデルのユース・ケースから、モデル・バージョンを編集してバージョンを更新したり、モデルを別の aproach に割り当てたりすることができます。 この手順を使用して、既存のモデルをデフォルトのアプローチから別のアプローチに割り当てたり、モデル・バージョンを更新したりします。
バージョンが数値バージョンではなく「N/A」である場合は、バージョンを変更するために API メソッド を使用する必要があります。
- モデル・ユース・ケースの 「資産」 ページで、モデル・エントリーの 「バージョンの編集」 をクリックします。
- オプションで、モデルを別のアプローチに割り当てます。 既存のアプローチを選択することも、新しいアプローチを作成することもできます。
- 次へ をクリックします。
- オプションで、バージョン番号を更新します。 事前定義されたバージョン変更のいずれかを選択するか、カスタム・バージョン番号を作成します。
- 「モデルの追跡」 をクリックして変更を保存し、モデルの更新を表示します。
API を使用したアプローチへの既存の追跡対象モデルの割り当て
クラスターが Cloud Pak for Data 4.7にアップグレードされると、デフォルト・アプローチでは、ユース・ケース内のすべての追跡対象モデルがバージョン n/a で表示されます。 AI Factsheets APIS を使用して、既存のモデルのモデル・バージョンを割り当てて管理することができます。
- 既存のモデルの新規バージョンを割り当てるための新しいアプローチを作成します。
- API メソッド
getModelUsecaseApproaches
を呼び出します。 - 応答ペイロードから、最初のステップで作成したアプローチの ID を取得します。
- API 関数
getphysicalmodels
を使用して、既存の追跡対象モデルをリストします。 このコマンドは、追跡されたすべてのモデルをユース・ケースに返します。 モデル・トラッキングの詳細では、単一行にレンダリングされるすべてのモデルのmodel_identity_key
の値が同じであることに注意してください。 - 応答ペイロードから、別のバージョンに割り当てる、モデルの行の
model_identity_key value
を取得します。 updateModelApproachAndOrVersion
関数を使用して、以下のパラメーター値を指定します。
パラメーター | 値 |
---|---|
model_usecase_asset_id | モデル・ユース・ケースの資産 ID。 ブラウザーの URL から取り出すことができます。 |
承認者 ID | 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 | モデル・ユース・ケースが作成されるカタログの ID。 ブラウザのURLからIDを取得できる。 |
要求ペイロードを構成するには、以下のステップを実行します。
API コマンド
getModelUsecaseApproaches
を使用する準備をします。要求ペイロードから、新しいモデル・バージョン用に以前に作成したアプローチの ID を取得します。 要求ペイロードは以下のようになります。
{ "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 コマンドを実行します。
指定されたモデル ID キーを持つすべての追跡対象モデルが、指定されたバージョンの新しいアプローチに割り当てられます。 新しいバージョン番号を指定して、行ごとにこのプロセスを繰り返します。