Implantação de uma versão da solução Amazon Personalize com uma campanha

Para recomendações em tempo real com recursos personalizados, depois de concluir Criar uma versão da solução, você estará pronto para implantar sua versão da solução com uma campanha.

Uma campanha implanta uma versão da solução (modelo treinado) com uma capacidade de transação provisionada para gerar recomendações em tempo real. Depois de criar uma campanha, você pode usar as operações de API GetRecommendations ou GetPersonalizedRanking para obter recomendações. Se você está recebendo recomendações de itens em lote ou segmentos de usuários, não precisa criar uma campanha. Para obter mais informações, consulte Obtendo recomendações de itens em lote ou Obtendo segmentos de usuários em lote.

Ao criar uma campanha, você pode configurar o seguinte:

• Você pode configurar a campanha para ser atualizada automaticamente para usar a versão mais recente da solução. Para obter mais informações, consulte Ativando atualizações automáticas da campanha.

• Você pode ativar os metadados do item nas recomendações. Para ter mais informações, consulte Metadados do item nas recomendações.

• Você pode especificar o mínimo de transações provisionadas por segundo para a campanha. Esse é o throughput de transação básico para a campanha provisionada pelo Amazon Personalize. Ele define a cobrança mínima para a campanha enquanto ela está ativa. Para ter mais informações, consulte Transações mínimas por segundo provisionadas e ajuste de escala automático.

Você pode criar uma campanha com o console Amazon Personalize, AWS Command Line Interface (AWS CLI) ou AWS SDKs. Se você quiser alterar as configurações de uma campanha existente, como ativar metadados nas recomendações, atualize sua campanha. Para ter mais informações, consulte Atualizando a configuração de uma campanha do Amazon Personalize.

Você incorre nos custos da campanha enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter informações sobre os custos da campanha, consulte os preços do Amazon Personalize.

Tópicos

• Ativando atualizações automáticas da campanha
• Transações mínimas por segundo provisionadas e ajuste de escala automático
• Metadados do item nas recomendações
• Criar uma campanha (console)
• Criar uma campanha (AWS CLI)
• Criação de uma campanha (AWS SDKs)
• Atualizando a configuração de uma campanha do Amazon Personalize

Ativando atualizações automáticas da campanha

Ao criar uma campanha, você pode ativar as atualizações automáticas da campanha. Com as atualizações automáticas, a campanha é atualizada automaticamente para implantar a versão mais recente da solução treinada automática ou manualmente. Isso torna mais fácil para você manter sua campanha atualizada.

Por exemplo, se sua solução usa treinamento automático para criar uma nova versão da solução a cada sete dias, sua campanha será atualizada automaticamente para usar a versão mais recente da solução para cada treinamento semanal. Se você não usa atualizações automáticas da campanha, deve atualizar manualmente a campanha para implantar o modelo treinado mais recente.

• Para ativar as atualizações automáticas da campanha ao criar uma campanha com o console Amazon Personalize, escolha Atualizar automaticamente para usar a versão mais recente da solução nos detalhes da campanha. Você pode encontrar a data e hora da atualização mais recente na página de detalhes da campanha.

  Para ter mais informações, consulte Criar uma campanha (console).

• Para ativar as atualizações automáticas da campanha ao usar a operação de CreateCampaign API, especifique o nome de recurso da Amazon (ARN) da sua solução em SolutionArn/$LATEST formato para o SolutionVersionArn parâmetro. NocampaignConfig, enableMetadataInInferenceResponse defina comotrue.

  Para obter a data e hora da atualização mais recente da campanha, você pode usar a operação da DescribeCampaign API e verificar latestCampaignUpdate os detalhes na resposta.

  Para exemplos de código que mostram como ativar as atualizações automáticas, consulte Criar uma campanha (AWS CLI) ouCriação de uma campanha (AWS SDKs).

Transações mínimas por segundo provisionadas e ajuste de escala automático

Importante

Um minProvisionedTPS alto aumentará o custo. Recomendamos começar com 1 para minProvisionedTPS (o padrão). Acompanhe seu uso usando CloudWatch as métricas da Amazon e aumente as minProvisionedTPS conforme necessário.

Ao criar uma campanha do Amazon Personalize, é possível especificar o mínimo de transações provisionadas por segundo (minProvisionedTPS) para a campanha. Esse é o throughput de transação básico para a campanha provisionada pelo Amazon Personalize. Ele define a cobrança mínima para a campanha enquanto ela está ativa. Transação é uma solicitação GetRecommendations ou GetPersonalizedRanking única. O minProvisionedTPS padrão é um.

Se o TPS ultrapassar o minProvisionedTPS, o Amazon Personalize fará um ajuste de escala automático da capacidade provisionada, mas nunca a definirá como abaixo de minProvisionedTPS. Há um pequeno atraso no aumento da capacidade, o que pode causar perda de transações. Quando o tráfego é reduzido, a capacidade retorna ao minProvisionedTPS.

Você é cobrado pelo TPS provisionado mínimo ou, se suas solicitações excederem o TPS minProvisionedTPS real. O TPS real é o número total de solicitações de recomendação realizadas. Recomendamos começar com uma baixaminProvisionedTPS, monitorar seu uso usando CloudWatch as métricas da Amazon e, em seguida, aumentá-las minProvisionedTPS conforme necessário.

Para obter mais informações sobre custos de campanhas, consulte Preços do Amazon Personalize.

Metadados do item nas recomendações

Importante

Se você usar a receita User-Personalization-v2 ou Personalized-Ranking-v2, você não incorrerá em custos adicionais com metadados. Para todas as outras receitas e todos os casos de uso do domínio, você incorre em custos adicionais. Para obter mais informações, consulte Preços do Amazon Personalize.

Ao receber recomendações, você pode fazer com que o Amazon Personalize inclua metadados do item nos resultados das recomendações. Na sua solicitação, você pode escolher as colunas do seu conjunto de dados Itens a serem incluídas. O Amazon Personalize exibe esses dados para cada item na resposta da recomendação.

É possível usar metadados para aprimorar as recomendações na interface de usuário, como adicionar gêneros de filmes a carrosséis. Também é possível usá-los para avaliar visualmente a qualidade da recomendação. Se você usa IA generativa na aplicação, pode conectar os metadados às solicitações de IA com o objetivo de gerar conteúdo mais relevante. Para obter mais informações sobre o uso do Amazon Personalize com IA generativa, consulte Amazon Personalize e IA generativa.

Habilitar metadados

Para adicionar metadados a recomendações, é necessário ter um conjunto de dados de itens com uma coluna de metadados. Não é necessário usar os metadados no treinamento. Para obter informações sobre como criar um conjunto de dados, consulte Criar um conjunto de dados e um esquema. Para obter informações sobre como gerenciar e atualizar dados, consulte Gerenciando os dados de treinamento em seus conjuntos de dados.

Se você usar a receita User-Personalization-V2 ou Personalized-Ranking-V2, as campanhas terão automaticamente a opção de incluir metadados do item nos resultados das recomendações. Você não precisa habilitar manualmente os metadados para sua campanha. Para todas as outras receitas e casos de uso de domínio, você deve ativar a opção de metadados:

• Para habilitar metadados com o console do Amazon Personalize, ao criar a campanha, selecione Exibir metadados de itens nos resultados da recomendação em Detalhes da campanha. Para ter mais informações, consulte Criar uma campanha (console).

• Para habilitar metadados com os AWS SDKs ou AWS CLI, use a operação da CreateCampaign API e campaignConfig defina comoenableMetadataInInferenceResponse. true Para obter mais informações, consulte Criar uma campanha (AWS CLI) ou Criação de uma campanha (AWS SDKs).

Criar uma campanha (console)

Importante

Você incorre nos custos da campanha enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter informações sobre os custos da campanha, consulte os preços do Amazon Personalize.

Quando o status da versão da solução for ativo, você estará pronto para implantá-la com uma campanha do Amazon Personalize.

Para criar uma campanha (console)

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

2. Escolha o grupo de conjuntos de dados com a versão da solução que você deseja implantar.

3. No painel de navegação, em Recursos personalizados, selecione Campanhas.

4. Na página Campanhas, escolha Criar campanha.

