ML パッケージを管理する

ML パッケージをアップロードする

重要:

Before uploading packages, make sure they are built as specified here.

AI Center™ で ML パッケージを作成する際、パッケージ名に class、 break、 from、 finally、 global、 None などの Python の予約語を含めることはできません。必ず別の名前を選択してください。なお、パッケージ名は class <pkg-name> および import <pck-name> で使用されるため、前述の予約語は一例であり他の予約語も存在します。

作成済みのパッケージをアップロードするには、以下の手順に従います。

1. [ML パッケージ] ページで、[Zip ファイルをアップロード] ボタンをクリックします。[新しいパッケージを作成] ページが表示されます。

2. [新しいパッケージを作成] ページで、パッケージの名前を入力します。

3. [パッケージをアップロード] をクリックして目的の .zip ファイルを選択するか、パッケージの .zip ファイルを [パッケージをアップロード] フィールドにドラッグ アンド ドロップします。

4. (任意) モデルのわかりやすい説明を入力します。

   この説明は、このモデルに基づいて新しいスキルをデプロイするときに表示されます。また、[ML パッケージ] ページにも表示されます。

5. ドロップダウンから入力の種類を選択します。使用可能なオプションは以下のとおりです。

   • json
   • file
   • files

6. 任意: モデルで予期される入力のわかりやすい説明を入力します。

7. 任意: モデルが返す出力のわかりやすい説明を入力します。

   RPA 開発者は UiPath Studio で ML スキル アクティビティを使用して、これらの説明を表示できます。データ サイエンティストと開発者とのコミュニケーションを促進するために、入力および出力の形式の例を示すことをお勧めします。

8. ドロップダウンから、モデルの開発言語を選択します。使用可能なオプションは以下のとおりです。

   • Python 3.6
   • Python 3.7

9. マシン ラーニング モデルが GPU を必要とするかどうかを選択します。既定ではオフになっています。この情報は、このパッケージからスキルを作成する際の提案として表示されます。

10. モデルに対してトレーニングを有効化するかどうかを選択します。有効化した場合、以下のようになります。

    • すべてのパイプラインでパッケージを使用できます。

    • 検証手順で、パッケージに train.py ファイルが実装されているかどうかが確認されます。実装されていない場合、検証は失敗します。

      

11. [作成] をクリックしてパッケージをアップロードするか、[キャンセル] をクリックして処理を中止します。[新しいパッケージを作成] ウィンドウが閉じ、パッケージがアップロードされて、[ML パッケージ] > [ML パッケージ名] ページに詳細とともに表示されます。アップロードが反映されるまでに数分かかる場合があります。

    

パッケージの検証

サービング用

For models uploaded with the Enable Training flag inactive, when a model is uploaded, AI Fabric validates the uploaded .zip file against the requirements described here. The following three checks are performed:

1. 空でないルート フォルダーが存在すること
2. requirements.txt ファイルが存在すること
3. Main クラスを実装するルート フォルダーに main.py という名前のファイルが存在すること。このクラスは、関数 __init__ と predict を実装するために、さらに詳しく検証されます。

[ML ログ] ページに、成功または失敗のいずれであったかと、失敗の原因となったエラーが表示されます。

トレーニング用

For models uploaded with the Enable Training flag active, in addition to validating the requirements as above, AI Fabric also validates the uploaded .zip file against the requirements described here. For these packages the following two checks are performed:

1. 空でないルート フォルダーが存在すること
2. Main クラスを実装するルート フォルダーに train.py という名前のファイルが存在すること。このクラスは、__init__ 関数、および train、evaluate、save の各関数を実装するために、さらに詳しく検証されます。

[ML ログ] ページに、成功または失敗のいずれであったかと、失敗の原因となったエラーが表示されます。

ML パッケージの詳細を表示する

[ML パッケージ] > [ML パッケージ名] ページに移動するには、リスト内のパッケージをクリックします。

[バージョン] タブで詳細 (パッケージ バージョン、作成日時、変更ログ、ステータス、引数) を確認します。

[パイプライン実行] タブで、パッケージのパイプライン実行に関連する詳細 (パッケージの名前、種類、バージョン、ステータス、作成日時、期間、スコア、その他) を確認します。

バージョン管理

AI Fabric also supports versioning and version management of packages. When a package is uploaded, it's displayed as version 1.0 of that package (we say it's Major Version is 1, and Minor Version is 0). This helps with differentiating between packages uploaded by users, and packages retrained via pipelines, the latter only changing their minor version.

ML パッケージの新しいバージョンをアップロードする

アップロード済みのパッケージの新しいバージョンをアップロードする手順は次のとおりです。

1. In the ML Packages page, click ⋮ next to a package and select the Upload new version option.

   または、[ML パッケージ] > [ML パッケージ名] ページで、[新しいバージョンをアップロード] をクリックします。[次のパッケージの新しいバージョンをアップロード:] > [ML パッケージ名] ウィンドウが表示されます。ほとんどのフィールドには、最初にそのパッケージをアップロードしたときに指定した情報が既に入力されています。

2. [パッケージをアップロード] をクリックして目的の .zip ファイルを選択するか、ファイルをこのフィールドにドラッグ アンド ドロップします。

3. (任意) 以下のフィールドの既存の情報を更新します。

   • 入力の説明
   • 出力の説明
   • 言語

4. 任意: [変更ログ]フィールドに変更内容を入力します。

5. モデルが GPU を必要とするかどうかを選択します。既定ではオフになっています。

6. モデルに対してトレーニングを有効化するかどうかを選択します。

7. [作成] をクリックして既存のアップロード済みパッケージの新規バージョンをアップロードするか、[キャンセル] をクリックして処理を中止します。[パッケージをアップロード] ウィンドウが閉じ、パッケージの新規バージョンがアップロードされます。アップロードが反映されるまでに数分かかる場合があります。

   

パッケージの新規バージョンを [ML パッケージ] ページで直接確認することはできません。情報は、そのパッケージの [ML パッケージの詳細] ページに表示されます。

注:

既存のパッケージに新しいバージョンをアップロードすると、新しいメジャー バージョンが作成されます。たとえば、最初のパッケージをアップロードした場合、そのバージョンは 1.0 となります。その後新しいバージョンをアップロードすると、そのバージョンは 2.0 になります。

トレーニング パイプラインによって作成された ML パッケージのバージョン

あるパッケージ バージョンでトレーニング パイプラインまたはフル パイプラインが正常に実行されると、新しいマイナー バージョンが作成されます。たとえば、あるパッケージ (バージョン 1.0) をアップロードしてトレーニング パイプラインを開始すると、完了後に [ML パッケージの詳細] ページにバージョン 1.1 が表示されます (以下を参照)。

パッケージの引数を表示する

In the ML Package > [ML Package Name] page Version tab, click the information icon next to a package version. The Arguments for > [ML Package Name] > [ML Package Version] window is displayed.

選択したパッケージ バージョンの入力の種類と、入力および出力の説明が表示されます。値は編集できないことに注意してください。

ML パッケージを削除する

パッケージを削除できるのは、パッケージがスキル内にデプロイされておらず、それらのパッケージでパイプラインが現在実行されていない場合のみです。

1. In the ML Packages page, click ⋮ next to a package and select Delete undeployed versions. A confirmation window is displayed.
2. 確認のウィンドウで [OK] をクリックして、選択したパッケージのデプロイされていないバージョンをすべて削除します。パッケージ バージョンがスキルの一部である (アクティブである) 場合は削除されません。すべてのバージョンが非アクティブの場合、それらはすべて削除されます。

OR

1. In the ML Package > [ML Package Name] page Version tab, click ⋮ next to a package version and select Delete. A confirmation window is displayed.
2. 確認ウィンドウで [OK] をクリックして、選択したバージョンのパッケージを削除します。パッケージ バージョンがスキルの一部である (アクティブである) 場合は削除されません。このバージョンが選択したパッケージの唯一のバージョンである場合は、パッケージ自体も削除されます。