Paso 1: Creación de un grupo de conjunto de datos

Cuando comience a usar Amazon Personalize, cree un grupo de conjuntos de datos. Un grupo de conjuntos de datos es un contenedor para los recursos de Amazon Personalize, incluidos los conjuntos de datos, los generadores de recomendaciones de dominios y los recursos personalizados. Un grupo de conjuntos de datos organiza sus recursos en colecciones independientes, de modo que los recursos de un grupo de conjuntos de datos no pueden influir en los de ningún otro grupo de conjuntos de datos.

Puede crear un grupo de conjunto de datos para cada uno de sus dominios de negocio. Por ejemplo, es posible que tenga una aplicación que proporciona recomendaciones para el streaming en vídeo y otra que ofrece recomendaciones para audiolibros. En Amazon Personalize, crearía un grupo de conjuntos de datos para cada aplicación. De esta forma, los datos de una aplicación no influyen en las recomendaciones que Amazon Personalize genera para la otra aplicación.

Puede crear un grupo de conjuntos de datos de dominio o un grupo de conjuntos de datos personalizado:

• Con un Grupo de conjuntos de datos de dominio, se crean recursos preconfigurados y optimizados para distintos casos de uso. Cuando crea un grupo de conjuntos de datos, lo convierte en un grupo de conjuntos de datos de dominio especificando un dominio de VIDEO_ON_DEMAND o ECOMMERCE.

  Si tiene una aplicación de streaming en vídeo o de comercio electrónico, recomendamos que cree un grupo de conjuntos de datos de dominio. Aún puede añadir recursos personalizados, como soluciones y versiones de soluciones entrenadas para casos de uso personalizados.

• Un Grupo de conjuntos de datos personalizados solo incluye los recursos personalizados que se configuran en función del caso de uso. Con los recursos personalizados, puede entrenar e implementar soluciones configurables y versiones de soluciones (un modelo de recomendación de Amazon Personalize entrenado) en función de las necesidades de su empresa. Si no tiene una aplicación de VIDEO_ON_DEMAND o ECOMMERCE, le recomendamos que cree un grupo de conjuntos de datos personalizado. De lo contrario, recomendamos empezar con un grupo de conjuntos de datos de dominio y añadir recursos personalizados según sea necesario.

Puede crear un grupo de conjuntos de datos con la consola Amazon Personalize, AWS Command Line Interface (AWS CLI) o los SDK de AWS.

Creación de un grupo de conjuntos de datos (consola)

Cree un grupo de conjuntos de datos especificando el nombre del grupo de conjuntos de datos en la consola de Amazon Personalize.

Para crear un grupo de conjuntos de datos.

1. Abra la consola de Amazon Personalize en https://console.aws.amazon.com/personalize/home e inicie sesión en su cuenta.

2. Elija Crear grupo de conjuntos de datos.

3. Si es la primera vez que utiliza Amazon Personalize, en la página Crear grupo de conjunto de datos, en Nuevo grupo de conjunto de datos, elija Comenzar.

4. En Detalles del grupo de conjuntos de datos, en Nombre del grupo de conjuntos de datos, especifique un nombre para el grupo de conjuntos de datos.

5. Seleccione su Dominio:

   • Elija Comercio electrónico para crear un grupo de conjuntos de datos de dominio de ECOMMERCE.

   • Elija Vídeo en diferido para crear un grupo de conjuntos de datos de dominio de VIDEO_ON_DEMAND.

   • Elija Personalizado para crear un grupo de conjuntos de datos personalizado con solo recursos personalizados, como soluciones, campañas y trabajos de inferencia por lotes.

6. Para Etiquetas, si lo desea, añada cualquier etiqueta. Para obtener más información acerca del etiquetado de recursos de Amazon Personalize, consulte Etiquetado de recursos de Amazon Personalize.

7. Elija Crear grupo de conjuntos de datos. Se abre la página Información general. Ahora ya puede importar datos. Consulte Paso 2: Preparación e importación de datos.

Creación de un grupo de conjuntos de datos (AWS CLI)

Para crear un grupo de conjuntos de datos, utilice la operación create-dataset-group. Para crear un grupo de conjuntos de datos de dominio, para el dominio especifique ECOMMERCE o VIDEO_ON_DEMAND. Para crear un grupo de conjuntos de datos personalizado, no especifique un dominio. Puede utilizar el parámetro Etiquetas para etiquetar, de forma opcional, los recursos en Amazon Personalize. Para ver un ejemplo, consulte Adición de etiquetas (AWS CLI).

El siguiente código crea un grupo de conjuntos de datos de dominio para el dominio VIDEO_ON_DEMAND.

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

Si se ejecuta correctamente, el nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos se muestra de la siguiente manera.

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

Registre este valor para su uso futuro. Para visualizar el grupo de conjunto de datos que ha creado, utilice el comando describe-dataset-group y especifique el ARN del grupo de conjuntos de datos devuelto.

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

El grupo de conjuntos de datos y sus propiedades se muestran de la siguiente manera.

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

Cuando el grupo de conjuntos de datos status esté ACTIVO, estará listo para importar datos. Para obtener más información, consulte Paso 2: Preparación e importación de datos.

Creación de un grupo de conjuntos de datos (SDK de AWS)

Cree un grupo de conjuntos de datos de dominio con el siguiente código. Asigne un nombre al grupo de conjuntos de datos de dominio y, para domain, especifique ECOMMERCE o VIDEO_ON_DEMAND. Para crear un grupo de conjuntos de datos personalizado, modifique el código para eliminar el parámetro de dominio.

Para obtener más información sobre estas operaciones de la API, consulte CreateDatasetGroup en la sección de referencia de la API. Puede utilizar el parámetro Etiquetas para etiquetar, de forma opcional, los recursos en Amazon Personalize. Para ver un ejemplo, consulte Añadir etiquetas (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();

La operación DescribeDatasetGroup devuelve el datasetGroupArn y el estado de la operación. Cuando el grupo de conjuntos de datos status esté ACTIVO, estará listo para importar datos. Para obtener más información, consulte Paso 2: Preparación e importación de datos.