As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Você pode implantar uma versão da solução do Amazon Personalize com uma campanha.

Para recomendações em tempo real com recursos personalizados, depois de concluir Criar uma versão da solução manualmente, 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ê estiver recebendo recomendações de itens em lote, não precisará criar uma campanha. Para ter mais informações, consulte Obter recomendações de itens em lote ou Obter segmentos em lote de usuários.

Ao criar uma campanha, é possível configurar o seguinte:

Você pode criar uma campanha com o console Amazon Personalize, AWS Command Line Interface (AWS CLI) ou. AWS SDKs Se quiser modificar as configurações atuais de uma campanha, como habilitar os metadados nas recomendações, atualize a campanha. Para obter mais informações, consulte Atualizar a configuração de uma campanha do Amazon Personalize.

Os custos da campanha são acumulados enquanto a campanha está ativa. Para evitar custos desnecessários, certifique-se de excluir a campanha quando terminar. Para obter mais informações sobre os custos das campanhas, consulte Preços do Amazon Personalize.

Atualizações automáticas da campanha

Ao criar uma campanha, é possível habilitar as atualizações automáticas dela. Com esse recurso, a campanha é atualizada para implantar a versão mais recente de forma automática ou a versão da sua solução treinada manualmente. Isso facilita a atualização da campanha.

Por exemplo, se sua solução usa o 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 dos treinos semanais. Se você não usa atualizações automáticas da campanha, deve atualizar manualmente a campanha para implantar o modelo treinado mais recente.

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

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ê recebe as cobranças pelo TPS mínimo provisionado ou, se as solicitações excederem o minProvisionedTPS, o TPS 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.

Habilitar metadados nas recomendações

Ao receber recomendações, é possível fazer com que o Amazon Personalize inclua metadados do item nos resultados da recomendação. Na solicitação, é possível escolher as colunas do conjunto de dados de 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 atualizar os dados, consulte Atualizar os dados em conjuntos de dados após o treinamento.

Se você usar a receita User-Personalization-v 2 ou Personalized-Ranking-v 2, as novas 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 da sua campanha. Para todas as outras fórmulas e casos de uso de domínio, você deve habilitar os metadados:

Criar uma campanha (console)

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

Criar uma campanha (AWS CLI)

Quando o status da versão da solução for ativo, você poderá para implantá-la com uma campanha do 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 fórmula 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:

Para conferir 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 a versão da solução e a campanha não for atualizada automaticamente para usar a versão mais recente, ou se quiser alterar as configurações da campanha, será necessário atualizar a campanha. Para obter mais informações, consulte Atualizar a configuração de uma campanha do Amazon Personalize.

O Amazon Personalize oferece operações para gerenciar campanhas, como a ListCampaigns, e listar aquelas 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 que você criar sua campanha, use-a para fazer recomendações. Para obter mais informações, consulte Obter recomendações do Amazon Personalize.

Criar uma campanha (AWS SDKs)

Quando o status da versão da solução for ativo, você poderá para implantá-la com uma campanha do 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 fórmula User-Personalization. A campanha que ele cria é atualizada automaticamente para usar versões futuras da solução. O código usa a seguinte configuração:

Para conferir 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 atual, chame DescribeCampaign e verifique se o campo status está definido como ACTIVE.

Se você retreinar manualmente a versão da solução ou quiser alterar as configurações da sua campanha, deverá atualizar a campanha. Para obter mais informações, consulte Atualizar a configuração de uma campanha do Amazon Personalize.

O Amazon Personalize oferece operações para gerenciar campanhas, como a ListCampaigns, e listar aquelas 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 obter mais informações, consulte Obter recomendações do Amazon Personalize.