5. Na página Criar nova campanha, para Detalhes da campanha, forneça as seguintes informações:

   • Nome da campanha: insira o nome da campanha. O texto que você insere aqui aparece no painel Campanha e na página de detalhes.

   • Solução: escolha a solução que você acabou de criar.

   • Atualize automaticamente para usar a versão mais recente da solução — Escolha essa opção para que a campanha use automaticamente a versão mais recente da solução ativa. Se você não escolher essa opção, deverá atualizar manualmente a campanha sempre que quiser implantar uma nova versão da solução. Para ter mais informações, consulte Ativando atualizações automáticas da campanha.

   • ID da versão da solução — Se você não usa atualizações automáticas da campanha para usar a versão mais recente da solução, escolha a ID da versão da solução que você deseja implantar.

   • Transações mínimas provisionadas por segundo (chamadas de minProvisionedTPS em APIs): defina as transações mínimas provisionadas por segundo compatíveis com o Amazon Personalize. Um valor alto aumentará suas cobranças. Recomendamos que você comece com 1 (o padrão). Monitore seu uso usando CloudWatch as métricas da Amazon e aumente as minProvisionedTPS conforme necessário. Para ter mais informações, consulte Transações mínimas por segundo provisionadas e ajuste de escala automático.

   • Retornar metadados de itens nos resultados da recomendação — Escolha essa opção se quiser que a opção inclua metadados nos resultados da recomendação. Se ativado, você pode especificar as colunas do seu conjunto de dados Itens ao receber recomendações. Para ter mais informações, consulte Metadados do item nas recomendações.

6. Se você usou a receita de personalização do usuário, na configuração da campanha, você pode, opcionalmente, inserir valores para o peso de exploração e o limite de idade do item de exploração. Para ter mais informações, consulte User-Personalization.

7. 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.

8. Escolha Create campaign (Criar campanha).

9. Na página de detalhes da campanha, quando o status da campanha é Ativo, você pode usar a campanha para obter recomendações e registrar impressões. Para ter mais informações, consulte Etapa 4: obter recomendações.

   A campanha estará pronta quando seu status for ATIVO. Se você retreinar sua versão da solução ou se quiser alterar as configurações da campanha, deverá atualizá-la. Para ter mais informações, consulte Atualizando a configuração de uma campanha do Amazon Personalize.

Criar uma campanha (AWS CLI)

Importante

Você incorre nos custos da campanha enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter informações sobre os custos da campanha, consulte os preços do Amazon Personalize.

Depois que a versão da solução estiver ativa, você estará pronto para implantá-la com uma campanha Amazon Personalize. Para criar uma campanha com o AWS CLI, você usa o create-campaign comando.

O exemplo de código a seguir mostra como criar uma campanha. Ele implanta a versão mais recente de uma solução que usa a receita de personalização do usuário. A campanha que ele cria é atualizada automaticamente para usar versões futuras da solução. O código usa a seguinte configuração:

• Ele configura a campanha para ser atualizada automaticamente para usar a versão mais recente da solução: solution-version-arn Está no solution ARN/$LATEST formato e syncWithLatestSolutionVersion estáTrue. Para usar o código, solution ARN substitua pelo Amazon Resource Name (ARN) da sua solução.

  Para desativar o automáticosyncWithLatestSolutionVersion, especifique somente o ARN da versão da solução (sem/$LATEST) e syncWithLatestSolutionVersion defina como. False

• Ele define a enableMetadataWithRecommendations opção comoTrue. Isso permite que uma opção de solicitação de recomendação inclua metadados de itens de um conjunto de dados de itens com resultados de recomendação. Para desativar essa opção, defina-a comoFalse. Para ter mais informações, consulte Metadados do item nas recomendações.

• Ele é definido min-provisioned-tps como 1 (o padrão). Recomendamos começar com 1 para minProvisionedTPS (o padrão). Monitore seu uso usando CloudWatch as métricas da Amazon e aumente as minProvisionedTPS conforme necessário. Para ter mais informações, consulte Transações mínimas por segundo provisionadas e ajuste de escala automático.

Para ver uma lista com todos os parâmetros, consulte CreateCampaign.

aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"

A campanha estará pronta quando seu status for ATIVO. Para obter o status atual, chame DescribeCampaign e verifique se o campo status está definido como ACTIVE.

