Atualizar a configuração de uma campanha do Amazon Personalize

PDFRSS

Para alterar o TPS mínimo provisionado da campanha, implantar manualmente uma nova versão da solução ou modificar a configuração de uma campanha, por exemplo, ativando a inclusão dos metadados nas recomendações, é necessário atualizar a campanha de forma manual.

As situações a seguir não exigem uma atualização manual da campanha:

• Caso sua campanha use atualizações automáticas, não será necessário fazer isso manualmente para implantar a versão mais recente da solução treinada de forma automática ou manual. Para obter mais informações, consulte Atualizações automáticas da campanha.

• Com User-Personalization-v 2, User-Personalization, ou Next-Best-Action, o Amazon Personalize atualiza automaticamente sua versão mais recente da solução a cada duas horas para incluir novos itens ou ações nas recomendações. Sua campanha usa automaticamente a versão atualizada da solução.

Você atualiza manualmente uma campanha com o console Amazon Personalize, AWS Command Line Interface (AWS CLI) ou. AWS SDKs

nota

Para atualizar uma campanha e ativar a inclusão de metadados nas 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.

Se sua campanha implantou anteriormente uma versão da solução que usava User-Personalization-v 2 ou Personalized-Ranking-v 2 e você está migrando para uma versão mais antiga das receitas, a opção de incluir metadados está desativada por padrão. Você pode ativar essa inclusão ao atualizar a campanha. Para obter mais informações, consulte Habilitar metadados nas recomendações.

Atualização de uma campanha (console)

Para implantar uma versão reciclada manualmente da solução ou para fazer alterações na configuração da campanha, atualize-a.

Para atualizar uma campanha (console)

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

2. Escolha o grupo de conjuntos de dados com a campanha que você deseja atualizar.

3. No painel de navegação, selecione Campaigns (Campanhas).

4. Na página Campanhas, escolha a campanha que você deseja atualizar.

5. Na página de detalhes da campanha, escolha Atualizar.

6. Na página Atualizar campanha, faça suas alterações. Por exemplo, se você estiver implantando uma versão reciclada da solução, para ID da versão da solução, escolha o número de identificação para a nova versão da solução.

7. Selecione Atualizar. O Amazon Personalize atualiza a campanha para usar a nova versão da solução e quaisquer configurações alteradas.

Atualização de uma campanha (AWS CLI)

Para implantar uma nova versão da solução, alterar TPS mínimo provisionado da campanha ou alterar a configuração da sua campanha, você deve atualizá-la. Use o comando update-campaign a seguir para atualizar uma campanha para usar uma nova versão da solução com AWS CLI.

Substitua campaign arn pelo Amazon Resource Name (ARN) da campanha que você deseja atualizar. Substitua new solution version arn pela versão da solução que você deseja implantar.

aws personalize update-campaign \
--campaign-arn campaign arn \
--solution-version-arn new solution version arn \
--min-provisioned-tps 1

Atualização de uma campanha (AWS SDKs)

Para implantar uma nova versão da solução, alterar TPS mínimo provisionado da campanha ou alterar a configuração da sua campanha, você deve atualizá-la. Use o código a seguir para atualizar uma campanha com o SDK for Python (Boto3) ou o SDK para Java 2.x. Para obter uma lista completa de parâmetros, consulte UpdateCampaign.

SDK for Python (Boto3)

Use o método update_campaign a seguir para implantar uma nova versão da solução. Substitua campaign arn pelo Amazon Resource Name (ARN) da campanha que você deseja atualizar, substitua new solution version arn pelo novo ARN da versão da solução e, opcionalmente, altere minProvisionedTPS.

import boto3

personalize = boto3.client('personalize')

response = personalize.update_campaign(
    campaignArn = 'campaign arn',
    solutionVersionArn = 'new solution version arn',
    minProvisionedTPS = 1,
)

arn = response['campaignArn']

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

SDK for Java 2.x

Use o método updateCampaign a seguir para atualizar uma campanha para usar uma nova versão da solução. Passe como parâmetros um cliente do serviço do Amazon Personalize, o Amazon Resource Name (ARN) da nova versão da solução e TPS mínimo provisionado.

public static void updateCampaign(PersonalizeClient personalizeClient, 
                                String campaignArn,
                                String solutionVersionArn, 
                                Integer minProvisionedTPS) {

    try {    
        // build the updateCampaignRequest
        UpdateCampaignRequest updateCampaignRequest = UpdateCampaignRequest.builder()
            .campaignArn(campaignArn)
            .solutionVersionArn(solutionVersionArn)
            .minProvisionedTPS(minProvisionedTPS)
            .build();
        
        // update the campaign
        personalizeClient.updateCampaign(updateCampaignRequest);
        
        DescribeCampaignRequest campaignRequest = DescribeCampaignRequest.builder()
              .campaignArn(campaignArn)
              .build();
    
        DescribeCampaignResponse campaignResponse = personalizeClient.describeCampaign(campaignRequest);
        Campaign updatedCampaign = campaignResponse.campaign();
        
        System.out.println("The Campaign status is " + updatedCampaign.status());
    
    } catch (PersonalizeException e) {
        System.err.println(e.awsErrorDetails().errorMessage());
        System.exit(1);
    }
}