Étape 1 : Création d'un groupe de jeux de données

Lorsque vous commencez à utiliser Amazon Personalize, vous créez un groupe de jeux de données. Un groupe de jeux de données est un conteneur pour les ressources Amazon Personalize, notamment les ensembles de données, les recommandations de domaines et les ressources personnalisées. Un groupe de jeux de données organise vos ressources en collections indépendantes, dans lesquelles les ressources d'un groupe de jeux de données ne peuvent influencer les ressources d'aucun autre groupe de jeux de données.

Vous créez un groupe de jeux de données pour chacun de vos domaines commerciaux. Par exemple, vous pouvez avoir une application qui fournit des recommandations pour le streaming vidéo et une autre qui fournit des recommandations pour les livres audio. Dans Amazon Personalize, vous devez créer un groupe de jeux de données pour chaque application. Ainsi, les données d'une application n'influencent pas les recommandations qu'Amazon Personalize génère pour l'autre application.

Vous pouvez créer un groupe de jeux de données de domaine ou un groupe de jeux de données personnalisé :

• Avec un groupe de jeux de données de domaine, vous créez des ressources préconfigurées et optimisées pour différents cas d'utilisation. Lorsque vous créez un groupe de jeux de données, vous en faites un groupe de données de domaine en spécifiant un domaine VIDEO_ON_DEMAND ou ECOMMERCE.

  Si vous possédez une application de streaming vidéo ou de commerce électronique, nous vous recommandons de créer un groupe de jeux de données de domaine. Vous pouvez toujours ajouter des ressources personnalisées, telles que des solutions et des versions de solutions conçues pour des cas d'utilisation personnalisés. Vous ne pouvez pas créer les meilleures ressources d'action suivantes, notamment les ensembles de données d'actions et d'interactions d'action, dans un groupe de jeux de données de domaine.

• Un groupe de jeux de données personnalisé inclut uniquement des ressources personnalisées que vous configurez en fonction de votre cas d'utilisation. Grâce à des ressources personnalisées, vous formez et déployez des solutions et des versions de solutions configurables (un modèle de recommandation Amazon Personalize formé) en fonction des besoins de votre entreprise. Si vous ne possédez pas d'application VIDEO_ON_DEMAND ou de commerce électronique, nous vous recommandons de créer un groupe de jeux de données personnalisé. Dans le cas contraire, nous vous recommandons de commencer par un groupe de jeux de données de domaine et d'ajouter des ressources personnalisées si nécessaire.

Vous pouvez créer un groupe de jeux de données à l'aide de la console Amazon Personalize AWS Command Line Interface (AWS CLI) ou AWS des SDK.

Création d'un groupe de jeux de données (console)

Créez un groupe de jeux de données en spécifiant le nom du groupe de données dans la console Amazon Personalize.

Pour créer un groupe de jeux de données

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

2. Choisissez Create dataset group (Créer un groupe d'ensembles de données).

3. Si c'est la première fois que vous utilisez Amazon Personalize, sur la page Créer un groupe de jeux de données, dans Nouveau groupe de jeux de données, choisissez Get started.

4. Sous Dataset group details (Informations du groupe d'ensembles de données), pour Dataset group name (Nom du groupe d'ensembles de données), spécifiez un nom pour votre groupe d'ensembles de données.

5. Choisissez votre domaine :

   • Choisissez E-commerce pour créer un groupe de jeux de données de domaines ECOMMERCE.

   • Choisissez Vidéo à la demande pour créer un groupe de jeux de données de domaine VIDEO_ON_DEMAND.

   • Choisissez Personnalisé pour créer un groupe de jeux de données personnalisé contenant uniquement des ressources personnalisées, telles que des solutions, des campagnes et des tâches d'inférence par lots.

6. Pour les balises, ajoutez éventuellement des balises. Pour plus d'informations sur le balisage des ressources Amazon Personalize, consultezMarquer les ressources Amazon Personalize.

7. Choisissez Create dataset group (Créer un groupe d'ensembles de données). La page Vue d'ensemble s'affiche. Vous êtes maintenant prêt à importer des données. veuillez consulter Étape 2 : Préparation et importation des données.

Création d'un groupe de jeux de données (AWS CLI)

Pour créer un groupe de jeux de données, utilisez l'create-dataset-groupopération. Pour créer un groupe de jeux de données de domaine, pour le domaine, spécifiez ECOMMERCE ouVIDEO_ON_DEMAND. Pour créer un groupe de jeux de données personnalisé, ne spécifiez pas de domaine. Vous pouvez utiliser le paramètre Tags pour étiqueter éventuellement les ressources dans Amazon Personalize. Pour un exemple, voirAjouter des tags (AWS CLI).

Le code suivant crée un groupe de jeux de données de domaine pour le VIDEO_ON_DEMAND domaine.

aws personalize create-dataset-group \
--name dataset-group-name \
--domain VIDEO_ON_DEMAND

En cas de succès, le groupe de données Amazon Resource Name (ARN) s'affiche comme suit.

{
  "datasetGroupArn": "arn:aws:personalize:us-west-2:acct-id:dataset-group/DatasetGroupName"
}

Enregistrez cette valeur pour une utilisation future. Pour afficher le groupe de jeux de données que vous avez créé, utilisez la describe-dataset-group commande et spécifiez l'ARN du groupe de jeux de données renvoyé.

aws personalize describe-dataset-group \
--dataset-group-arn dataset group arn
    

Le groupe de jeux de données et ses propriétés s'affichent comme suit.

{
    "datasetGroup": {
        "name": "DatasetGroupName",
        "datasetGroupArn": "arn:aws:personalize:us-west-2:acct-id:dataset-group/DatasetGroupName",
        "status": "ACTIVE",
        "creationDateTime": 1542392161.262,
        "lastUpdatedDateTime": 1542396513.377
    }
}

Lorsque le groupe de jeux de données status est ACTIF, vous êtes prêt à importer des données. Pour plus d’informations, consultez Étape 2 : Préparation et importation des données.

Création d'un groupe de jeux de données (AWS SDK)

Utilisez le code suivant pour créer un groupe de jeux de données de domaine. Donnez un nom au groupe de jeux de données de domaine, et pourdomain, spécifiez l'un ECOMMERCE ou l'autreVIDEO_ON_DEMAND. Pour créer un groupe de jeux de données personnalisé, modifiez le code pour supprimer le paramètre de domaine.

Pour plus d'informations sur le fonctionnement de l'API, consultez CreateDatasetGroup la section de référence de l'API. Vous pouvez utiliser le paramètre Tags pour étiqueter éventuellement les ressources dans Amazon Personalize. Pour un exemple, voirAjouter des balises (AWS SDK).

SDK for Python (Boto3)

import boto3

personalize = boto3.client('personalize')

response = personalize.create_dataset_group(
  name = 'dataset group name',
  domain = 'business domain'
)
dsg_arn = response['datasetGroupArn']

description = personalize.describe_dataset_group(datasetGroupArn = dsg_arn)['datasetGroup']

print('Name: ' + description['name'])
print('ARN: ' + description['datasetGroupArn'])
print('Status: ' + description['status'])

SDK for Java 2.x

public static String createDomainDatasetGroup(PersonalizeClient personalizeClient, 
                                              String datasetGroupName,
                                              String domain) {

    try {
        CreateDatasetGroupRequest createDatasetGroupRequest = CreateDatasetGroupRequest.builder()
                .name(datasetGroupName)
                .domain(domain)
                .build();
        return personalizeClient.createDatasetGroup(createDatasetGroupRequest).datasetGroupArn();
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}

SDK for JavaScript v3

// Get service clients module and commands using ES6 syntax.
import {  CreateDatasetGroupCommand } from
  "@aws-sdk/client-personalize";
import { personalizeClient } from "./libs/personalizeClients.js";

// Or, create the client here.
// const personalizeClient = new PersonalizeClient({ region: "REGION"});

// Set the domain dataset group parameters.
export const domainDatasetGroupParams = {
  name: 'NAME',  /* required */
  domain: 'DOMAIN'   /* required for a domain dsg, specify ECOMMERCE or VIDEO_ON_DEMAND */
}

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

L'DescribeDatasetGroupopération renvoie le datasetGroupArn et le statut de l'opération. Lorsque le groupe de jeux de données status est ACTIF, vous êtes prêt à importer des données. Pour plus d'informations, voir Étape 2 : Préparation et importation des données.