Création d'une version de solution - Amazon Personalize
Création d'une version de solution (console)Création d'une version de solution (AWS CLI)Création d'une version de solution (AWS SDK)

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.

Création d'une version de solution

Une fois que vous avez terminéCréation et configuration d'une solution, vous êtes prêt à commencer l'entraînement :

  • Si votre solution utilise l'entraînement automatique, elle crée des versions de solution pour vous à la fréquence d'entraînement que vous spécifiez. Par défaut, toutes les nouvelles solutions utilisent une formation automatique pour créer une nouvelle version de solution tous les 7 jours. Vous pouvez toujours créer des versions de solution manuellement. Pour plus d’informations, consultez Configuration de l'entraînement automatique.

  • Si vous désactivez l'entraînement automatique pour votre solution ou si vous souhaitez effectuer un entraînement manuel, vous pouvez créer manuellement une version de la solution. Une version de solution fait référence à un modèle d'apprentissage automatique entraîné. Vous pouvez créer une version de solution à l'aide de la console, AWS Command Line Interface (AWS CLI) ou AWS des SDK. Si le statut de la version de votre solution est CREATE_PENDING ou CREATE_IN_PROGRESS, vous pouvez utiliser cette StopSolutionVersionCreation opération pour arrêter le processus de création de la version de solution. veuillez consulter Arrêt de la création d'une version de solution.

Rubriques

Création d'une version de solution (console)

Lorsque vous créez initialement votre solution à l'aide de la console Amazon Personalize, vous créez également une version de la solution. Sur la page des détails de la solution, vous pouvez suivre la progression de la formation dans la section Versions de la solution. Lorsque l'entraînement est terminé, le statut est Actif et vous êtes prêt à le faire. Voir Création d'une campagne ou Recommandations par lots et segments d'utilisateurs (ressources personnalisées).

Si vous souhaitez créer une version de solution supplémentaire pour une solution existante, créez une nouvelle version de solution à partir de la page de présentation de la solution comme suit.

Pour créer une nouvelle version de solution

  1. Ouvrez la console Amazon Personalize à l'adresse https://console.aws.amazon.com/personalize/home et connectez-vous à votre compte.

  2. Accédez à la page des groupes de jeux de données et choisissez le groupe de jeux de données avec votre nouvelle solution.

  3. Dans le volet de navigation, sous Ressources personnalisées, sélectionnez Solutions et recettes.

  4. Sur la page Solution et recettes, choisissez la solution pour laquelle vous souhaitez créer une version de solution.

  5. Sur la page de présentation de la solution, choisissez Créer une version de solution pour commencer à entraîner un nouveau modèle.

Sur la page des détails de la solution, vous pouvez suivre la progression de la formation dans la section Versions de la solution. Lorsque la formation est terminée, le statut est Actif, vous pouvez l'évaluer à l'aide des indicateurs fournis par Amazon Personalize. Pour plus d’informations, consultez Évaluation d'une version de solution à l'aide de métriques.

Si la formation ne se termine pas en raison d'une erreur, elle ne vous sera pas facturée. Si le statut de la version de votre solution est CREATE_PENDING ou CREATE_IN_PROGRESS, vous pouvez arrêter le processus de création de version de solution. Pour arrêter la création d'une version de solution, accédez à la page de détails de la version de solution et choisissez Arrêter. veuillez consulter Arrêt de la création d'une version de solution.

La façon dont vous utilisez une version de solution active dépend de la manière dont vous obtenez les recommandations :

  • Pour obtenir des recommandations en temps réel, vous déployez une version de la solution ACTIVE avec une campagne Amazon Personalize. Vous utilisez la campagne pour obtenir des recommandations pour vos utilisateurs. veuillez consulter Création d'une campagne.

  • Pour les recommandations par lots, vous devez spécifier une version de solution ACTIVE lorsque vous créez une tâche d'inférence par lots ou une tâche de segmentation par lots. veuillez consulter Recommandations par lots et segments d'utilisateurs (ressources personnalisées).

Création d'une version de solution (AWS CLI)

Lorsque votre solution est ACTIVE, entraînez le modèle en exécutant la commande suivante. solution arnRemplacez-le par la solution Amazon Resource Name (ARN) deCréation et configuration d'une solution.

aws personalize create-solution-version \
  --solution-arn solution arn

L'ARN de version de solution est affiché, par exemple :

{
  "solutionVersionArn": "arn:aws:personalize:us-west-2:acct-id:solution/SolutionName/<version-id>"
}

Vérifiez l'état d'entraînement de la version de la solution à l'aide de la describe-solution-version commande. Fournissez l'ARN de la version de solution qui a été renvoyé lors de l'étape précédente. Pour plus d’informations sur l’API, consultez DescribeSolutionVersion.

aws personalize describe-solution-version \
  --solution-version-arn solution version arn

Les propriétés de la version de solution et le status de formation sont affichés. Initialement, le statut indique CREATE PENDING (CRÉATION EN ATTENTE), par exemple :

{
  "solutionVersion": {
      "solutionVersionArn": "arn:aws:personalize:us-west-2:acct-id:solution/solutionName/<version-id>",
      ...,
      "status": "CREATE PENDING"
  }
}

La formation est terminée lorsqu'elle status est terminée ACTIVE et vous pouvez l'évaluer à l'aide des indicateurs fournis par Amazon Personalize. Pour plus d’informations, consultez Évaluation d'une version de solution à l'aide de métriques. Si la formation ne se termine pas en raison d'une erreur, elle ne vous sera pas facturée.

Si le statut de la version de votre solution est CREATE_PENDING ou CREATE_IN_PROGRESS, vous pouvez utiliser cette StopSolutionVersionCreation opération pour arrêter le processus de création de la version de solution. veuillez consulter Arrêt de la création d'une version de solution.

La façon dont vous utilisez une version de solution active dépend de la manière dont vous obtenez les recommandations :

  • Pour obtenir des recommandations en temps réel, vous déployez une version de la solution ACTIVE avec une campagne Amazon Personalize. Vous utilisez la campagne pour obtenir des recommandations pour vos utilisateurs. veuillez consulter Création d'une campagne.

  • Pour les recommandations par lots, vous devez spécifier une version de solution ACTIVE lorsque vous créez une tâche d'inférence par lots ou une tâche de segmentation par lots. veuillez consulter Recommandations par lots et segments d'utilisateurs (ressources personnalisées).

Création d'une version de solution (AWS SDK)

Lorsque votre solution est ACTIVE, utilisez le code suivant pour créer une version de solution. Spécifiez le nom de ressource Amazon (ARN) à partir deCréation et configuration d'une solution. Utilisez l'DescribeSolutionVersionopération pour récupérer l'état de la version de la solution.

SDK for Python (Boto3)
import boto3

personalize = boto3.client('personalize')
# Store the solution ARN
solution_arn = 'solution arn'
        
# Use the solution ARN to get the solution status.
solution_description = personalize.describe_solution(solutionArn = 'solution_arn')['solution']
print('Solution status: ' + solution_description['status'])

# Use the solution ARN to create a solution version.
print ('Creating solution version')
response = personalize.create_solution_version(solutionArn = solution_arn)
solution_version_arn = response['solutionVersionArn']
print('Solution version ARN: ' + solution_version_arn)

# Use the solution version ARN to get the solution version status.
solution_version_description = personalize.describe_solution_version(
    solutionVersionArn = solution_version_arn)['solutionVersion']
print('Solution version status: ' + solution_version_description['status'])
SDK for Java 2.x
public static String createPersonalizeSolutionVersion(PersonalizeClient personalizeClient, String solutionArn) {
        long maxTime = 0;
        long waitInMilliseconds = 30 * 1000; // 30 seconds
        String solutionStatus = "";
        String solutionVersionStatus = "";
        String solutionVersionArn = "";

        try {
            DescribeSolutionRequest describeSolutionRequest = DescribeSolutionRequest.builder()
                .solutionArn(solutionArn)
                .build();
            
            maxTime = Instant.now().getEpochSecond() + 3 * 60 * 60;

            // Wait until solution is active. 
            while (Instant.now().getEpochSecond() < maxTime) {

                solutionStatus = personalizeClient.describeSolution(describeSolutionRequest).solution().status();
                System.out.println("Solution status: " + solutionStatus);

                if (solutionStatus.equals("ACTIVE") || solutionStatus.equals("CREATE FAILED")) {
                    break;
                }
                try {
                    Thread.sleep(waitInMilliseconds);
                } catch (InterruptedException e) {
                    System.out.println(e.getMessage());
                }
            }
            
            // Once the solution is active, start creating a solution version.
            
            if (solutionStatus.equals("ACTIVE")) {

                CreateSolutionVersionRequest createSolutionVersionRequest = CreateSolutionVersionRequest.builder()
                    .solutionArn(solutionArn)
                    .build();
                
                CreateSolutionVersionResponse createSolutionVersionResponse = personalizeClient.createSolutionVersion(createSolutionVersionRequest);
                solutionVersionArn = createSolutionVersionResponse.solutionVersionArn();

                System.out.println("Solution version ARN: " + solutionVersionArn);

                DescribeSolutionVersionRequest describeSolutionVersionRequest = DescribeSolutionVersionRequest.builder() 
                    .solutionVersionArn(solutionVersionArn)
                    .build();
                
                maxTime = Instant.now().getEpochSecond() + 3 * 60 * 60;
                
                while (Instant.now().getEpochSecond() < maxTime) {

                    // Use the solution version ARN to get the solution version status.
                    solutionVersionStatus = personalizeClient.describeSolutionVersion(describeSolutionVersionRequest).solutionVersion().status();
                    System.out.println("Solution version status: " + solutionVersionStatus);
    
                    if (solutionVersionStatus.equals("ACTIVE") || solutionVersionStatus.equals("CREATE FAILED")) {
                        break;
                    }
                    try {
                        Thread.sleep(waitInMilliseconds);
                    } catch (InterruptedException e) {
                        System.out.println(e.getMessage());
                    }
                }
                return solutionVersionArn;
            }
        } catch(PersonalizeException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
        return "";
    }
SDK for JavaScript v3
// Get service clients module and commands using ES6 syntax.
import { CreateSolutionVersionCommand } from
  "@aws-sdk/client-personalize";
import { personalizeClient } from "./libs/personalizeClients.js";
// Or, create the client here.
// const personalizeClient = new PersonalizeClient({ region: "REGION"});

// Set the solution version parameters.
export const solutionVersionParam = {
  solutionArn: 'SOLUTION_ARN' /* required */
}

export const run = async () => {
  try {
    const response = await personalizeClient.send(new CreateSolutionVersionCommand(solutionVersionParam));
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

Pour vérifier le statut de la version de solution actuelle, appelez l’opération DescribeSolutionVersion et transmettez l'ARN de la version de solution renvoyée à partir de l’opération CreateSolutionVersion. La formation est terminée lorsqu'elle status est terminée ACTIVE et vous pouvez l'évaluer à l'aide des indicateurs fournis par Amazon Personalize. Pour plus d’informations, consultez Évaluation d'une version de solution à l'aide de métriques. Si la formation ne se termine pas en raison d'une erreur, elle ne vous sera pas facturée.

Si le statut de la version de votre solution est CREATE_PENDING ou CREATE_IN_PROGRESS, vous pouvez utiliser cette StopSolutionVersionCreation opération pour arrêter le processus de création de la version de solution. veuillez consulter Arrêt de la création d'une version de solution.

La façon dont vous utilisez une version de solution active dépend de la manière dont vous obtenez les recommandations :

  • Pour obtenir des recommandations en temps réel, vous déployez une version de la solution ACTIVE avec une campagne Amazon Personalize. Vous utilisez la campagne pour obtenir des recommandations pour vos utilisateurs. veuillez consulter Création d'une campagne.

  • Pour les recommandations par lots, vous devez spécifier une version de solution ACTIVE lorsque vous créez une tâche d'inférence par lots ou une tâche de segmentation par lots. veuillez consulter Recommandations par lots et segments d'utilisateurs (ressources personnalisées).