リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

CreateSolution

モデルをトレーニングするための設定を作成します。トレーニングされたモデルは、ソリューションとも呼ばれます。設定が作成されたら、を呼び出してモデルをトレーニング (ソリューションを作成) します。CreateSolutionVersionオペレーション. CreateSolutionVersion を呼び出すたびに、ソリューションの新しいバージョンが作成されます。

ソリューションバージョンを作成した後、を呼び出してその正確性を確認します。GetSolutionMetrics。バージョンに問題がなければ、を使用してデプロイします。CreateCampaign。キャンペーンは、GetRecommendations API を介してクライアントにレコメンデーションを提供します。

モデルをトレーニングするには、Amazon Personalize ではトレーニングデータとレシピが必要です。トレーニングデータは、リクエストで指定したデータセットグループから取得されます。レシピは、トレーニングアルゴリズムと特徴変換を指定します。Amazon Personalize が提供する、いずれかの事前定義されたレシピを指定できます。または、performAutoML を指定すると、Amazon Personalize がデータを分析し、最適な USER_PERSONALIZATION レシピを選択します。

注記

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

[Status] (ステータス)

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

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,
   "performHPO": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "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"
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

リクエストパラメータ

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

datasetGroupArn

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

Type: 文字列

長さの制約: 最大長は 256 です。

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

: 必須はい

eventType

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

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

Type: 文字列

長さの制約: 最大長は 256 です。

: 必須いいえ

name

ソリューションの名前。

Type: 文字列

長さの制約: 最小長は 1 です｡最大長は 63 です。

パターン: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

: 必須はい

performAutoML

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

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

Type: ブール値

: 必須いいえ

performHPO

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

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

Type: ブール値

: 必須いいえ

recipeArn

モデルトレーニングに使用するレシピの ARN。performAutoML が false の場合にのみ指定されます。

Type: 文字列

長さの制約: 最大長は 256 です。

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

: 必須いいえ

solutionConfig

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

注記

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

型: SolutionConfig オブジェクト

: 必須いいえ

tags

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

Type: 配列のTagオブジェクト

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

: 必須いいえ

レスポンスの構文


{
   "solutionArn": "string"
}

レスポンス要素

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

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

solutionArn

ソリューションの ARN。

Type: 文字列

長さの制約: 最大長は 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

以下の資料も参照してください。

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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

CreateSchema

CreateSolutionVersion