Etapa 1: criar um grupo de conjuntos de dados

Ao começar a usar o Amazon Personalize, crie um grupo de conjuntos de dados. Um grupo de conjuntos de dados é um contêiner para recursos do Amazon Personalize, incluindo conjuntos de dados, recomendadores de domínio e recursos personalizados. Um grupo de conjuntos de dados organiza seus recursos em coleções independentes, nas quais os recursos de um grupo de conjuntos de dados não podem influenciar os recursos em nenhum outro grupo de conjuntos de dados.

Crie um grupo de conjuntos de dados para cada um dos seus domínios de negócios. Por exemplo, você pode ter um aplicativo que faça recomendações de streaming de vídeo e outro que faça recomendações de audiolivros. No Amazon Personalize, você criaria um grupo de conjuntos de dados para cada aplicativo. Dessa forma, os dados de um aplicativo não influenciam as recomendações que o Amazon Personalize gera para o outro aplicativo.

Você pode criar um grupo de conjuntos de dados de domínio ou personalizado:

• Com um grupo de conjuntos de dados de domínio, você cria recursos pré-configurados e otimizados para diferentes casos de uso. Ao criar um grupo de conjuntos de dados, você o torna um grupo de conjuntos de dados de domínio especificando um domínio de VIDEO_ON_DEMAND ou ECOMMERCE.

  Se você tiver um aplicativo de streaming de vídeo ou de comércio eletrônico, recomendamos que crie um grupo de conjuntos de dados de domínio. Você ainda pode adicionar recursos personalizados, como soluções e versões de soluções treinadas para casos de uso personalizados. Você não pode criar os próximos melhores recursos de ação, incluindo conjuntos de dados de ações e interações de ações, em um grupo de conjuntos de dados de domínio.

• Um grupo de conjuntos de dados personalizado inclui somente recursos personalizados que você configura, dependendo do seu caso de uso. Com recursos personalizados, você treina e implanta soluções e versões de soluções configuráveis (um modelo de recomendação treinado do Amazon Personalize) com base nas necessidades da sua empresa. Se você não tiver um aplicativo de VIDEO_ON_DEMAND ou ECOMMERCE, recomendamos que crie um grupo de conjuntos de dados personalizados. Caso contrário, recomendamos começar com um grupo de conjuntos de dados de domínio e adicionar recursos personalizados conforme necessário.

Você pode criar um grupo de conjuntos de dados com o console Amazon Personalize AWS Command Line Interface ,AWS CLI() ou SDKs. AWS

Criar um grupo de conjuntos de dados (console)

Crie um grupo de conjuntos de dados especificando o nome do grupo de conjuntos de dados no console do Amazon Personalize.

Para criar um grupo de conjuntos de dados.

1. Abra o console do Amazon Personalize em https://console.aws.amazon.com/personalize/home e faça login na sua conta.

2. Escolha Criar grupo de conjuntos de dados.

3. Se esta for a primeira vez que você usa o Amazon Personalize, na página Criar grupo de conjuntos de dados, em Novo grupo de conjuntos de dados, escolha Começar.

4. Em Dataset group details (Detalhes do grupo de conjuntos de dados), em Dataset group name (Nome do grupo de conjuntos de dados), especifique um nome para o grupo de conjuntos de dados.

5. Escolha o seu domínio:

   • Escolha Comércio eletrônico para criar um grupo de conjuntos de dados de domínio ECOMMERCE.

   • Escolha Vídeo sob demanda para criar um grupo de conjuntos de dados de domínio VIDEO_ON_DEMAND.

   • Escolha Personalizado para criar um grupo de conjuntos de dados personalizados somente com recursos personalizados, como soluções, campanhas e trabalhos de inferência em lote.

6. Para Tags, é possível adicionar quaisquer tags. Para obter mais informações sobre recursos de atribuição de tags do Amazon Personalize, consulte Usar tags nos recursos do Amazon Personalize.

7. Escolha Criar grupo de conjuntos de dados. A página Visão geral é exibida. Agora, você está pronto para importar dados. Consulte Etapa 2: preparar e importar dados.

Criar um grupo de conjuntos de dados (AWS CLI)

Para criar um grupo de conjuntos de dados, use a operação create-dataset-group. Para criar um grupo de conjuntos de dados de domínio, para domínio, especifique ECOMMERCE ou VIDEO_ON_DEMAND. Para criar um grupo de conjuntos de dados personalizado, não especifique um domínio. Você pode usar o parâmetro Tags para ter a opção de marcar recursos no Amazon Personalize. Para obter uma amostra, consulte Adicionar tags (AWS CLI).

O código a seguir cria um grupo de conjuntos de dados de domínio para o domínio VIDEO_ON_DEMAND.

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

Se for bem-sucedido, o nome do recurso da Amazon (ARN) do grupo de conjuntos de dados será exibido da seguinte forma.

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

Registre esse valor para uso futuro. Para exibir o grupo de conjuntos de dados que criou, use o comando describe-dataset-group e especifique o ARN do grupo de conjuntos de dados retornado.

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

O grupo de conjuntos de dados e suas propriedades são exibidos da seguinte forma.

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

Quando o status do grupo do conjunto de dados for ATIVO, você estará pronto para importar dados. Para ter mais informações, consulte Etapa 2: preparar e importar dados.

Criação de um grupo de conjuntos de dados (AWS SDKs)

Use o código a seguir para criar um grupo de conjuntos de dados de domínio. Dê um nome ao grupo de conjuntos de dados de domínio e, para o domain, especifique ECOMMERCE ou VIDEO_ON_DEMAND. Para criar um grupo de conjuntos de dados personalizados, modifique o código para remover o parâmetro de domínio.

Para obter mais informações sobre a operação da API, consulte CreateDatasetGroup na seção de referência de API. Você pode usar o parâmetro Tags para ter a opção de marcar recursos no Amazon Personalize. Para obter uma amostra, consulte Adicionar tags (AWS SDKs).

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();

A operação DescribeDatasetGroup retorna o datasetGroupArn e o status da operação. Quando o status do grupo do conjunto de dados for ATIVO, você estará pronto para importar dados. Para ter mais informações, consulte Etapa 2: preparar e importar dados.