Data Science Workspace UIでのパッケージ化されたレシピのインポート

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

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

前提条件

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

UI ワークフロー

パッケージ化されたレシピをData Science Workspaceに読み込むには、特定のレシピ設定が必要で、1つの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
ブール
入出力機能が変更可能かどうかを特定します。
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参照に残すことができます。

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

最初に、Experience Platform UIの左上にある​ ワークフロー ​を移動して選択します。 次に、レシピの読み込み​を選択し、起動​を選択します。

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

​ ワークフローの設定

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

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

NOTE
型は​ 分類 ​と​ 回帰 ​をサポートしています。 モデルがこれらのタイプのいずれかに該当しない場合は、カスタム​を選択します。

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

機能管理 セクションで、スキーマビューアでテナント IDを選択して、小売販売入力スキーマを展開します。 目的の機能を強調表示し、右側の​フィールドプロパティ ウィンドウで​ 入力機能 ​または​ ターゲット機能 ​のいずれかを選択して、入力機能と出力機能を選択します。 このチュートリアルでは、weeklySales​を​ ターゲット機能 ​として、それ以外のすべてを​ 入力機能 ​として設定します。 次へ​を選択して、新しく設定したレシピを確認します。

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

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

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

最初に、Experience Platform UIの左上にある​ ワークフロー ​を移動して選択します。 次に、レシピの読み込み​を選択し、起動​を選択します。

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

​ ワークフローの設定

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

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

NOTE
Type​は​ 分類 ​と​ 回帰 ​をサポートしています。 モデルがこれらのタイプのいずれかに該当しない場合は、カスタム​を選択します。

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

機能管理 セクションで、スキーマビューアでテナント IDを選択して、小売販売入力スキーマを展開します。 目的の機能を強調表示し、右側の​フィールドプロパティ ウィンドウで​ 入力機能 ​または​ ターゲット機能 ​のいずれかを選択して、入力機能と出力機能を選択します。 このチュートリアルでは、weeklySales​を​ ターゲット機能 ​として、それ以外のすべてを​ 入力機能 ​として設定します。 次へ​を選択して、新しい設定済みレシピを確認します。

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

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

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

最初に、Experience Platform UIの左上にある​ ワークフロー ​を移動して選択します。 次に、レシピの読み込み​を選択し、起動​を選択します。

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

​ ワークフローの設定

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

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

NOTE
Type​は​ 分類 ​と​ 回帰 ​をサポートしています。 モデルがこれらのタイプのいずれかに該当しない場合は、カスタム​を選択します。

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

​ スキーマの管理

機能管理 セクションで、スキーマビューアでテナント IDを選択して、小売販売入力スキーマを展開します。 目的の機能を強調表示し、右側の​フィールドプロパティ ウィンドウで​ 入力機能 ​または​ ターゲット機能 ​のいずれかを選択して、入力機能と出力機能を選択します。 このチュートリアルでは、weeklySales​を​ ターゲット機能 ​として、それ以外のすべてを​ 入力機能 ​として設定します。 次へ​を選択して、新しく設定したレシピを確認します。

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

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

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

最初に、Experience Platform UIの左上にある​ ワークフロー ​を移動して選択します。 次に、レシピの読み込み​を選択し、起動​を選択します。

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

​ ワークフローの設定

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

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

NOTE
型は​ 分類 ​と​ 回帰 ​をサポートしています。 モデルがこれらのタイプのいずれかに該当しない場合は、カスタム​を選択します。

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

​ スキーマの管理

機能管理 セクションで、スキーマビューアでテナント IDを選択して、小売販売入力スキーマを展開します。 目的の機能を強調表示し、右側の​フィールドプロパティ ウィンドウで​ 入力機能 ​または​ ターゲット機能 ​のいずれかを選択して、入力機能と出力機能を選択します。 このチュートリアルの目的では、「weeklySales」を​ ターゲット機能 ​として設定し、それ以外のすべてを​ 入力機能 ​として設定します。 次へ​を選択して、新しく設定したレシピを確認します。

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

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

次の手順 next-steps

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

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