CreateSolution - Amazon Personalize
Sintaxe da SolicitaçãoParâmetros da solicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

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

Depois de criar uma solução, você não pode alterar sua configuração. 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. Você não pode interromper o treinamento automático em busca de uma solução. Para evitar custos desnecessários, certifique-se de excluir a solução quando terminar. 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 uma hora após a solução estar ATIVA. 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 operação da ListSolutionVersionsAPI. 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 da 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:

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

  • DELETE PENDING > DELETE IN_PROGRESS

Para obter o status da solução, ligue DescribeSolution. Se você usa o treinamento manual, o status deve ser ATIVO antes de você ligarCreateSolutionVersion.

APIs relacionadas

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 dados a seguir no formato JSON.

datasetGroupArn

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:.*:.*:.+

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 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_PERSONALIZATION 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

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 novas versões da soluçã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 Configurando o treinamento automático.

A criação automática da versão da solução começa uma hora após a solução estar ATIVA. 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 operação da ListSolutionVersionsAPI. Para obter seu status, use DescribeSolutionVersiono.

Tipo: booliano

Obrigatório: não

performHPO

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

recipeArn

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 diferentes fórmulas do Amazon Personalize e os respectivos ARNs, consulte Escolher uma fórmula.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):personalize:.*:.*:.+

Obrigatório: não

solutionConfig

A configuração a ser usada com a solução. Quando performAutoML é definido como verdadeiro, o Amazon Personalize avalia somente a seção autoMLConfig da configuração da solução.

nota

O Amazon Personalize não oferece suporte à configuração do hpoObjective no momento.

Tipo: objeto SolutionConfig

Obrigatório: Não

tags

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 tiver êxito, o serviço enviará de volta uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON 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.

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 um dos AWS SDKs específicos da linguagem, consulte o seguinte: