CreateSolution - Amazon Personalize

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

CreateSolution

重要

デフォルトでは、すべての新しいソリューションで自動トレーニングが使用されます。自動トレーニングでは、ソリューションがアクティブになっている間、トレーニングコストが発生します。不要なコストを避けるために、完了したらソリューションを更新して自動トレーニングをオフにできます。トレーニングコストの詳細については、「Amazon Personalize の料金」を参照してください。

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

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

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

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

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

注記

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

[ステータス]

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

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

ソリューションのステータスを取得するには、 を呼び出しますDescribeSolution。手動トレーニングを使用する場合、 を呼び出すACTIVE前にステータスが である必要がありますCreateSolutionVersion

リクエストの構文

{ "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で を指定することで、トレーニング頻度を変更できます。自動トレーニングの詳細については、「自動トレーニングの設定」を参照してください。

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

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

型: ブール値

必須:いいえ

performHPO

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

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

型: ブール値

必須:いいえ

recipeArn

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

型: 文字列

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

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

必須: いいえ

solutionConfig

ソリューションの構成プロパティ。performAutoML が true に設定されている場合、Amazon Personalize はソリューション設定の autoMLConfig セクションのみを評価します。

注記

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

型: SolutionConfig オブジェクト

必須:いいえ

tags

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

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

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

必須:いいえ

レスポンスの構文

{ "solutionArn": "string" }

レスポンス要素

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

次のデータは、 サービスによって 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

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

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