建立解決方案 (AWS SDK)

重要

建立解決方案之後，就無法變更其設定。根據預設，所有新的解決方案都使用自動訓練。透過自動訓練，您可以在解決方案啟用時產生訓練費用。為避免不必要的成本，請務必在完成後刪除解決方案。如需有關訓練費用的資訊，請參閱 Amazon Personalize 定價。

若要使用 AWS SDK 建立解決方案，請使用 CreateSolution API 作業。下列程式碼會示範如何建立使用自動訓練的解決方案。它每五天自動創建一個新的解決方案版本。

若要使用程式碼，請更新程式碼以為解決方案命名、指定資料集群組的 Amazon 資源名稱 (ARN)、選擇性地變更訓練頻率，並指定您要使用之配方的 ARN。如需配方的詳細資訊，請參閱選擇食譜。

SDK for Python (Boto3)

import boto3

personalize = boto3.client('personalize')

create_solution_response = personalize.create_solution(
  name = 'solution name',
  recipeArn = 'recipe ARN',
  datasetGroupArn = 'dataset group ARN',
  performAutoTraining = True,
  solutionConfig = {
    "autoTrainingConfig": {
      "schedulingExpression": "rate(5 days)"
    }
  }
)
solution_arn = create_solution_response['solutionArn']
print('solution_arn: ', solution_arn)

SDK for JavaScript v3

import {
  CreateSolutionCommand,
  PersonalizeClient,
} from "@aws-sdk/client-personalize";

// create client
const personalizeClient = new PersonalizeClient({ region: "REGION" });

// set the solution parameters
export const solutionParam = {
  datasetGroupArn: "DATASET_GROUP_ARN" /* required */,
  recipeArn: "RECIPE_ARN" /* required */,
  name: "SOLUTION_NAME" /* required */,
  performAutoTraining: true /* optional, default is true */,
  solutionConfig: {
    autoTrainingConfig: {
      schedulingExpression:
        "rate(5 days)" /* optional, default is every 7 days */,
    },
  },
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new CreateSolutionCommand(solutionParam)
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

• 我們建議您使用自動訓練。它可讓您更輕鬆地維護和改善建議相關性。根據預設，所有新的解決方案都使用自動訓練。預設訓練頻率為每 7 天一次。訓練頻率取決於您的業務需求、使用的配方，以及匯入資料的頻率。如需詳細資訊，請參閱 設定自動訓練。

• 根據您的方案，您可以修改程式碼以設定方案特定屬性和超參數 (請參閱超參數和 HPO)、設定用於訓練的欄 (請參閱設定訓練時使用的資料行 (AWS SDK))，或篩選用於訓練的項目互動資料 (請參閱選擇用於訓練的項目互動資料)。

• 如果您使用用戶個性化配方或個性化排名食譜方案，除了相關性之外，您還可以針對目標最佳化解決方案。如需詳細資訊，請參閱 針對額外目標最佳化解決方案。

建立解決方案之後，請記錄解決方案 ARN 以備 future 使用。透過自動訓練，解決方案版本建立會在解決方案為 ACTIVE 之後的一個開始。如果您在一小時內手動建立解決方案版本，則解決方案會略過第一個自動訓練。訓練開始後，您可以透過版ListSolution本 API 作業取得解決方案版本的 Amazon 資源名稱 (ARN)。若要取得其狀態，請使用DescribeSolution版本 API 作業。

當解決方案版本為 ACTIVE 時，您就可以使用它來取得建議。您如何使用作用中的解決方案版本取決於您如何取得建議：

• 如需即時建議，您可以透過 Amazon Personalize 行銷活動部署作用中解決方案版本。您可以使用促銷活動來取得使用者的建議。請參閱建立行銷活動。

• 對於批次建議，您可以在建立批次推論工作或批次區段工作時指定 ACTIVE 解決方案版本。請參閱Batch 建議和使用者區段 (自訂資源)。