CreateSolution - Amazon Personalize
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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 pour désactiver l'entraînement automatique. Pour plus d'informations sur les coûts de formation, consultez la tarification d'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'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.

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 la création de la solutionACTIVE. 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.

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'CreateSolutionVersionopé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 l'ListSolutionVersionsAPIopération. Pour connaître 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 par le biais du 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 :

  • CREATEPENDING> CREATE IN_ PROGRESS > ACTIVE -ou- CREATE FAILED

  • DELETEPENDING> DELETE DANS_ PROGRESS

Pour connaître l'état de la solution, appelez DescribeSolution. Si vous utilisez une formation manuelle, le statut doit être ACTIVE avant que vous n'appeliezCreateSolutionVersion.

Relié APIs

Syntaxe de la requête

{
   "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"
      }
   ]
}

Paramètres de demande

La demande accepte les données suivantes au JSON format suivant.

datasetGroupArn

Le nom de ressource Amazon (ARN) du groupe de données qui fournit les données d'entraînement.

Type : String

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_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 paseventType, Amazon Personalize utilisera toutes les interactions pour un entraînement avec le même poids, quel que soit le type.

Type : String

Contraintes de longueur : longueur maximale de 256.

Obligatoire : non

name

Le nom de la solution.

Type : String

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 automatique (AutoML). L’argument par défaut est false. Dans ce cas, vous devez spécifierrecipeArn.

Lorsque ce paramètre est défini surtrue, Amazon Personalize analyse vos données d'entraînement et sélectionne la PERSONALIZATION recette USER _ 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 d'entraînement 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). 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.

La création automatique des versions de la solution commence dans l'heure qui suit la création de la solutionACTIVE. 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 l'ListSolutionVersionsAPIopération. Pour connaître son statut, utilisez le DescribeSolutionVersion.

Type : booléen

Obligatoire : non

performHPO

S'il faut effectuer l'optimisation des hyperparamètres (HPO) sur la recette spécifiée ou sélectionnée. L’argument 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

recipeArn

Le nom de la ressource Amazon (ARN) de la recette à utiliser pour la formation des modèles. Ceci est obligatoire lorsque performAutoML c'est faux. Pour plus d'informations sur les différentes recettes Amazon Personalize et les leursARNs, consultez Choisir une recette.

Type : String

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. Lorsque performAutoML ce paramètre est défini sur true, Amazon Personalize évalue uniquement la autoMLConfig section de configuration de la solution.

Note

Pour le moment, Amazon Personalize ne prend pas en charge la configuration de hpoObjective.

Type : objet SolutionConfig

Obligatoire : non

tags

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 sous JSON forme formatée par le service.

solutionArn

Celui ARN de la solution.

Type : String

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.

HTTPCode de statut : 400

LimitExceededException

La limite du nombre de demandes par seconde a été dépassée.

HTTPCode de statut : 400

ResourceAlreadyExistsException

La ressource spécifiée existe déjà.

HTTPCode de statut : 400

ResourceInUseException

La ressource spécifiée est en cours d'utilisation.

HTTPCode de statut : 400

ResourceNotFoundException

Impossible de trouver la ressource spécifiée.

HTTPCode de statut : 400

TooManyTagsException

Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource.

HTTPCode de statut : 400

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :