As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # CreateSolution **Importante** Por padrão, todas as novas soluções usam o treinamento automático. Com o treinamento automático, você acumula custos de treinamento enquanto sua solução está ativa. Ao terminar, você poderá [atualizar a solução](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) para desativar o treinamento automático e evitar custos desnecessários. Para obter mais informações sobre os custos dos treinamentos, consulte [Preços do Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Cria a configuração para treinar um modelo (criando uma versão da solução). Essa configuração inclui a fórmula a ser usada para o treinamento de modelos e configuração de treinamento opcional, como colunas a serem usadas em parâmetros de treinamento e transformação de recursos. Para obter mais informações sobre como configurar uma solução, consulte [Criar e configurar uma solução](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html). Por padrão, as novas soluções usam o treinamento automático para criar versões da solução a cada 7 dias. Você pode alterar a frequência do treinamento. A criação da versão da solução começa dentro de uma hora após a solução se tornar ativa. Se você criar manualmente uma versão da solução dentro desse período, ela pulará o primeiro treinamento automático. Para obter mais informações, consulte [Configurar o treinamento automático](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). Para desativar o treinamento automático, defina `performAutoTraining` como false. Se você desativar o treinamento automático, deverá criar manualmente uma versão da solução chamando a [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html)operação. Após o início do treinamento, você pode obter o Amazon Resource Name (ARN) da versão da solução com a operação da [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Para obter seu status, use [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)o. Após a conclusão do treinamento, você pode avaliar a precisão do modelo ligando para [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html). Quando estiver satisfeito com a versão da solução, você a implanta usando [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). A campanha fornece recomendações a um cliente por meio da [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API. **nota** O Amazon Personalize não oferece suporte à configuração de `hpoObjective` para otimização de hiperparâmetros no momento. **Status** Uma solução pode estar em um dos seguintes estados: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Para obter o status da solução, ligue [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). Se você usa o treinamento manual, ele deve estar ativo antes de você chamar `CreateSolutionVersion`. **Relacionado APIs** + [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) ## Sintaxe da solicitação ``` { "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" } ] } ``` ## Parâmetros da solicitação A solicitação aceita os dados a seguir no formato JSON. ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) ** O nome do recurso da Amazon (ARN) do grupo de conjuntos de dados que fornece os dados de treinamento. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obrigatório: Sim ** [eventType](#API_CreateSolution_RequestSyntax) ** Quando você tem vários tipos de eventos (usando um campo de esquema `EVENT_TYPE`), esse parâmetro especifica qual tipo de evento (por exemplo, "clique" ou "curtida") é usado para treinar o modelo. Se você não fornecer um `eventType`, o Amazon Personalize usará todas as interações para treinamento com o mesmo peso, independentemente do tipo. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Obrigatório: não ** [name](#API_CreateSolution_RequestSyntax) ** O nome da solução. Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63. Padrão: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obrigatório: Sim ** [performAutoML](#API_CreateSolution_RequestSyntax) ** Não recomendamos a habilitação do machine learning automatizado. Em vez disso, faça a correspondência entre o caso de uso e as fórmulas do Amazon Personalize disponíveis. Para obter mais informações, consulte [Escolher uma fórmula](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html). Se será realizado machine learning automatizado (AutoML). O padrão é `false`. Para esse caso, você deve especificar `recipeArn`. Quando definido como `true`, o Amazon Personalize analisa seus dados de treinamento e seleciona a fórmula e os hiperparâmetros de USER\$1PERSONALIZATION ideais. Neste caso, você deve omitir `recipeArn`. O Amazon Personalize determina a fórmula ideal executando testes com valores diferentes para os hiperparâmetros. O AutoML prolonga o processo de treinamento em comparação com a seleção de uma fórmula específica. Tipo: booliano Obrigatório: não ** [performAutoTraining](#API_CreateSolution_RequestSyntax) ** Se a solução usa treinamento automático para criar novas versões da solução (modelos treinados). O padrão é `True` e a solução cria automaticamente uma versão a cada 7 dias. Você pode alterar a frequência do treinamento especificando a `AutoTrainingConfig` como parte da configuração da solução `schedulingExpression`. Para obter mais informações sobre o treinamento automático, consulte [Configurar o treinamento automático](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). A criação da versão da solução começa dentro de uma hora após a solução se tornar ativa. Se você criar manualmente uma versão da solução dentro desse período, ela pulará o primeiro treinamento automático. Após o início do treinamento, você pode obter o Amazon Resource Name (ARN) da versão da solução com a operação da [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Para obter seu status, use [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)o. Tipo: booliano Obrigatório: não ** [performHPO](#API_CreateSolution_RequestSyntax) ** Se a otimização de hiperparâmetros (HPO) deve ou não ser realizada na fórmula especificada ou selecionada. O padrão é `false`. Ao executar o AutoML, esse parâmetro é sempre `true`, e você não deve defini-lo como `false`. Tipo: booliano Obrigatório: não ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) ** Se você deve realizar atualizações incrementais de treinamento em seu modelo. Quando ativado, isso permite que o modelo aprenda com novos dados com mais frequência sem exigir um novo treinamento completo, o que permite uma personalização quase em tempo real. Esse parâmetro é suportado somente para soluções que usam a receita de similaridade semântica. Tipo: booliano Obrigatório: não ** [recipeArn](#API_CreateSolution_RequestSyntax) ** O nome do recurso da Amazon (ARN) da fórmula a ser usada no treinamento do modelo. Isso é necessário quando `performAutoML` é falso. Para obter informações sobre as diferentes receitas do Amazon Personalize e suas ARNs, consulte Como [escolher uma](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html) receita. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obrigatório: não ** [solutionConfig](#API_CreateSolution_RequestSyntax) ** As propriedades de configuração da solução. Quando `performAutoML` é definido como verdadeiro, o Amazon Personalize avalia somente a seção `autoMLConfig` da configuração da solução. O Amazon Personalize não oferece suporte à configuração do `hpoObjective` no momento. Tipo: objeto [SolutionConfig](API_SolutionConfig.md) Obrigatório: não ** [tags](#API_CreateSolution_RequestSyntax) ** Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) para aplicar à solução. Tipo: matriz de objetos [Tag](API_Tag.md) Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens. Obrigatório: não ## Sintaxe da resposta ``` { "solutionArn": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [solutionArn](#API_CreateSolution_ResponseSyntax) ** O ARN da solução. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Erros ** InvalidInputException ** Forneça um valor válido para o campo ou parâmetro. Código de status HTTP: 400 ** LimitExceededException ** O limite de número de solicitações por segundo foi excedido. Código de status HTTP: 400 ** ResourceAlreadyExistsException ** O recurso especificado já existe. Código de status HTTP: 400 ** ResourceInUseException ** O recurso especificado está em uso. Código de status HTTP: 400 ** ResourceNotFoundException ** Não foi possível encontrar o recurso especificado. Código de status HTTP: 400 ** TooManyTagsException ** Você excedeu o número máximo de tags que pode aplicar a esse recurso. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolution) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution)