CreateSolution - Amazon Personalize
リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラーその他の参照資料

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateSolution

重要

ソリューションを作成した後は、その構成を変更することはできません。デフォルトでは、新しいソリューションはすべて自動トレーニングを使用します。自動トレーニングでは、ソリューションがアクティブである間はトレーニングコストが発生します。ソリューションの自動トレーニングを停止することはできません。不要なコストが発生しないように、終了したら必ずソリューションを削除してください。トレーニング費用の詳細については、「Amazon Personalize 料金表」を参照してください。

モデルをトレーニングするための設定を作成します (ソリューションバージョンを作成します)。この構成には、モデルトレーニングに使用するレシピと、トレーニングに使用する列や特徴変換パラメーターなどのオプションのトレーニング構成が含まれます。ソリューションの設定について詳しくは、「ソリューションの作成と設定」を参照してください。

デフォルトでは、新しいソリューションは自動トレーニングを使用して 7 日ごとにソリューションバージョンを作成します。トレーニングの頻度は変更できます。ソリューションバージョンの自動作成は、ソリューションがアクティブになってから 1 時間後に開始されます。1 時間以内にソリューションバージョンを手動で作成すると、ソリューションは最初の自動トレーニングをスキップします。詳細については、「自動トレーニングの設定」を参照してください。

performAutoTraining自動トレーニングをオフにするには、false に設定します。自動トレーニングをオフにする場合は、CreateSolutionVersionオペレーションを呼び出してソリューションバージョンを手動で作成する必要があります。

トレーニングが開始されると、ListSolutionVersionsAPI オペレーションでソリューションバージョンの Amazon リソースネーム (ARN) を取得できます。ステータスを取得するには、を使用してください。DescribeSolutionVersion

トレーニングが完了したら、GetSolutionMetricsを呼び出してモデルの精度を評価できます。満足のいくソリューションバージョンが得られたら、CreateCampaignを使用してデプロイします。キャンペーンは GetRecommendationsAPI を通じてクライアントにレコメンデーションを提供します。

注記

現時点では、Amazon Personalize は、ソリューションのハイパーパラメータ最適化のためん、hpoObjective の設定をサポートしていません。

[ステータス]

ソリューションは、次に示す状態のいずれかになります。

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -または- CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

ソリューションのステータスを確認するには、DescribeSolutionに電話してください。マニュアルトレーニングを利用する場合は、電話をかける前にステータスが ACTIVE になっている必要がありますCreateSolutionVersion。

関連 API

リクエストの構文

{
   "datasetGroupArn": "string",
   "eventType": "string",
   "name": "string",
   "performAutoML": boolean,
   "performAutoTraining": boolean,
   "performHPO": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "string" ]
      },
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventValueThreshold": "string",
      "featureTransformationParameters": { 
         "string" : "string" 
      },
      "hpoConfig": { 
         "algorithmHyperParameterRanges": { 
            "categoricalHyperParameterRanges": [ 
               { 
                  "name": "string",
                  "values": [ "string" ]
               }
            ],
            "continuousHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ],
            "integerHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ]
         },
         "hpoObjective": { 
            "metricName": "string",
            "metricRegex": "string",
            "type": "string"
         },
         "hpoResourceConfig": { 
            "maxNumberOfTrainingJobs": "string",
            "maxParallelTrainingJobs": "string"
         }
      },
      "optimizationObjective": { 
         "itemAttribute": "string",
         "objectiveSensitivity": "string"
      },
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

リクエストパラメータ

リクエストは以下の JSON 形式のデータを受け入れます。

datasetGroupArn

トレーニングデータを提供するデータセットグループの Amazon リソースネーム (ARN)。

型: 文字列

長さの制限：最大長は 256 です。

パターン：arn:([a-z\d-]+):personalize:.*:.*:.+

必須：はい

eventType

(EVENT_TYPE スキーマフィールドを使用して) 複数のイベントタイプがある場合、このパラメータは、モデルのトレーニングに使用されるイベントタイプ (例えば、「クリック」または「いいね」) を指定します。

eventType を指定しない場合、Amazon Personalize は、タイプにかかわらず、同じ重みでトレーニングするためにすべてのインタラクションを使用します。

型: 文字列

長さの制限：最大長は 256 です。

必須: いいえ

name

ソリューションの名前。

型: 文字列

長さの制限：最小長は 1 です。最大長は 63 です。

Pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

必須：はい

performAutoML
重要

自動機械学習の有効化は推奨されません。代わりに、利用可能な Amazon Personalize のレシピにユースケースをマッチさせます。詳細については、の「Choosing a recipe」を参照してください。

自動機械学習 (AutoML) を実行するかどうか。デフォルトは false です。この場合、recipeArn を指定する必要があります。

true に設定すると、Amazon Personalize はトレーニングデータを分析し、最適な USER_PERSONALIZATION レシピとハイパーパラメータを選択します。この場合、recipeArn を省略する必要があります。Amazon Personalize は、ハイパーパラメータにさまざまな値を使用してテストを実行することにより、最適なレシピを決定します。AutoML では、特定のレシピを選択する場合と比較して、トレーニングプロセスに長時間を要します。

型: ブール値

必須: いいえ

performAutoTraining

ソリューションが自動トレーニングを使用して新しいソリューションバージョン (トレーニング済みモデル) を作成するかどうか。Trueデフォルトはで、ソリューションは 7 日ごとに新しいソリューションバージョンを自動的に作成します。AutoTrainingConfigソリューション構成の一部として a schedulingExpression を指定することで、トレーニングの頻度を変更できます。自動学習について詳しくは、「自動学習の設定」を参照してください。

ソリューションバージョンの自動作成は、ソリューションがアクティブになってから 1 時間後に開始されます。1 時間以内にソリューションバージョンを手動で作成すると、ソリューションは最初の自動トレーニングをスキップします。

トレーニングが開始されると、ListSolutionVersionsAPI オペレーションでソリューションバージョンの Amazon リソースネーム (ARN) を取得できます。ステータスを取得するには、を使用してください。DescribeSolutionVersion

型: ブール値

必須: いいえ

performHPO

指定または選択したレシピでハイパーパラメータ最適化 (HPO) を実行するかどうか。デフォルトは false です。

AutoML を実行する場合、このパラメータは常に true となります。false に設定しないでください。

型: ブール値

必須: いいえ

recipeArn

モデルトレーニングに使用するレシピの Amazon リソースネーム (ARN)。これは、performAutoML が false の場合に必要です。Amazon Personalize のさまざまなレシピとその ARN の詳細については、「Choosing a recipe」を参照してください。

型: 文字列

長さの制限：最大長は 256 です。

パターン: arn:([a-z\d-]+):personalize:.*:.*:.+

必須: いいえ

solutionConfig

ソリューションで使用する設定。performAutoML が true に設定されている場合、Amazon Personalize はソリューション設定の autoMLConfig セクションのみを評価します。

注記

現時点では、Amazon Personalize は hpoObjective の設定をサポートしていません。

タイプ：SolutionConfig オブジェクト

必須: いいえ

tags

ソリューションに適用するタグのリスト。

タイプ：Tag オブジェクトの配列

配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。

必須: いいえ

レスポンスの構文

{
   "solutionArn": "string"
}

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

solutionArn

ソリューションの ARN。

型: 文字列

長さの制限：最大長は 256 です。

パターン：arn:([a-z\d-]+):personalize:.*:.*:.+

エラー

InvalidInputException

フィールドまたはパラメータに有効な値を指定します。

HTTP ステータスコード：400

LimitExceededException

1 秒あたりのリクエスト数の上限を超えています。

HTTP ステータスコード：400

ResourceAlreadyExistsException

指定したリソースはすでに存在しています。

HTTP ステータスコード：400

ResourceInUseException

指定されたリソースは使用中です。

HTTP ステータスコード：400

ResourceNotFoundException

指定されたリソースが見つかりませんでした。

HTTP ステータスコード：400

TooManyTagsException

このリソースに適用できるタグの最大数を超過しています。

HTTP ステータスコード：400

その他の参照資料

この API を言語固有の AWS SDK で使用する方法の詳細については、以下を参照してください。