Passaggio 1: creazione di un gruppo di set di dati

Quando inizi a utilizzare Amazon Personalize, crei un gruppo di set di dati. Un gruppo di set di dati è un contenitore per le risorse di Amazon Personalize, inclusi set di dati, consigli di dominio e risorse personalizzate. Un gruppo di set di dati organizza le risorse in raccolte indipendenti, in cui le risorse di un gruppo di set di dati non possono influenzare le risorse di nessun altro gruppo di set di dati.

Crei un gruppo di set di dati per ciascuno dei tuoi domini aziendali. Ad esempio, potreste avere un'applicazione che fornisce consigli per lo streaming di video e un'altra che fornisce consigli per gli audiolibri. In Amazon Personalize, devi creare un gruppo di set di dati per ogni applicazione. In questo modo, i dati di un'applicazione non influiscono sui consigli generati da Amazon Personalize per l'altra applicazione.

Puoi creare un gruppo di set di dati di dominio o un gruppo di set di dati personalizzato:

• Con un gruppo di set di dati Domain, crei risorse preconfigurate e ottimizzate per diversi casi d'uso. Quando crei un gruppo di set di dati, lo rendi un gruppo di set di dati di dominio specificando un dominio di VIDEO_ON_DEMAND o ECOMMERCE.

  Se disponi di un'applicazione di streaming video o di e-commerce, ti consigliamo di creare un gruppo di set di dati Domain. Puoi comunque aggiungere risorse personalizzate, come soluzioni e versioni di soluzioni addestrate per casi d'uso personalizzati. Non è possibile creare le risorse Next Best Action, inclusi i set di dati Actions e Action Interactions, in un gruppo di set di dati di dominio.

• Un gruppo di set di dati personalizzato include solo risorse personalizzate configurate in base al caso d'uso. Con risorse personalizzate, puoi addestrare e distribuire soluzioni e versioni configurabili (un modello di raccomandazione Amazon Personalize addestrato) in base alle tue esigenze aziendali. Se non disponi di un'applicazione VIDEO_ON_DEMAND o ECOMMERCE, ti consigliamo di creare un gruppo di set di dati personalizzato. Altrimenti, ti consigliamo di iniziare con un gruppo di set di dati di dominio e aggiungere risorse personalizzate se necessario.

Puoi creare un gruppo di set di dati con la console Amazon Personalize AWS Command Line Interface ,AWS CLI() o gli SDK. AWS

Creazione di un gruppo di set di dati (console)

Crea un gruppo di set di dati specificando il nome del gruppo di set di dati nella console Amazon Personalize.

Per creare un gruppo di set di dati

1. Apri la console Amazon Personalize all'indirizzo https://console.aws.amazon.com/personalize/home e accedi al tuo account.

2. Scegliere Create dataset group (Crea gruppodi set di dati).

3. Se è la prima volta che usi Amazon Personalize, nella pagina Crea gruppo di set di dati, in Nuovo gruppo di set di dati, scegli Inizia.

4. Sotto Dataset group details (Dettagli del gruppo di set di dati), perDataset group name (Nome gruppo di set di dati) specifica un nome per il gruppo di set di dati.

5. Scegli il tuo dominio:

   • Scegli E-commerce per creare un gruppo di set di dati di domini ECOMMERCE.

   • Scegli Video on demand per creare un gruppo di set di dati di dominio VIDEO_ON_DEMAND.

   • Scegliete Personalizzato per creare un gruppo di set di dati personalizzato con solo risorse personalizzate, come soluzioni, campagne e lavori di inferenza in batch.

6. Per i tag, aggiungi facoltativamente qualsiasi tag. Per ulteriori informazioni sull'etichettatura delle risorse Amazon Personalize, consulta. Etichettare le risorse di Amazon Personalize

7. Scegliere Create dataset group (Crea gruppodi set di dati). Viene visualizzata la pagina Panoramica. Ora sei pronto per importare i dati. Per informazioni, consulta Fase 2: Preparazione e importazione dei dati.

Creazione di un gruppo di set di dati ()AWS CLI

Per creare un gruppo di set di dati, utilizzare l'create-dataset-groupoperazione. Per creare un gruppo di set di dati di dominio, per il dominio specificare ECOMMERCE o. VIDEO_ON_DEMAND Per creare un gruppo di set di dati personalizzato, non specificare un dominio. Puoi utilizzare il parametro Tags per etichettare facoltativamente le risorse in Amazon Personalize. Per un esempio, consulta. Aggiungere tag (AWS CLI)

Il codice seguente crea un gruppo di set di dati Domain per il VIDEO_ON_DEMAND dominio.

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

In caso di successo, il gruppo di set di dati Amazon Resource Name (ARN) viene visualizzato come segue.

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

Registra questo valore per utilizzi futuri. Per visualizzare il gruppo di set di dati creato, utilizzare il describe-dataset-group comando e specificare l'ARN del gruppo di set di dati restituito.

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

Il gruppo di set di dati e le relative proprietà vengono visualizzati come segue.

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

Quando il gruppo di set di dati status è ATTIVO, sei pronto per importare i dati. Per ulteriori informazioni, consulta Fase 2: Preparazione e importazione dei dati.

Creazione di un gruppo di set di dati (SDK)AWS

Utilizza il codice seguente per creare un gruppo di set di dati di dominio. Assegna un nome al gruppo di set di dati Domain e perdomain, specifica oECOMMERCE. VIDEO_ON_DEMAND Per creare un gruppo di set di dati personalizzato, modifica il codice per rimuovere il parametro domain.

Per ulteriori informazioni sul funzionamento dell'API, consulta CreateDatasetGroup la sezione di riferimento dell'API. Puoi utilizzare il parametro Tags per etichettare facoltativamente le risorse in Amazon Personalize. Per un esempio, consulta. Aggiungere tag (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'DescribeDatasetGroupoperazione restituisce datasetGroupArn e lo stato dell'operazione. Quando il gruppo di set di dati status è ATTIVO, sei pronto per importare i dati. Per ulteriori informazioni, consulta Fase 2: Preparazione e importazione dei dati.