本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateSolution **重要** 根據預設，所有新解決方案都會使用自動訓練。透過自動訓練，您會在解決方案處於作用中狀態時產生訓練成本。為了避免不必要的成本，您可以在完成後[更新解決方案](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html)以關閉自動訓練。如需訓練成本的資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。 建立用於訓練模型的組態 （建立解決方案版本）。此組態包含用於模型訓練的配方和選用的訓練組態，例如用於訓練和功能轉換參數的欄。如需設定解決方案的詳細資訊，請參閱[建立和設定解決方案](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)。 根據預設，新的解決方案會每 7 天使用自動訓練來建立解決方案版本。您可以變更訓練頻率。自動建立解決方案版本會在解決方案為 ACTIVE 後的一小時內開始。如果您在一小時內手動建立解決方案版本，解決方案會略過第一個自動訓練。如需詳細資訊，請參閱[設定自動訓練](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)。 若要關閉自動訓練，請將 `performAutoTraining`設定為 false。如果您關閉自動訓練，則必須呼叫 [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) 操作來手動建立解決方案版本。 訓練開始後，您可以使用 [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API 操作取得解決方案版本的 Amazon Resource Name (ARN)。若要取得其狀態，請使用 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)。 訓練完成後，您可以透過呼叫 [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html) 來評估模型準確性。當您對解決方案版本感到滿意時，您可以使用 [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) 部署它。行銷活動會透過 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) API 向用戶端提供建議。 **注意** Amazon Personalize 目前不支援`hpoObjective`為解決方案超參數最佳化設定 。 **狀態** 解決方案可以處於下列其中一種狀態： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 若要取得解決方案的狀態，請呼叫 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html)。如果您使用手動訓練，則在您呼叫 之前，狀態必須為 ACTIVE`CreateSolutionVersion`。 **相關 API** + [UpdateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) + [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) + [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) + [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) + [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) + [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) + [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) ## 請求語法 ``` { "datasetGroupArn": "string", "eventType": "string", "name": "string", "performAutoML": boolean, "performAutoTraining": boolean, "performHPO": boolean, "performIncrementalUpdate": boolean, "recipeArn": "string", "solutionConfig": { "algorithmHyperParameters": { "string" : "string" }, "autoMLConfig": { "metricName": "string", "recipeList": [ "string" ] }, "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] }, "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" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) ** 提供訓練資料之資料集群組的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必要：是 ** [eventType](#API_CreateSolution_RequestSyntax) ** 當您有多個事件類型 `EVENT_TYPE` （使用結構描述欄位） 時，此參數會指定用於訓練模型的事件類型 （例如，「按一下」或「類似」)。 如果您不提供 `eventType`，無論類型為何，Amazon Personalize 都會將所有互動用於同等權重的訓練。 類型：字串 長度限制：長度上限為 256。 必要：否 ** [name](#API_CreateSolution_RequestSyntax) ** 解決方案的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 63。 模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必要：是 ** [performAutoML](#API_CreateSolution_RequestSyntax) ** 我們不建議啟用自動化機器學習。相反地，請將您的使用案例與可用的 Amazon Personalize 配方比對。如需詳細資訊，請參閱[選擇配方](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html)。 是否執行自動化機器學習 (AutoML)。預設值為 `false`。在這種情況下，您必須指定 `recipeArn`。 設為 時`true`，Amazon Personalize 會分析您的訓練資料，並選取最佳的 USER\$1PERSONALIZATION 配方和超參數。在此情況下，您必須省略 `recipeArn`。Amazon Personalize 透過為超參數執行具有不同值的測試來決定最佳配方。相較於選取特定配方，AutoML 會延長訓練程序。 類型：布林值 必要：否 ** [performAutoTraining](#API_CreateSolution_RequestSyntax) ** 解決方案是否使用自動訓練來建立新的解決方案版本 （訓練過的模型）。預設值為 ，`True`且解決方案每 7 天會自動建立新的解決方案版本。您可以在 `schedulingExpression`中指定 `AutoTrainingConfig`作為解決方案組態的一部分，以變更訓練頻率。如需自動訓練的詳細資訊，請參閱[設定自動訓練](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html)。 自動建立解決方案版本會在解決方案為 ACTIVE 後的一小時內開始。如果您在一小時內手動建立解決方案版本，解決方案會略過第一個自動訓練。 訓練開始後，您可以使用 [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) API 操作取得解決方案版本的 Amazon Resource Name (ARN)。若要取得其狀態，請使用 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)。 類型：布林值 必要：否 ** [performHPO](#API_CreateSolution_RequestSyntax) ** 是否要在指定或選取的配方上執行超參數最佳化 (HPO)。預設值為 `false`。 執行 AutoML 時，此參數一律為 `true`，且您不應將其設定為 `false`。 類型：布林值 必要：否 ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) ** 是否對模型執行增量訓練更新。啟用時，這可讓模型更頻繁地從新資料中學習，而無需完整重新訓練，從而實現近乎即時的個人化。只有使用語意相似性配方的解決方案才支援此參數。 類型：布林值 必要：否 ** [recipeArn](#API_CreateSolution_RequestSyntax) ** 用於模型訓練之配方的 Amazon Resource Name (ARN)。當 `performAutoML`為 false 時，此為必要項目。如需不同 Amazon Personalize 配方及其 ARNs 的資訊，請參閱[選擇配方](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必要：否 ** [solutionConfig](#API_CreateSolution_RequestSyntax) ** 解決方案的組態屬性。當 `performAutoML` 設為 true 時，Amazon Personalize 只會評估解決方案組態的 `autoMLConfig`區段。 Amazon Personalize 目前不支援設定 `hpoObjective`。 類型：[SolutionConfig](API_SolutionConfig.md) 物件 必要：否 ** [tags](#API_CreateSolution_RequestSyntax) ** 要套用至解決方案的[標籤](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)清單。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：否 ## 回應語法 ``` { "solutionArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [solutionArn](#API_CreateSolution_ResponseSyntax) ** 解決方案的 ARN。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 提供欄位或參數的有效值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每秒請求數的限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 指定的資源已存在。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的資源。 HTTP 狀態碼：400 ** TooManyTagsException ** 您已超過可套用至此資源的標籤數量上限。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolution) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution)