翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CreateSolution
重要
デフォルトでは、すべての新しいソリューションで自動トレーニングが使用されます。自動トレーニングでは、ソリューションがアクティブな間はトレーニングコストが発生します。不要なコストを避けるために、完了したらソリューションを更新して自動トレーニングを無効にすることができます。トレーニングのコストの詳細については、「Amazon Personalize の料金
モデルをトレーニングするための設定 (ソリューションバージョンの作成) を作成します。この設定には、モデルトレーニングに使用するレシピと、トレーニングや機能変換パラメータで使用する列などのオプションのトレーニング設定が含まれます。ソリューションの設定の詳細については、「ソリューションの作成と構成」を参照してください。
デフォルトでは、新しいソリューションは自動トレーニングを使用して 7 日ごとにソリューションバージョンを作成します。トレーニング頻度は変更できます。自動ソリューションバージョンの作成は、ソリューションが ACTIVE になってから 1 時間以内に開始されます。1 時間以内にソリューションバージョンを手動で作成した場合、ソリューションは最初の自動トレーニングをスキップします。詳細については、「自動トレーニングの設定」を参照してください。
自動トレーニングを無効にするには、performAutoTraining を false に設定します。自動トレーニングをオフにする場合は、CreateSolutionVersion オペレーションを呼び出して、ソリューションバージョンを手動で作成する必要があります。
トレーニングが開始されると、ListSolutionVersions API オペレーションを使用してソリューションバージョンの Amazon リソースネーム (ARN) を取得できます。ステータスを取得するには、DescribeSolutionVersion を使用します。
トレーニングが完了したら、GetSolutionMetrics を呼び出してモデルの精度を評価できます。ソリューションバージョンに問題がなければ、CreateCampaign を使用してデプロイします。キャンペーンは、GetRecommendations API を介してクライアントにレコメンデーションを提供します。
注記
現時点では、Amazon Personalize は、ソリューションのハイパーパラメータ最適化のためん、hpoObjective の設定をサポートしていません。
ステータス
ソリューションは、次に示す状態のいずれかになります。
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -または- CREATE FAILED
-
DELETE PENDING > DELETE IN_PROGRESS
ソリューションのステータスを取得するには、DescribeSolution を呼び出します。手動トレーニングを使用する場合は、CreateSolutionVersion を呼び出す前にステータスが ACTIVE である必要があります。
リクエストの構文
{
"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 です。
Pattern:
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でschedulingExpressionを指定することで、トレーニング頻度を変更できます。自動トレーニングの詳細については、「自動トレーニングの設定」を参照してください。自動ソリューションバージョンの作成は、ソリューションが ACTIVE になってから 1 時間以内に開始されます。1 時間以内にソリューションバージョンを手動で作成した場合、ソリューションは最初の自動トレーニングをスキップします。
トレーニングが開始されると、ListSolutionVersions API オペレーションを使用してソリューションバージョンの 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 オブジェクト
必須: いいえ
-
ソリューションに適用するタグのリスト。
型: 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
以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
