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 treinamento automático. Com o treinamento automático, você incorre em custos de treinamento enquanto sua solução está ativa. Para evitar custos desnecessários, ao terminar, você poderá atualizar a solução para desativar o treinamento automático. Para obter informações sobre custos de treinamento, consulte os preços do Amazon Personalize.
Cria a configuração para treinar um modelo (criando uma versão da solução). Essa configuração inclui a receita a ser usada para 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 Criação e configuração de uma solução.
Por padrão, as novas soluções usam 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 automática da versão da solução começa dentro de uma hora após a soluçãoACTIVE. Se você criar manualmente uma versão da solução em uma hora, a solução pulará o primeiro treinamento automático. Para obter mais informações, consulte Configurando o treinamento automático.
Para desativar o treinamento automático, performAutoTraining defina como false. Se você desativar o treinamento automático, deverá criar manualmente uma versão da solução chamando a CreateSolutionVersionoperação.
Após o início do treinamento, você pode obter o Amazon Resource Name (ARN) da versão da solução com a ListSolutionVersionsAPIoperação. Para obter seu status, use DescribeSolutionVersiono.
Após a conclusão do treinamento, você pode avaliar a precisão do modelo ligando para GetSolutionMetrics. Quando estiver satisfeito com a versão da solução, você a implanta usando CreateCampaign. A campanha fornece recomendações a um cliente por meio do GetRecommendationsAPI.
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:
-
CREATEPENDING> CREATE EM_ PROGRESS > ACTIVE -ou- CREATE FAILED
-
DELETEPENDING> DELETE EM_ PROGRESS
Para obter o status da solução, ligue DescribeSolution. Se você usa treinamento manual, o status deve ser ACTIVE antes de você ligarCreateSolutionVersion.
Relacionado APIs
Sintaxe da Solicitação
{
"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"
}
]
}Parâmetros da solicitação
A solicitação aceita os seguintes dados no JSON formato.
- datasetGroupArn
-
O Amazon Resource Name (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:.*:.*:.+Exigido: Sim
- eventType
-
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
-
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\-_]*Exigido: Sim
- performAutoML
-
Importante
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.
Se será realizado machine learning automatizado (AutoML). O padrão é
false. Para esse caso, você deve especificarrecipeArn.Quando definido como
true, o Amazon Personalize analisa seus dados de treinamento e seleciona a receita USER _ PERSONALIZATION e os hiperparâmetros ideais. Neste caso, você deve omitirrecipeArn. 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
-
Se a solução usa treinamento automático para criar novas versões da solução (modelos treinados). O padrão é
Truee a solução cria automaticamente novas versões da solução a cada 7 dias. Você pode alterar a frequência do treinamento especificando aAutoTrainingConfigcomo parte da configuração da solução.schedulingExpressionPara obter mais informações sobre o treinamento automático, consulte Configurando o treinamento automático.A criação automática da versão da solução começa dentro de uma hora após a soluçãoACTIVE. Se você criar manualmente uma versão da solução em uma hora, a solução 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 ListSolutionVersionsAPIoperação. Para obter seu status, use DescribeSolutionVersiono.
Tipo: booliano
Obrigatório: não
- performHPO
-
Se deve realizar a otimização de hiperparâmetros (HPO) na receita especificada ou selecionada. O padrão é
false.Ao executar o AutoML, esse parâmetro é sempre
true, e você não deve defini-lo comofalse.Tipo: booliano
Obrigatório: não
- recipeArn
-
O nome do recurso Amazon (ARN) da receita a ser usada para treinamento de modelos. Isso é necessário quando
performAutoMLé falso. Para obter informações sobre as diferentes receitas do Amazon Personalize e suasARNs, consulte Como escolher uma receita.Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Obrigatório: Não
- solutionConfig
-
As propriedades de configuração da solução. Quando
performAutoMLé definido como verdadeiro, o Amazon Personalize avalia somente a seçãoautoMLConfigda configuração da solução.nota
O Amazon Personalize não oferece suporte à configuração do
hpoObjectiveno momento.Tipo: objeto SolutionConfig
Obrigatório: Não
-
Uma lista de tags para aplicar à solução.
Tipo: matriz de objetos Tag
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 de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- solutionArn
-
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.
HTTPCódigo de status: 400
- LimitExceededException
-
O limite de número de solicitações por segundo foi excedido.
HTTPCódigo de status: 400
- ResourceAlreadyExistsException
-
O recurso especificado já existe.
HTTPCódigo de status: 400
- ResourceInUseException
-
O recurso especificado está em uso.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
Não foi possível encontrar o recurso especificado.
HTTPCódigo de status: 400
- TooManyTagsException
-
Você excedeu o número máximo de tags que pode aplicar a esse recurso.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um dos idiomas específicos AWS SDKs, veja o seguinte:
