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 la formation automatique. Avec la formation automatique, vous devez payer 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 pour désactiver la formation automatique. Pour plus d'informations sur les coûts de formation, consultez la section Tarification Amazon Personalize
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'apprentissage des modèles et la configuration d'entraînement facultative, comme les colonnes à utiliser pour 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.
Par défaut, les nouvelles solutions utilisent la 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 de la version 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 la première formation automatique. Pour plus d'informations, consultez la section Configuration de l'entraînement automatique.
Pour désactiver l'entraînement automatique, réglez sur performAutoTraining False. Si vous désactivez la formation automatique, vous devez créer manuellement une version de la solution en appelant l'CreateSolutionVersionopération.
Une fois la formation commencée, vous pouvez obtenir le nom de ressource Amazon (ARN) de la version de la solution grâce à l'opération ListSolutionVersions d'API. Pour obtenir son statut, utilisez le DescribeSolutionVersion.
Une fois la formation terminée, vous pouvez évaluer la précision du modèle en appelant GetSolutionMetrics. Lorsque vous êtes satisfait de la version de la solution, vous la déployez à l'aide de CreateCampaign. La campagne fournit des recommandations à un client via l'GetRecommendationsAPI.
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_PROGRESS > ACTIVE -ou- CREATE FAILED
-
DELETE PENDING > DELETE IN_PROGRESS
Pour connaître l'état de la solution, appelez DescribeSolution. Si vous utilisez la formation manuelle, le statut doit être ACTIF avant d'appelerCreateSolutionVersion.
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
-
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
-
Lorsque vous avez plusieurs types d'événements (à l'aide d'un champ de
EVENT_TYPEschéma), ce paramètre indique quel type d'événement (par exemple, « clic » ou « J'aime ») est utilisé pour entraîner le modèle.Si vous ne fournissez pas de
eventType, Amazon Personalize utilisera toutes les interactions pour vous entraîner avec le même poids, quel que soit le type.Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Obligatoire : non
- name
-
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
-
Important
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.
S'il faut effectuer un apprentissage automatique (AutoML). La valeur par défaut est
false. Dans ce cas, vous devez spécifierrecipeArn.Lorsque cette option est définie sur
true, Amazon Personalize analyse vos données d'entraînement et sélectionne la recette USER_PERSONALIZATION et les hyperparamètres optimaux. Dans ce cas, vous devez omettrerecipeArn. Amazon Personalize détermine la recette optimale en exécutant des tests avec différentes valeurs pour les hyperparamètres. AutoML allonge le processus de formation par rapport à la sélection d'une recette spécifique.Type : booléen
Obligatoire : non
- performAutoTraining
-
Si la solution utilise la formation automatique pour créer de nouvelles versions de solution (modèles entraînés). Par défaut,
Truela 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 unschedulingExpressiondansAutoTrainingConfigla configuration de la solution. Pour plus d'informations sur l'entraînement automatique, voir Configuration de l'entraînement automatique.La création automatique de la version 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 la première formation automatique.
Une fois la formation commencée, vous pouvez obtenir le nom de ressource Amazon (ARN) de la version de la solution grâce à l'opération ListSolutionVersions d'API. Pour obtenir son statut, utilisez le DescribeSolutionVersion.
Type : booléen
Obligatoire : non
- performHPO
-
S'il faut effectuer une 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
trueet vous ne devez pas le définirfalsesur.Type : booléen
Obligatoire : non
- performIncrementalUpdate
-
S'il faut effectuer des mises à jour d'entraînement incrémentielles sur votre modèle. Lorsqu'elle est activée, cela permet au modèle d'apprendre plus fréquemment à partir de nouvelles données sans nécessiter de reconversion complète, 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
-
Le nom de ressource Amazon (ARN) de la recette à utiliser pour la formation des modèles. Ceci est obligatoire lorsque la valeur
performAutoMLest fausse. Pour plus d'informations sur les différentes recettes Amazon Personalize et leurs ARN, consultez la section Choix d'une recette.Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatoire : non
- solutionConfig
-
Les propriétés de configuration de la solution. Lorsqu'il
performAutoMLest défini sur true, Amazon Personalize évalue uniquement laautoMLConfigsection de la configuration de la solution.Note
Pour le moment, Amazon Personalize ne prend pas en charge la configuration de
hpoObjective.Type : objet SolutionConfig
Obligatoire : non
-
Liste des balises à appliquer à la solution.
Type : tableau d’objets Tag
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
-
L'ARN de la solution.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):personalize:.*:.*:.+
Erreurs
- InvalidInputException
-
Fournissez une valeur valide pour le champ ou le paramètre.
Code d’état HTTP : 400
- LimitExceededException
-
La limite du nombre de requêtes 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 AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :
