CreateSolution - Amazon Personalize
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CreateSolution

importante

Después de crear una solución, no puede cambiar su configuración. De forma predeterminada, todas las soluciones nuevas utilizan el entrenamiento automático. Con la formación automática, incurrirá en costes de formación mientras la solución esté activa. No puede detener la formación automática en busca de una solución. Para evitar costes innecesarios, asegúrese de eliminar la solución cuando haya terminado. Para obtener información sobre los costes de formación, consulta los precios de Amazon Personalize.

Crea la configuración para entrenar un modelo (crea una versión de la solución). Esta configuración incluye la receta que se utilizará en el entrenamiento del modelo y la configuración de entrenamiento opcional, como las columnas que se utilizarán en el entrenamiento y los parámetros de transformación de características. Para obtener más información sobre la configuración de una solución, consulte Creación y configuración de una solución.

De forma predeterminada, las soluciones nuevas utilizan el entrenamiento automático para crear versiones de la solución cada 7 días. Puedes cambiar la frecuencia de entrenamiento. La creación automática de la versión de la solución comienza una hora después de que la solución esté ACTIVA. Si crea manualmente una versión de la solución en menos de una hora, la solución se salta el primer entrenamiento automático. Para obtener más información, consulte Configuración del entrenamiento automático.

Para desactivar el entrenamiento automático, performAutoTraining establézcalo en false. Si desactiva el entrenamiento automático, debe crear manualmente una versión de la solución mediante una llamada a la CreateSolutionVersionoperación.

Una vez que comience la capacitación, podrá obtener el nombre de recurso de Amazon (ARN) de la versión de la solución con la operación de ListSolutionVersionsAPI. Para obtener su estado, utilice. DescribeSolutionVersion

Una vez finalizado el entrenamiento, puede evaluar la precisión del modelo llamando GetSolutionMetrics. Cuando esté satisfecho con la versión de la solución, la implemente utilizando CreateCampaign. La campaña proporciona recomendaciones a un cliente a través de la GetRecommendationsAPI.

nota

Amazon Personalize no admite la configuración de hpoObjective para la optimización de hiperparámetros de solución en este momento.

Status

Una solución puede tener uno de los siguientes estados:

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

  • DELETE PENDING > DELETE IN_PROGRESS

Para conocer el estado de la solución, llama DescribeSolution. Si utiliza la formación manual, el estado debe ser ACTIVO antes de llamarCreateSolutionVersion.

API relacionadas

Sintaxis de la solicitud

{
   "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 de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

datasetGroupArn

El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que proporciona los datos de entrenamiento.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatorio: sí

eventType

Si tiene varios tipos de eventos (mediante un campo de esquema EVENT_TYPE), este parámetro especifica qué tipo de evento (por ejemplo, “clic” o “me gusta”) se utiliza para entrenar el modelo.

Si no se proporciona eventType, Amazon Personalize utiliza todas las interacciones para el entrenamiento con la misma ponderación, independientemente del tipo.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Obligatorio: no

name

El nombre de la solución.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.

Patrón: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Obligatorio: sí

performAutoML
importante

No le recomendamos habilitar el machine learning automático. En lugar de eso, puede emparejar su caso de uso con las recetas de Amazon Personalize disponibles. Para obtener más información, consulte Elección de una receta.

Si se debe realizar un machine learning automatizado (AutoML). El valor predeterminado es false. En este caso, debe especificar recipeArn.

Cuando se configura entrue, Amazon Personalize analiza los datos de entrenamiento y selecciona la receta y los hiperparámetros óptimos de USER_PERSONALIZATION. En este caso, debe omitir recipeArn. Amazon Personalize determina la receta óptima mediante la ejecución de pruebas con valores diferentes para los hiperparámetros. AutoML alarga el proceso de entrenamiento en comparación con la selección de una receta específica.

Tipo: Booleano

Obligatorio: no

performAutoTraining

Si la solución utiliza el entrenamiento automático para crear nuevas versiones de la solución (modelos entrenados). El valor predeterminado es True y la solución crea automáticamente nuevas versiones de la solución cada 7 días. Puede cambiar la frecuencia de entrenamiento especificando una schedulingExpression AutoTrainingConfig como parte de la configuración de la solución. Para obtener más información sobre el entrenamiento automático, consulte Configuración del entrenamiento automático.

La creación automática de la versión de la solución comienza una hora después de que la solución esté ACTIVA. Si crea manualmente una versión de la solución en menos de una hora, la solución se salta el primer entrenamiento automático.

Una vez que comience la capacitación, podrá obtener el nombre de recurso de Amazon (ARN) de la versión de la solución con la operación de ListSolutionVersionsAPI. Para obtener su estado, utilice. DescribeSolutionVersion

Tipo: Booleano

Obligatorio: no

performHPO

Si se debe realizar la optimización de hiperparámetros (HPO) en la receta especificada o seleccionada. El valor predeterminado es false.

Al ejecutar AutoML, este parámetro es siempre true y no debe configurarlo en false.

Tipo: Booleano

Obligatorio: no

recipeArn

El nombre de recurso de Amazon (ARN) de la receta que se va a utilizar para el entrenamiento del modelo. Esto es obligatorio cuando performAutoML es falso. Para obtener información sobre las distintas recetas de Amazon Personalize y sus ARN, consulte Elección de una receta.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatorio: no

solutionConfig

La configuración que se va a utilizar con la solución. Si performAutoML se establece en true, Amazon Personalize solo evalúa la sección autoMLConfig de la configuración de la solución.

nota

Amazon Personalize no admite la configuración de hpoObjective en este momento.

Tipo: objeto SolutionConfig

Obligatorio: no

tags

Lista de etiquetas que se aplican a la solución.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

Obligatorio: no

Sintaxis de la respuesta

{
   "solutionArn": "string"
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

solutionArn

El ARN de la solución.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Errores

InvalidInputException

Proporcione un valor válido para el campo o el parámetro.

Código de estado HTTP: 400

LimitExceededException

Se ha excedido el límite en el número de solicitudes por segundo.

Código de estado HTTP: 400

ResourceAlreadyExistsException

El recurso especificado ya existe.

Código de estado HTTP: 400

ResourceInUseException

El recurso especificado está en uso.

Código de estado HTTP: 400

ResourceNotFoundException

No se ha encontrado el recurso especificado.

Código de estado HTTP: 400

TooManyTagsException

Ha superado el número máximo de etiquetas que puede aplicar a este recurso.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: