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** De forma predeterminada, todas las soluciones nuevas utilizan el entrenamiento automático. Con el entrenamiento automático, incurrirá en costos de entrenamiento mientras la solución esté activa. Para evitar costos innecesarios, cuando haya terminado, puede [actualizar la solución](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) para desactivar el entrenamiento automático. Para obtener información sobre los costos de entrenamiento, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Crea la configuración para entrenar un modelo (creación de una versión de 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](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html). De forma predeterminada, las soluciones nuevas utilizan el entrenamiento automático para crear versiones de solución cada siete días. Puede cambiar la frecuencia de entrenamiento. La creación automática de versiones de solución comienza una hora después de que el estado de la solución sea ACTIVE. Si crea de forma manual una versión de solución en menos de una hora, la solución omitirá el primer entrenamiento automático. Para obtener más información, consulte [Configuración del entrenamiento automático](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). Para desactivar el entrenamiento automático, establezca `performAutoTraining` en false. Si desactiva el entrenamiento automático, debe crear manualmente una versión de la solución llamando a la [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html)operació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 [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Para obtener su estado, utilice. [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) Una vez finalizado el entrenamiento, puede evaluar la precisión del modelo llamando [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html). Cuando esté satisfecho con la versión de la solución, la implemente utilizando [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). La campaña proporciona recomendaciones a un cliente a través de la [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API. **nota** Amazon Personalize no admite la configuración de `hpoObjective` para la optimización de hiperparámetros de solución en este momento. **Estado** Una solución puede tener uno de los siguientes estados: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Para conocer el estado de la solución, llama [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). Si utiliza el entrenamiento manual, el estado debe ser ACTIVE antes de llamar a `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) ## Sintaxis de la solicitud ``` { "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 de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) ** 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](#API_CreateSolution_RequestSyntax) ** 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](#API_CreateSolution_RequestSyntax) ** 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](#API_CreateSolution_RequestSyntax) ** 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](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html). Si se debe realizar un machine learning automatizado (AutoML). El valor predeterminado es `false`. En este caso, debe especificar `recipeArn`. Cuando se configura en`true`, Amazon Personalize analiza los datos de entrenamiento y selecciona la receta y los hiperparámetros óptimos de USER\$1PERSONALIZATION. 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](#API_CreateSolution_RequestSyntax) ** Indica si la solución utiliza el entrenamiento automático para crear nuevas versiones de solución (modelos entrenados). El valor predeterminado es `True` y la solución crea automáticamente nuevas versiones de solución cada siete días. Puede cambiar la frecuencia de entrenamiento mediante la especificación de `schedulingExpression` en `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](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). La creación automática de versiones de solución comienza una hora después de que el estado de la solución sea ACTIVE. Si crea de forma manual una versión de solución en menos de una hora, la solución omitirá 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 [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Para obtener su estado, utilice. [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) Tipo: Booleano Obligatorio: no ** [performHPO](#API_CreateSolution_RequestSyntax) ** 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 ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) ** Si desea realizar actualizaciones de entrenamiento incrementales en su modelo. Cuando está activado, esto permite que el modelo aprenda de los nuevos datos con mayor frecuencia sin necesidad de volver a capacitarse por completo, lo que permite una personalización prácticamente en tiempo real. Este parámetro solo es compatible con las soluciones que utilizan la receta de similitud semántica. Tipo: Booleano Obligatorio: no ** [recipeArn](#API_CreateSolution_RequestSyntax) ** 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 recetas ARNs, consulta [Cómo elegir una receta](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html). Tipo: cadena Limitaciones de longitud: longitud máxima de 256. Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatorio: no ** [solutionConfig](#API_CreateSolution_RequestSyntax) ** 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. Amazon Personalize no admite la configuración de `hpoObjective` en este momento. Tipo: objeto [SolutionConfig](API_SolutionConfig.md) Obligatorio: no ** [tags](#API_CreateSolution_RequestSyntax) ** Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican a la solución. Tipo: matriz de objetos [Tag](API_Tag.md) 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](#API_CreateSolution_ResponseSyntax) ** 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 idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos 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)