匯入封裝的方式(UI)

本教學課程提供如何使用提供的零售銷售範例來設定和匯入封裝方式的見解。 在本教學課程結束時,您將準備好在Adobe Experience Platform中建立、訓練和評估模型 Data Science Workspace。

必要條件

本教學課程需要以Docker影像URL格式封裝的配方。 如需詳細資訊,請參 閱教學課程,瞭解如何將來源檔案封裝至配方

UI工作流程

將封裝的方式匯入 Data Science Workspace 時,需要特定的方式設定,並編譯為單一JavaScript物件註解(JSON)檔案,此方式組態編譯稱為設定檔案。 具有一組特定配置的打包配方稱為配方實例。 一個配方可用於在中建立多個配方實例 Data Science Workspace。

用於導入包配方的工作流包括以下步驟:

設定方式

中的每個配方 Data Science Workspace 實例都附帶一組配置,這些配置定製了配方實例以適合特定使用案例。 配置檔案定義使用此配方實例建立的模型的預設培訓和計分行為。

注意

配置檔案是特定於配方和大小寫的。

以下是顯示零售銷售方式預設訓練和評分行為的範例設定檔案。

[
    {
        "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可確保您建立的資源具有正確的命名空間,並且包含在IMS組織中。 請依照此處的步驟 ,尋找您的租用戶ID。
ACP_DSW_TRAINING_XDM_SCHEMA 字串 用於訓練模型的輸入模式。 在UI中匯入時保留此空白,在使用API匯入時,以訓練架構ID取代。
evaluation.labelColumn 字串 評估視覺化的欄標籤。
evaluation.metrics 字串 用於評估模型的評估度量的逗號分隔清單。
ACP_DSW_SCORING_RESULTS_XDM_SCHEMA 字串 用於計分模型的輸出方案。 在UI中匯入時保留此空白,在使用API匯入時,以計分SchemaID取代。

在本教學課程中,您可以將「參考」中「零售銷售」配方的預設配置檔案 Data Science Workspace 保留為原樣。

導入基於Docker的配方- Python

首先,導覽並選 UI左上角的「工作流程 Platform 」。 接著,選取「匯 入方式 」,然後按一 下「啟動」

此時會 顯示 「匯入方式 ​」工作流程的「設定」頁面。 輸入處方的名稱和說明,然後在右 上角 選擇「下一步」。

配置工作流

注意

在「將 來源檔案封裝為配方」教學課程中 ,使用Python來源檔案建立零售銷售配方時,會提供Docker URL。

在「選擇來源 」頁上,將與使用來源檔案建立的封裝方式對應的Docker URL貼到「來源URL」欄位中, 即可貼到「 Python 來源URL ​」欄位中。 接著,透過拖放方式匯入提供的設定檔案,或使用檔案系統瀏 覽器。 可在中找到提供的配置檔案 experience-platform-dsw-reference/recipes/python/retail/retail.config.json。 在「 Runtime 」下拉式清單中選取「 Python 」,並在「 Type ​Drop」中選取「分類」。 一切填妥後,按一下右 上角的 「下一步」,繼續 管理結構

注意

類型支援 分類回歸。 如果模型未落在其中一種類型下,請選擇「自 訂」

接著,在「管理結構」一節下選擇「零售銷售」輸入和輸出結構,這些結構是使用建立零售銷售結構和資料集教程中提供的 引導指令碼建立的

在「功 能管理 」區段下,按一下架構檢視器中的租用戶識別碼,以展開「零售銷售」輸入架構。 通過反白顯示所需特徵,並在右側的「欄位屬性」(Field Properties)窗口中選擇「輸入特徵」( Input Feature )或「目標特徵」( Target Feature ),來選擇輸入和輸 出特徵 。 在本教學課程中,請將 weeklySales 設為 Target功能 ,而將其他項目設為 輸入功能。 按一 下「下一步 」以檢閱新設定的方式。

視需要檢閱方式、新增、修改或移除組態。 按一 下「完成 」以建立方式。

繼續下 一步 ,瞭解如何使用新建立的零售 Data Science Workspace 銷售方式建立模型。

導入基於Docker的配方- R

首先,導覽並選 UI左上角的「工作流程 Platform 」。 接著,選取「匯 入方式 」,然後按一 下「啟動」

此時會 顯示 「匯入方式 ​」工作流程的「設定」頁面。 輸入處方的名稱和說明,然後在右 上角 選擇「下一步」。

配置工作流

注意

在將來 源檔案打包到配方教程中 ,在使用R源檔案構建零售銷售配方的結束處提供了Docker URL。

在「選擇源 」頁上,將與使用R源檔案構建的打包方式對應的Docker URL貼上到「源URL」 欄位中 ​。 接著,透過拖放方式匯入提供的設定檔案,或使用檔案系統瀏 覽器。 可在中找到提供的配置檔案 experience-platform-dsw-reference/recipes/R/Retail\ -\ GradientBoosting/retail.config.json。 在「 Runtime 」下拉式清單中選取「R 」,在「Type drop」中選取「Classification 」。 一切填妥後,按一下右 上角的 「下一步」,繼續 管理結構

注意

類型 支援 分類回歸。 如果模型未落在其中一種類型下,請選擇「自 訂」

接著,在「管理結構」一節下選擇「零售銷售」輸入和輸出結構,這些結構是使用建立零售銷售結構和資料集教程中提供的 引導指令碼建立的

在「功 能管理 」區段下,按一下架構檢視器中的租用戶識別碼,以展開「零售銷售」輸入架構。 通過反白顯示所需特徵,並在右側的「欄位屬性」(Field Properties)窗口中選擇「輸入特徵」( Input Feature )或「目標特徵」( Target Feature ),來選擇輸入和輸 出特徵 。 在本教學課程中,請將 weeklySales 設為 Target功能 ,而將其他項目設為 輸入功能。 按一 下「下一 步」以檢閱新的「已設定」方式。

視需要檢閱方式、新增、修改或移除組態。 按一 下「完成 」以建立方式。

繼續下 一步 ,瞭解如何使用新建立的零售 Data Science Workspace 銷售方式建立模型。

匯入以Docker為基礎的方式- PySpark

首先,導覽並選 UI左上角的「工作流程 Platform 」。 接著,選取「匯 入方式 」,然後按一 下「啟動」

此時會 顯示 「匯入方式 ​」工作流程的「設定」頁面。 輸入處方的名稱和說明,然後在右上角 選擇 「下一步」以繼續。

配置工作流

注意

在將來 源檔案封裝至配方教學課程中 ,使用PySpark來源檔案建立零售銷售配方時,會提供Docker URL。

在「選取來源 」頁面上,將對應於使用PySpark來源檔案建立之封裝方式的Docker URL貼入「來源URL」欄 位中 ​。 接著,透過拖放方式匯入提供的設定檔案,或使用檔案系統瀏 覽器。 可在中找到提供的配置檔案 experience-platform-dsw-reference/recipes/pyspark/retail/pipeline.json。 在「 執行階段 」下拉式清單中選 取PySpark 。 在選取PySpark執行時期後,預設對象會自動填入 Docker。 接著,在「 類型 」下拉式清 單中選 取「分類」。 一切填妥後,按一下右 上角的 「下一步」,繼續 管理結構

注意

類型 支援 分類回歸。 如果模型未落在其中一種類型下,請選擇「自 訂」

接著,在「管理結構」一節下選擇「零售銷售」輸入和輸出結構,這些結構是使用建立零售銷售結構和資料集教程中提供的 引導指令碼建立的

在「功 能管理 」區段下,按一下架構檢視器中的租用戶識別碼,以展開「零售銷售」輸入架構。 通過反白顯示所需特徵,並在右側的「欄位屬性」(Field Properties)窗口中選擇「輸入特徵」( Input Feature )或「目標特徵」( Target Feature ),來選擇輸入和輸 出特徵 。 在本教學課程中,請將 weeklySales 設為 Target功能 ,而將其他項目設為 輸入功能。 按一 下「下一步 」以檢閱新設定的方式。

視需要檢閱方式、新增、修改或移除組態。 按一 下「完成 」以建立方式。

繼續下 一步 ,瞭解如何使用新建立的零售 Data Science Workspace 銷售方式建立模型。

導入基於Docker的配方- Scala

首先,導覽並選 UI左上角的「工作流程 Platform 」。 接著,選取「匯 入方式 」,然後按一 下「啟動」

此時會 顯示 「匯入方式 ​」工作流程的「設定」頁面。 輸入處方的名稱和說明,然後在右上角 選擇 「下一步」以繼續。

配置工作流

注意

在將來 源檔案封裝成配方教學課程中 ,使用Scala(Spark)來源檔案建立零售銷售配方時,會提供Docker URL。

在「選擇源 ​」頁上,將與使用Scala源檔案構建的打包方式對應的Docker URL貼上到「源URL」欄位中。 接著,透過拖放方式匯入提供的設定檔案,或使用檔案系統瀏覽器。 可在中找到提供的配置檔案 experience-platform-dsw-reference/recipes/scala/retail/pipelineservice.json。 在「 Runtime 」下拉式清 單中選 取Spark。 一旦選 Spark 取執行階段,預設對象會自動填入 Docker。 接著,從「 類型 」下拉式選 取「回歸 」。 一切填妥後,按一下右 上角的 「下一步」,繼續 管理結構

注意

類型支援 分類回歸。 如果模型未落在其中一種類型下,請選擇「自 訂」

接著,在「管理結構」一節下選擇「零售銷售」輸入和輸出結構,這些結構是使用建立零售銷售結構和資料集教程中提供的 引導指令碼建立的

在「功 能管理 」區段下,按一下架構檢視器中的租用戶識別碼,以展開「零售銷售」輸入架構。 通過反白顯示所需特徵,並在右側的「欄位屬性」(Field Properties)窗口中選擇「輸入特徵」( Input Feature )或「目標特徵」( Target Feature ),來選擇輸入和輸 出特徵 。 在本教學課程中,請將「weeklySales」設為「 Target功能 」,並將其他項目設為「輸 入功能」。 按一 下「下一步 」以檢閱新設定的方式。

視需要檢閱方式、新增、修改或移除組態。 按一 下「完成 」以建立方式。

繼續下 一步 ,瞭解如何使用新建立的零售 Data Science Workspace 銷售方式建立模型。

下一步

本教學課程提供如何設定方式並將其匯入的見解 Data Science Workspace。 您現在可以使用新建立的方式建立、訓練和評估模型。

本頁內容