Data Science Workspace UI へのパッケージ化されたレシピの読み込み

NOTE
Data Science Workspaceは購入できなくなりました。
このドキュメントは、Data Science Workspaceの以前の使用権限を持つ既存のお客様を対象としています。

このチュートリアルでは、提供された「小売売上」の例を使用してパッケージ化されたレシピを設定およびインポートする方法に関するインサイトを提供します。このチュートリアルを終了すると、Adobe Experience Platform Data Science Workspace でモデルを作成、トレーニング、評価する準備が整います。

前提条件

このチュートリアルでは、Docker イメージ URL の形式でパッケージ化されたレシピが必要です。 詳しくは、ソースファイルをレシピにパッケージ化する方法に関するチュートリアルを参照してください。

UI ワークフロー

パッケージ化されたレシピを Data Science Workspace に読み込むには、特定のレシピ設定が必要で、そのレシピ設定は単一のJavaScript Object Notation (JSON)ファイルにコンパイルされます。このレシピ設定のコンパイルは、設定ファイルと呼ばれます。 特定の設定セットを使用してパッケージ化されたレシピは、レシピインスタンスと呼ばれます。 1 つのレシピを使用して、Data Science Workspace で多数のレシピインスタンスを作成できます。

パッケージレシピをインポートするワークフローは、次の手順で構成されます。

レシピの設定 configure

Data Science Workspace のすべてのレシピインスタンスには、特定のユースケースに合わせてレシピインスタンスを調整する一連の設定が付属しています。 設定ファイルは、このレシピインスタンスを使用して作成されたモデルのデフォルトのトレーニングおよびスコアリング動作を定義します。

NOTE
設定ファイルは、レシピとケースに固有です。

以下に、「小売売上」レシピのデフォルトのトレーニングとスコアリングの動作を示す設定ファイルの例を示します。

[
    {
        "name": "train",
        "parameters": [
            {
                "key": "learning_rate",
                "value": "0.1"
            },
            {
                "key": "n_estimators",
                "value": "100"
            },
            {
                "key": "max_depth",
                "value": "3"
            },
            {
                "key": "ACP_DSW_INPUT_FEATURES",
                "value": "date,store,storeType,storeSize,temperature,regionalFuelPrice,markdown,cpi,unemployment,isHoliday"
            },
            {
                "key": "ACP_DSW_TARGET_FEATURES",
                "value": "weeklySales"
            },
            {
                "key": "ACP_DSW_FEATURE_UPDATE_SUPPORT",
                "value": false
            },
            {
                "key": "tenantId",
                "value": "_{TENANT_ID}"
            },
            {
                "key": "ACP_DSW_TRAINING_XDM_SCHEMA",
                "value": "{SEE BELOW FOR DETAILS}"
            },
            {
                "key": "evaluation.labelColumn",
                "value": "weeklySalesAhead"
            },
            {
                "key": "evaluation.metrics",
                "value": "MAPE,MAE,RMSE,MASE"
            }
        ]
    },
    {
        "name": "score",
        "parameters": [
            {
                "key": "tenantId",
                "value": "_{TENANT_ID}"
            },
            {
                "key":"ACP_DSW_SCORING_RESULTS_XDM_SCHEMA",
                "value":"{SEE BELOW FOR DETAILS}"
            }
        ]
    }
]
パラメーターキー
タイプ
説明
learning_rate
数値
グラデーション乗算用のスカラー
n_estimators
数値
ランダムフォレスト分類子のフォレスト内のツリーの数
max_depth
数値
ランダムフォレスト分類子のツリーの最大深さ
ACP_DSW_INPUT_FEATURES
文字列
コンマ区切りの入力スキーマ属性のリスト
ACP_DSW_TARGET_FEATURES
文字列
コンマ区切りの出力スキーマ属性のリスト
ACP_DSW_FEATURE_UPDATE_SUPPORT
Boolean
入出力機能が変更可能かどうかを特定します。
tenantId
文字列
この ID により、作成したリソースの名前空間が適切に設定され、組織内に含まれるようになります。 テナント ID を検索するには、こちらの手順に従います。
ACP_DSW_TRAINING_XDM_SCHEMA
文字列
モデルのトレーニングに使用する入力スキーマ。UI にインポートする場合は空のままにし、API を使用してインポートする場合はトレーニングスキーマ ID に置き換えます。
evaluation.labelColumn
文字列
評価のビジュアライゼーションの列ラベル
evaluation.metrics
文字列
モデルの評価に使用される評価指標のカンマ区切りのリスト
ACP_DSW_SCORING_RESULTS_XDM_SCHEMA
文字列
モデルのスコアリングに使用される出力スキーマUI にインポートする場合は空のままにし、API を使用してインポートする場合はスコアリングスキーマ ID に置き換えます。

このチュートリアルでは、小売販売レシピのデフォルトの設定ファイルをそのままの状態で Data Science Workspace Reference に残すことができます。

Docker ベースのレシピの読み込み – Python python

まず、Workflows UI の左上にある Experience Platform に移動して選択します。 次に、「レシピを読み込み を選択し から Launch を選択します。

レシピを読み込み ワークフローの 設定 ページが表示されます。 レシピの名前と説明を入力し、右上隅の「Next」を選択します。

​ ワークフローの設定 ​

NOTE
ソースファイルをレシピにパッケージ化』チュートリアルでは、Python ソースファイルを使用して Retail Sales レシピを作成する最後に Docker URL が提供されていました。

ソースを選択 ページが表示されたら、「ソース」フィールドに、Python ソースファイルを使用して作成されたパッケージ化されたレシピに対応する Docker URL を貼り付 Source URL ます。 次に、指定した設定ファイルをドラッグ&ドロップするか、ファイルシステムの​ ブラウザー ​を使用してインポートします。提供された設定ファイルは experience-platform-dsw-reference/recipes/python/retail/retail.config.json にあります。「Python ランタイム 」ドロップダウンで「」を選択し、「Classification タイプ 」ドロップダウンで「」を選択します。 すべてが入力されたら、右上隅の Next を選択して スキーマの管理 に進みます。

NOTE
タイプは Classification および Regression をサポートします。 モデルがこれらのタイプのいずれかに該当しない場合は、「Custom」を選択します。

次に、「スキーマの管理 のセクションで小売販売の入力および出力スキーマを選択します。これらは、「小売販売のスキーマおよびデータセットの作成 ​ チュートリアルで提供される bootstrap スクリプトを使用して作成され ​ した。

機能管理」セクションで、スキーマビューアのテナント ID を選択して、小売販売入力スキーマを展開します。 目的のフィーチャをハイライト表示し、右の Input Feature ウィンドウで Target Feature または Field Properties を選択して、入力フィーチャと出力フィーチャを選択します。 このチュートリアルでは、weeklySalesTarget Feature として、それ以外はすべてをとして設定し Input Feature す。 「Next」を選択して、新しく設定したレシピを確認します。

レシピを確認し、必要に応じて、設定を追加、変更または削除します。「Finish」を選択して、レシピを作成します。

​ 次の手順 ​ に進み、新しく作成した小売販売レシピを使用して Data Science Workspace でモデルを作成する方法を確認します。

Docker ベースのレシピを読み込み – R r

まず、Workflows UI の左上にある Experience Platform に移動して選択します。 次に、「レシピを読み込み を選択し から Launch を選択します。

レシピを読み込み ワークフローの 設定 ページが表示されます。 レシピの名前と説明を入力し、右上隅の「Next」を選択します。

​ ワークフローの設定 ​

NOTE
ソースファイルをレシピにパッケージ化」チュートリアルでは、R ソースファイルを使用して Retail Sales レシピを作成する最後に Docker URL が提供されていました。

ソースを選択 ページが表示されたら、「ソース」フィールドの R ソースファイルを使用して作成されたパッケージ化されたレシピに対応する Docker URL を貼り付 Source URL ます。 次に、指定した設定ファイルをドラッグ&ドロップするか、ファイルシステムの​ ブラウザー ​を使用してインポートします。提供された設定ファイルは experience-platform-dsw-reference/recipes/R/Retail\ -\ GradientBoosting/retail.config.json にあります。「R ランタイム 」ドロップダウンで「」を選択し、「Classification タイプ 」ドロップダウンで「」を選択します。 すべてが入力されたら、右上隅の Next を選択して スキーマの管理 に進みます。

NOTE
タイプ は、ClassificationRegression をサポートします。 モデルがこれらのタイプのいずれかに該当しない場合は、「Custom」を選択します。

次に、「スキーマの管理 のセクションで小売販売の入力および出力スキーマを選択します。これらは、「小売販売のスキーマおよびデータセットの作成 ​ チュートリアルで提供される bootstrap スクリプトを使用して作成され ​ した。

機能管理」セクションで、スキーマビューアのテナント ID を選択して、小売販売入力スキーマを展開します。 目的のフィーチャをハイライト表示し、右の Input Feature ウィンドウで Target Feature または Field Properties を選択して、入力フィーチャと出力フィーチャを選択します。 このチュートリアルでは、weeklySalesTarget Feature として、それ以外はすべてをとして設定し Input Feature す。 「Next」を選択して、新しい設定済みレシピを確認します。

レシピを確認し、必要に応じて、設定を追加、変更または削除します。「終了」を選択して、レシピを作成します。

​ 次の手順 ​ に進み、新しく作成した小売販売レシピを使用して Data Science Workspace でモデルを作成する方法を確認します。

Docker ベースのレシピを読み込む – PySpark pyspark

まず、Workflows UI の左上にある Experience Platform に移動して選択します。 次に、「レシピを読み込み を選択し から Launch を選択します。

レシピを読み込み ワークフローの 設定 ページが表示されます。 レシピの名前と説明を入力し、右上隅の「Next」を選択して続行します。

