Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # CreateSolution **Important** Par défaut, toutes les nouvelles solutions utilisent l'entraînement automatique. Avec la formation automatique, vous encourez des frais de formation pendant que votre solution est active. Pour éviter des coûts inutiles, lorsque vous avez terminé, vous pouvez [mettre à jour la solution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) pour désactiver l'entraînement automatique. Pour plus d'informations sur les coûts de formation, consultez la [tarification d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/). Crée la configuration pour entraîner un modèle (création d'une version de solution). Cette configuration inclut la recette à utiliser pour l'entraînement des modèles et la configuration d'apprentissage facultative, telles que les colonnes à utiliser lors de l'entraînement et les paramètres de transformation des fonctionnalités. Pour plus d'informations sur la configuration d'une solution, consultez [la section Création et configuration d'une solution](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html). Par défaut, les nouvelles solutions utilisent une formation automatique pour créer des versions de solution tous les 7 jours. Vous pouvez modifier la fréquence d'entraînement. La création automatique des versions de la solution commence dans l'heure qui suit l'activation de la solution. Si vous créez manuellement une version de solution dans l'heure qui suit, la solution ignore le premier entraînement automatique. Pour plus d'informations, consultez [la section Configuration de l'entraînement automatique](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). Pour désactiver l'entraînement automatique, réglez-le `performAutoTraining` sur false. Si vous désactivez l'entraînement automatique, vous devez créer manuellement une version de solution en appelant l'[CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html)opération. Après le début de la formation, vous pouvez obtenir le nom de ressource Amazon (ARN) de la version de la solution avec le fonctionnement de l'[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Pour connaître son statut, utilisez le [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). Une fois la formation terminée, vous pouvez évaluer la précision du modèle en appelant [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html). Lorsque vous êtes satisfait de la version de la solution, vous la déployez à l'aide de [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). La campagne fournit des recommandations à un client via l'[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API. **Note** Amazon Personalize ne prend pas en charge la configuration de l'optimisation des hyperparamètres de la solution `hpoObjective` pour le moment. **Statut** Une solution peut se trouver dans l'un des états suivants : + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -ou- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Pour connaître l'état de la solution, appelez [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). Si vous utilisez la formation manuelle, le statut doit être ACTIF avant d'appeler`CreateSolutionVersion`. **Relié 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) ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Cette demande accepte les données suivantes au format JSON. ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) ** L'Amazon Resource Name (ARN) du groupe de jeux de données qui fournit les données d'entraînement. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatoire : oui ** [eventType](#API_CreateSolution_RequestSyntax) ** Lorsque vous avez plusieurs types d'événements (à l'aide d'un champ de `EVENT_TYPE` schéma), ce paramètre indique quel type d'événement (par exemple, « click » ou « like ») est utilisé pour entraîner le modèle. Si vous n'en fournissez pas`eventType`, Amazon Personalize utilisera toutes les interactions pour un entraînement avec le même poids, quel que soit le type. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Obligatoire : non ** [name](#API_CreateSolution_RequestSyntax) ** Le nom de la solution. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63. Modèle : `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obligatoire : oui ** [performAutoML](#API_CreateSolution_RequestSyntax) ** Nous vous déconseillons d'activer le machine learning. Adaptez plutôt les recettes Amazon Personalize disponibles à votre cas d'utilisation. Pour plus d'informations, consultez la section [Choix d'une recette](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html). S'il faut effectuer un apprentissage automatique automatique (AutoML). La valeur par défaut est `false`. Dans ce cas, vous devez spécifier`recipeArn`. Lorsque ce paramètre est défini sur`true`, Amazon Personalize analyse vos données d'entraînement et sélectionne la recette USER\$1PERSONALIZATION et les hyperparamètres optimaux. Dans ce cas, vous devez omettre`recipeArn`. Amazon Personalize détermine la recette optimale en exécutant des tests avec différentes valeurs pour les hyperparamètres. AutoML allonge le processus d'entraînement par rapport à la sélection d'une recette spécifique. Type : booléen Obligatoire : non ** [performAutoTraining](#API_CreateSolution_RequestSyntax) ** Si la solution utilise la formation automatique pour créer de nouvelles versions de solution (modèles entraînés). La valeur par défaut est `True` et la solution crée automatiquement de nouvelles versions de solution tous les 7 jours. Vous pouvez modifier la fréquence d'entraînement en spécifiant un `schedulingExpression` dans le `AutoTrainingConfig` cadre de la configuration de la solution. Pour plus d'informations sur l'entraînement automatique, voir [Configuration de l'entraînement automatique](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html). La création automatique des versions de la solution commence dans l'heure qui suit l'activation de la solution. Si vous créez manuellement une version de solution dans l'heure qui suit, la solution ignore le premier entraînement automatique. Après le début de la formation, vous pouvez obtenir le nom de ressource Amazon (ARN) de la version de la solution avec le fonctionnement de l'[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Pour connaître son statut, utilisez le [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). Type : booléen Obligatoire : non ** [performHPO](#API_CreateSolution_RequestSyntax) ** S'il faut effectuer l'optimisation des hyperparamètres (HPO) sur la recette spécifiée ou sélectionnée. La valeur par défaut est `false`. Lorsque vous exécutez AutoML, ce paramètre est toujours défini sur `true` et vous ne devez pas le définir sur. `false` Type : booléen Obligatoire : non ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) ** S'il faut effectuer des mises à jour d'entraînement progressives sur votre modèle. Lorsqu'il est activé, cela permet au modèle d'apprendre plus fréquemment à partir de nouvelles données sans nécessiter de réentraînement complet, ce qui permet une personnalisation en temps quasi réel. Ce paramètre n'est pris en charge que pour les solutions qui utilisent la recette de similarité sémantique. Type : booléen Obligatoire : non ** [recipeArn](#API_CreateSolution_RequestSyntax) ** Le nom de ressource Amazon (ARN) de la recette à utiliser pour l'entraînement des modèles. Ceci est obligatoire lorsque `performAutoML` c'est faux. Pour plus d'informations sur les différentes recettes Amazon Personalize et les leurs ARNs, consultez [Choisir une recette](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html). Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatoire : non ** [solutionConfig](#API_CreateSolution_RequestSyntax) ** Les propriétés de configuration de la solution. Lorsque `performAutoML` ce paramètre est défini sur true, Amazon Personalize évalue uniquement la `autoMLConfig` section de configuration de la solution. Pour le moment, Amazon Personalize ne prend pas en charge la configuration de `hpoObjective`. Type : objet [SolutionConfig](API_SolutionConfig.md) Obligatoire : non ** [tags](#API_CreateSolution_RequestSyntax) ** Liste des [balises](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) à appliquer à la solution. Type : tableau d’objets [Tag](API_Tag.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "solutionArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [solutionArn](#API_CreateSolution_ResponseSyntax) ** L'ARN de la solution. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Erreurs ** InvalidInputException ** Entrez une valeur valide pour le champ ou le paramètre. Code d’état HTTP : 400 ** LimitExceededException ** La limite du nombre de demandes par seconde a été dépassée. Code d’état HTTP : 400 ** ResourceAlreadyExistsException ** La ressource spécifiée existe déjà. Code d’état HTTP : 400 ** ResourceInUseException ** La ressource spécifiée est en cours d'utilisation. Code d’état HTTP : 400 ** ResourceNotFoundException ** Impossible de trouver la ressource spécifiée. Code d’état HTTP : 400 ** TooManyTagsException ** Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolution) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution)