Actualización de la configuración de una campaña de Amazon Personalize

Para cambiar el TPS mínimo aprovisionado de la campaña, implementar de forma manual una nueva versión de solución o modificar la configuración de una campaña (por ejemplo, activar la opción de incluir metadatos en las recomendaciones), debe actualizar la campaña de modo manual.

Lo que se indica a continuación no requiere una actualización manual de la campaña:

• Si la campaña usa actualizaciones de campaña automáticas, no tiene que actualizarla para implementar la última versión de solución configurada entrenada de forma automática o manual. Para obtener más información, consulte Actualizaciones de campaña automáticas.

• Con User-Personalization-v 2, la personalización del usuario o Next-Best-Action Amazon Personalize actualiza automáticamente la última versión de la solución cada dos horas para incluir nuevos elementos o acciones en las recomendaciones. La campaña utiliza automáticamente la versión actualizada de la solución.

Actualizas manualmente una campaña con la consola Amazon Personalize, AWS Command Line Interface (AWS CLI) o AWS SDKs.

nota

Para actualizar una campaña con el fin de incluir metadatos en las recomendaciones, debe tener un conjunto de datos de elementos con una columna de metadatos. No es necesario usar los metadatos en el entrenamiento.

Si tu campaña implementó anteriormente una versión de la solución que utilizaba User-Personalization-v Personalized-Ranking-v 2 o 2, y vas a cambiar a una versión anterior de las recetas, la opción de incluir metadatos está desactivada de forma predeterminada. Puede activarla al actualizar la campaña. Para obtener más información, consulte Metadatos de elemento en las recomendaciones.

Actualización de una campaña (consola)

Para implementar una versión de la solución reentrenada manualmente o realizar cambios en la configuración de su campaña, debe actualizar su campaña.

Para actualizar una campaña (consola)

1. Abre la consola Amazon Personalize en https://console.aws.amazon.com/personalize/casa e inicia sesión en tu cuenta.

2. Elija el grupo de conjuntos de datos con la campaña que desea actualizar.

3. En el panel de navegación, seleccione Campañas.

4. En la página Campañas, elija la campaña que desea actualizar.

5. En la página de detalles de la campaña, seleccione Actualizar.

6. En la página Actualizar campaña, realice los cambios. Por ejemplo, si va a implementar una versión reentrada de la solución, en el campo ID de la versión de la solución, elija el número de identificación de la nueva versión de la solución.

7. Elija Actualizar. Amazon Personalize actualiza la campaña para usar la nueva versión de la solución y cualquier configuración modificada.

Actualización de una campaña (AWS CLI)

Para implementar una nueva versión de la solución, cambiar el TPS mínimo aprovisionado de la campaña o cambiar la configuración de la campaña, debe actualizarla. Use el siguiente comando update-campaign para actualizar una campaña y usar una nueva versión de la solución con AWS CLI.

Reemplace campaign arn por el nombre de recurso de Amazon (ARN) de la campaña que desea actualizar. Reemplace new solution version arn por la versión de la solución que desea implementar.

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

Actualización de una campaña (AWS SDKs)

Para implementar una nueva versión de la solución, cambiar el TPS mínimo aprovisionado de la campaña o cambiar la configuración de la campaña, debe actualizarla. Utilice el siguiente código para actualizar una campaña con el SDK para Python (Boto3) o el SDK para Java 2.x. Para obtener una lista completa de parámetros, consulte UpdateCampaign.

SDK for Python (Boto3)

Use el siguiente método update_campaign para implementar una nueva versión de la solución. Reemplace campaign arn por el nombre de recurso de Amazon (ARN) de la campaña que desea actualizar, reemplace new solution version arn por el ARN de la nueva versión de solución y, si lo desea, cambie 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 el siguiente método updateCampaign para actualizar una campaña y usar una nueva versión de la solución. Pase como parámetros un cliente de servicio Amazon Personalize, el nombre de recurso de Amazon (ARN) de la nueva versión de la solución y TPS mínimo aprovisionado.

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