Se você retreinar sua versão da solução e sua campanha não for atualizada automaticamente para usar a versão mais recente da solução, ou se você quiser alterar as configurações da campanha, atualize sua campanha. Para ter mais informações, consulte Atualizando a configuração de uma campanha do Amazon Personalize.

O Amazon Personalize fornece operações para gerenciar campanhas, como ListCampaigns listar as campanhas que você criou. Você pode excluir uma campanha chamando DeleteCampaign. Se você excluir uma campanha, as versões da solução que fazem parte da campanha não serão excluídas.

Depois de criar sua campanha, você pode usá-la para fazer recomendações. Para ter mais informações, consulte Etapa 4: obter recomendações.

Criação de uma campanha (AWS SDKs)

Importante

Você incorre nos custos da campanha enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter informações sobre os custos da campanha, consulte os preços do Amazon Personalize.

Depois que a versão da solução estiver ativa, você estará pronto para implantá-la com uma campanha Amazon Personalize. Para criar uma campanha com AWS SDKs, você usa a operação de CreateCampaign API.

O exemplo de código a seguir mostra como criar uma campanha. O código implanta a versão mais recente de uma solução que usa a receita de personalização do usuário. A campanha que ele cria é atualizada automaticamente para usar versões futuras da solução. O código usa a seguinte configuração:

• Ele configura a campanha para ser atualizada automaticamente para usar a versão mais recente da solução: solutionVersionArn Está no solution ARN/$LATEST formato e syncWithLatestSolutionVersion estáTrue. Para usar o código, solution ARN substitua pelo Amazon Resource Name (ARN) da versão da sua solução.

  Para desativar o automáticosyncWithLatestSolutionVersion, especifique somente o ARN da versão da solução (sem/$LATEST) e syncWithLatestSolutionVersion defina como. False

• Ele define a enableMetadataWithRecommendations opção comoTrue. Isso permite que uma opção de solicitação de recomendação inclua metadados de itens de um conjunto de dados de itens com resultados de recomendação. Para desativar essa opção, defina-a comoFalse. Para ter mais informações, consulte Metadados do item nas recomendações.

• Ele é definido minProvisionedTPS como 1 (o padrão). Recomendamos que você comece com 1 para minProvisionedTPS (o padrão). Monitore seu uso usando CloudWatch as métricas da Amazon e aumente as minProvisionedTPS conforme necessário. Para ter mais informações, consulte Transações mínimas por segundo provisionadas e ajuste de escala automático.

Para ver uma lista com todos os parâmetros, consulte CreateCampaign.

SDK for Python (Boto3)

import boto3

personalize = boto3.client('personalize')

response = personalize.create_campaign(
    name = 'campaign name',
    solutionVersionArn = 'solution ARN/$LATEST',
    minProvisionedTPS = 1,
    campaignConfig = {"syncWithLatestSolutionVersion": True, "enableMetadataWithRecommendations": True}
)

arn = response['campaignArn']

description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])

SDK for JavaScript v3

// Get service clients module and commands using ES6 syntax.
import { CreateCampaignCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";

// create personalizeClient
const personalizeClient = new PersonalizeClient({ region: "REGION" });

// set the campaign parameters
export const createCampaignParam = {
  solutionVersionArn: "SOLUTION_ARN/$LATEST" /* required */,
  name: "NAME" /* required */,
  minProvisionedTPS: 1 /* optional */,
  campaignConfig: {   /* optional */
    syncWithLatestSolutionVersion: true,
    enableMetadataWithRecommendations: true,
  },
};

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

A campanha estará pronta quando seu status for ATIVO. Para obter o status atualDescribeCampaign, ligue e verifique se o status campo estáACTIVE.

Se você retreinar manualmente a versão da solução ou se quiser alterar as configurações da campanha, deverá atualizá-la. Para ter mais informações, consulte Atualizando a configuração de uma campanha do Amazon Personalize.

O Amazon Personalize fornece operações para gerenciar campanhas, como ListCampaigns listar as campanhas que você criou. Você pode excluir uma campanha chamando DeleteCampaign. Se você excluir uma campanha, as versões da solução que fazem parte da campanha não serão excluídas.

Depois de criar sua campanha, use-a para fazer recomendações. Para ter mais informações, consulte Etapa 4: obter recomendações.