Sintaxis de la solicitud Parámetros de la solicitud Sintaxis de la respuesta Elementos de respuesta Errores Véase también

CreateSolution

importante

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. Para evitar costes innecesarios, cuando haya terminado, puede actualizar la solución para desactivar la formación automática. 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 la creación de la soluciónACTIVE. 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.

Cuando comience el entrenamiento, podrá obtener el nombre de recurso de Amazon (ARN) de la versión de la solución con la ListSolutionVersionsAPIoperación. 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 del 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:

CREATEPENDING> CREATE IN_ PROGRESS > ACTIVE -o- CREATE FAILED
DELETEPENDING> EN_ DELETE PROGRESS

Para obtener el estado de la solución, llame DescribeSolution. Si utiliza la formación manual, el estado debe estar ACTIVE antes de llamarCreateSolutionVersion.

Relacionado APIs

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 JSON formato.

datasetGroupArn

El nombre del 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: cadena

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 PERSONALIZATION receta USER _ y los hiperparámetros óptimos. 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 la creación de la soluciónACTIVE. 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.

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 del recurso de Amazon (ARN) de la receta que se utilizará en el entrenamiento de modelos. Esto es obligatorio cuando performAutoML es falso. Para obtener información sobre las distintas recetas de Amazon Personalize y sus recetasARNs, consulta Cómo elegir una receta.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

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

Obligatorio: no

solutionConfig

Las propiedades de configuración de 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 de HTTP 200.

El servicio devuelve los siguientes datos en JSON formato.

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.

HTTPCódigo de estado: 400

LimitExceededException

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

HTTPCódigo de estado: 400

ResourceAlreadyExistsException

El recurso especificado ya existe.

HTTPCódigo de estado: 400

ResourceInUseException

El recurso especificado está en uso.

HTTPCódigo de estado: 400

ResourceNotFoundException

No se ha encontrado el recurso especificado.

HTTPCódigo de estado: 400

TooManyTagsException

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

HTTPCódigo de estado: 400

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

CreateSchema

CreateSolutionVersion