​ ワークフローの設定 ​

NOTE
​ ソースファイルをレシピにパッケージ化 ​ チュートリアルでは、PySpark ソースファイルを使用して小売販売レシピを作成する際の最後に、Docker URL が提供されました。

ソースを選択 ページが表示されたら、「Source URL」フィールドに、PySpark ソースファイルを使用して作成されたパッケージ化されたレシピに対応する Docker URL を貼り付けます。 次に、指定した設定ファイルをドラッグ&ドロップするか、ファイルシステムの​ ブラウザー ​を使用してインポートします。提供された設定ファイルは experience-platform-dsw-reference/recipes/pyspark/retail/pipeline.json にあります。「PySpark ランタイム 」ドロップダウンで「」を選択します。 PySpark ランタイムが選択されると、デフォルトのアーティファクトが Docker に自動入力されます。 次に、「タイプ Classification ドロップダウンで「 選択します。 すべてが入力されたら、右上隅の Next を選択して スキーマの管理 に進みます。

NOTE
タイプ は、ClassificationRegression をサポートします。 モデルがこれらのタイプのいずれかに該当しない場合は、「Custom」を選択します。

次に、スキーマの管理 セレクターを使用して小売販売の入力および出力スキーマを選択します。スキーマは、「小売販売のスキーマおよびデータセットの作成 ​ チュートリアルで提供される bootstrap スクリプトを使用して作成され ​ した。

​ スキーマの管理 ​

機能管理」セクションで、スキーマビューアのテナント ID を選択して、小売販売入力スキーマを展開します。 目的のフィーチャをハイライト表示し、右の Input Feature ウィンドウで Target Feature または Field Properties を選択して、入力フィーチャと出力フィーチャを選択します。 このチュートリアルでは、weeklySalesTarget Feature として、それ以外はすべてをとして設定し Input Feature す。 「Next」を選択して、新しく設定したレシピを確認します。

レシピを確認し、必要に応じて、設定を追加、変更または削除します。「Finish」を選択して、レシピを作成します。

​ 次の手順 ​ に進み、新しく作成した小売販売レシピを使用して Data Science Workspace でモデルを作成する方法を確認します。

Docker ベースのレシピの読み込み – Scala scala

まず、Workflows UI の左上にある Experience Platform に移動して選択します。 次に、「レシピを読み込み を選択し から Launch を選択します。

レシピを読み込み ワークフローの 設定 ページが表示されます。 レシピの名前と説明を入力し、右上隅の「Next」を選択して続行します。

​ ワークフローの設定 ​

NOTE
​ ソースファイルをレシピにパッケージ化 ​ チュートリアルでは、Scala (Spark)ソースファイルを使用して小売販売レシピを作成する際の最後に Docker URL が提供されました。

ソースを選択 ページが表示されたら、Scala ソースファイルを使用して作成されたパッケージ化されたレシピに対応する Docker URL を「Source URL」フィールドに貼り付けます。 次に、指定した設定ファイルをドラッグ&ドロップで読み込むか、ファイルシステムブラウザーを使用します。 提供された設定ファイルはexperience-platform-dsw-reference/recipes/scala/retail/pipelineservice.jsonにあります。「Spark ランタイム 」ドロップダウンで「」を選択します。 Spark ランタイムが選択されると、デフォルトのアーティファクトが Docker に自動入力されます。 次に、「タイプ Regression ドロップダウンから「 選択します。 すべてが入力されたら、右上隅の Next を選択して スキーマの管理 に進みます。

NOTE
タイプは Classification および Regression をサポートします。 モデルがこれらのタイプのいずれかに該当しない場合は、「Custom」を選択します。

次に、スキーマの管理 セレクターを使用して小売販売の入力および出力スキーマを選択します。スキーマは、「小売販売のスキーマおよびデータセットの作成 ​ チュートリアルで提供される bootstrap スクリプトを使用して作成され ​ した。

​ スキーマの管理 ​

機能管理」セクションで、スキーマビューアのテナント ID を選択して、小売販売入力スキーマを展開します。 目的のフィーチャをハイライト表示し、右の Input Feature ウィンドウで Target Feature または Field Properties を選択して、入力フィーチャと出力フィーチャを選択します。 このチュートリアルでは、「weeklySales」を Target Feature として設定し、それ以外はすべて Input Feature として設定します。 「Next」を選択して、新しく設定したレシピを確認します。

レシピを確認し、必要に応じて、設定を追加、変更または削除します。「Finish」を選択して、レシピを作成します。

​ 次の手順 ​ に進み、新しく作成した小売販売レシピを使用して Data Science Workspace でモデルを作成する方法を確認します。

次の手順 next-steps

このチュートリアルでは、レシピの Data Science Workspace への設定と読み込みに関するinsightを説明しました。 新しく作成したレシピを使用して、モデルの作成、トレーニング、評価をおこなうことができるようになりました。

recommendation-more-help
experience-platform-help-data-science-workspace