TPS mínimo aprovisionado Habilitación de los metadatos en las recomendaciones Crear una campaña (consola)Creación de una campaña (AWS CLI)Creación de una campaña (SDK de AWS)

Creación de una campaña

Para obtener recomendaciones en tiempo real con recursos personalizados, una vez finalizada Creación de una versión de solución., estará listo para implementar la versión de la solución con una campaña.

Una campaña implementa una versión de la solución (modelo entrenado) con una capacidad de transacción aprovisionada para generar recomendaciones en tiempo real. Después de crear una campaña, puede utilizar las operaciones de la API de GetRecommendations o GetPersonalizedRanking para obtener recomendaciones. Si recibe recomendaciones por lotes, no es necesario crear una campaña. Para obtener más información, consulte Recomendaciones por lotes y segmentos de usuarios (recursos personalizados).

Al crear una campaña, puede habilitar los metadatos de los elementos en las recomendaciones. Para obtener más información, consulte Habilitación de los metadatos en las recomendaciones.

Puede crear una campaña con la consola de Amazon Personalize, la AWS Command Line Interface (AWS CLI) o los SDK de AWS.

importante

Si vuelve a entrenar manualmente su versión de la solución o quiere cambiar la configuración de una campaña existente, por ejemplo, habilitar los metadatos en las recomendaciones, debe actualizar la campaña. Para obtener más información, consulte Actualización de una campaña.

Temas

Transacciones mínimas aprovisionadas por segundo y escalado automático
Habilitación de los metadatos en las recomendaciones
Crear una campaña (consola)
Creación de una campaña (AWS CLI)
Creación de una campaña (SDK de AWS)
Actualización de una campaña

Transacciones mínimas aprovisionadas por segundo y escalado automático

importante

Un valor elevado de minProvisionedTPS aumentará los costes. Le recomendamos empezar con 1 para minProvisionedTPS (el valor predeterminado). Realice un seguimiento de su uso mediante las métricas de Amazon CloudWatch y aumente el valor de minProvisionedTPS según sea necesario.

Al crear una campaña de Amazon Personalize, puede especificar el número mínimo de transacciones aprovisionadas por segundo (minProvisionedTPS) para la campaña. Este es el rendimiento de transacciones de línea base para la campaña aprovisionada por Amazon Personalize. Establece el cargo de facturación mínimo de la campaña mientras esté activa. Una transacción es una solicitud GetRecommendations o GetPersonalizedRanking simple. El valor predeterminado de minProvisionedTPS es 1.

Si su TPS aumenta más de minProvisionedTPS, Amazon Personalize escala automáticamente la capacidad aprovisionada hacia arriba y hacia abajo, pero nunca por debajo de minProvisionedTPS. Se produce un breve retraso durante el aumento de la capacidad que podría provocar la pérdida de transacciones. Cuando se reduce el tráfico, la capacidad vuelve al valor de minProvisionedTPS.

Se le cobrará por el valor de TPS mínimo aprovisionado o, si sus solicitudes superan el valor de minProvisionedTPS, el TPS real. El TPS real es el número total de solicitudes de recomendación que realiza. Recomendamos empezar con un nivel bajo de minProvisionedTPS, realizar un seguimiento del uso mediante las métricas de Amazon CloudWatch y, a continuación, aumentar el minProvisionedTPS según sea necesario.

Para obtener más información sobre los costes de las campañas, consulte Precios de Amazon Personalize.

Habilitación de los metadatos en las recomendaciones

importante

Al habilitar los metadatos en las recomendaciones, se incurre en costes adicionales. Para obtener más información, consulte Precios de Amazon Personalize.

Al crear una campaña, puede habilitar la opción para incluir los metadatos de los elementos de su conjunto de datos de elementos en los resultados de las recomendaciones. Después, puede elegir las columnas del conjunto de datos de elementos que quiere incluir en su solicitud de recomendaciones o clasificación personalizada. Amazon Personalize devuelve estos datos para cada elemento en la respuesta a la recomendación.

Puede usar metadatos para enriquecer las recomendaciones de la interfaz de usuario, por ejemplo, agregar los géneros de las películas a los carruseles. También puede usarlos para evaluar la calidad de las recomendaciones de manera visual. Si usa IA generativa en la aplicación, puede conectar los metadatos a las indicaciones de la IA a fin de generar contenido más relevante. Para obtener más información sobre el uso de Amazon Personalize con la IA generativa, consulte Amazon Personalize y la IA generativa.

Para habilitar los metadatos con la consola de Amazon Personalize, al crear la campaña, seleccione Devolver metadatos de los elementos en los resultados de las recomendaciones en Detalles de la campaña. Para obtener más información, consulte Crear una campaña (consola).
Para habilitar los metadatos con los SDK de AWS o la AWS CLI, use la operación de API CreateCampaign y en campaignConfig establezca enableMetadataInInferenceResponse en true. Para obtener más información, consulte Creación de una campaña (AWS CLI) o Creación de una campaña (SDK de AWS).

Para agregar metadatos a las recomendaciones, debe tener un conjunto de datos de elementos con una columna de metadatos. No es necesario usar los metadatos en el entrenamiento. Para obtener información sobre cómo crear un conjunto de datos, consulte Creación de un conjunto de datos y un esquema. Para obtener información sobre cómo administrar y actualizar datos, consulte Administrar datos.

Crear una campaña (consola)

Cuando el estado de la versión de la solución sea Activo, ya puede implementarla con una campaña de Amazon Personalize.

Para crear una campaña (consola)

Abra la consola de Amazon Personalize en https://console.aws.amazon.com/personalize/home e inicie sesión en su cuenta.
Elija el grupo de conjuntos de datos con la versión de la solución que desea implementar.
En el panel de navegación, en Recursos personalizados, elija Campañas.
En la pestaña Campañas, elija Crear campaña.
En la página Crear nueva campaña, en los Detalles de la campaña, proporcione la siguiente información:
- Nombre de la campaña: escriba el nombre de la campaña. El texto que escriba aquí aparecerá en el panel Campaña y en la página de detalles.
- Solución: elija la solución que acaba de crear.
- ID de versión de la solución: elija el ID de la versión de la solución que acaba de crear.
- Mínimo de transacciones aprovisionadas por segundo (denominadas minProvisionedTPS en las API): defina el mínimo de transacciones aprovisionadas por segundo que admite Amazon Personalize. Un valor elevado aumentará su factura. Le recomendamos empezar con 1 (el valor predeterminado). Realice un seguimiento de su uso mediante las métricas de Amazon CloudWatch y aumente las minProvisionedTPS según sea necesario. Para obtener más información, consulte Transacciones mínimas aprovisionadas por segundo y escalado automático.
- Devolver metadatos de los elementos en los resultados de las recomendaciones: elija esta opción si desea poder incluir los metadatos en los resultados de las recomendaciones. Si está habilitada, puede especificar las columnas del conjunto de datos de elementos en su solicitud de recomendaciones o clasificación personalizada. Amazon Personalize devuelve estos datos para cada elemento en la respuesta a la recomendación.
  
  Para habilitar los metadatos, debe tener un conjunto de datos de elementos con una columna de metadatos.
Si ha utilizado la receta User-Personalization, en Configuración de la campaña, si lo desea, especifique valores para Peso de exploración y Límite de antigüedad de los elementos de exploración. Para obtener más información, consulte User-Personalization.
Para Etiquetas, si lo desea, añada cualquier etiqueta. Para obtener más información acerca del etiquetado de recursos de Amazon Personalize, consulte Etiquetado de recursos de Amazon Personalize.
Elija Crear una campaña.
En la página de detalles de la campaña, cuando el estado de la campaña es Activo, puede utilizarla para obtener recomendaciones y registrar las impresiones. Para obtener más información, consulte Paso 4: Obtener recomendaciones.

La campaña estará lista cuando su estado sea ACTIVO. Si vuelve a entrenar la versión de su solución o desea cambiar la configuración de la campaña, debe actualizarla. Para obtener más información, consulte Actualización de una campaña.

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

Cuando el estado de la versión de la solución sea Activo, ya puede implementarla con una campaña de Amazon Personalize. Utilice el siguiente comando create-campaign de AWS CLI para crear una campaña que implemente una versión de la solución entrenada con la receta User-Personalization. Asigne un nombre a la campaña y especifique el nombre de recurso de Amazon (ARN). Si lo desea, cambie el minProvisionedTPS si su caso de uso requiere una capacidad aprovisionada superior. El valor mínimo es 1.

Los parámetros campaign-config son específicos de la receta que utilizó para entrenar la versión de la solución (para obtener más información sobre las recetas, consulte Elección de una receta).

En el ejemplo se utilizan los siguientes campos de itemExplorationConfig específicos de la receta User-Personalization con sus valores predeterminados: explorationWeight y explorationItemAgeCutOff. Si omite el parámetro campaign-config, se aplicarán los valores predeterminados. Para obtener más información acerca de los campos de itemExplorationConfig, consulte el Propiedades e hiperparámetros para la receta User-Personalization.

Si tiene un conjunto de datos de elementos y quiere tener la opción de incluir metadatos al recibir recomendaciones, actualice campaign-config para agregar un campo enableMetadataWithRecommendations y establézcalo en true.

Para obtener una lista completa de todos los parámetros, consulte CreateCampaign.


aws personalize create-campaign \
--name campaign name \
--solution-version-arn solution version arn \
--min-provisioned-tps 1 \
--campaign-config "{\"itemExplorationConfig\":{\"explorationWeight\":\"0.3\",\"explorationItemAgeCutOff\":\"30\"}}"

La campaña estará lista cuando su estado sea ACTIVO. Para obtener el estado actual de la campaña, llame a DescribeCampaign y compruebe que el valor de la propiedad status es ACTIVE.

Si vuelve a entrenar la versión de su solución o desea cambiar la configuración de la campaña, debe actualizarla. Para obtener más información, consulte Actualización de una campaña.

Amazon Personalize dispone de operaciones para administrar campañas como, por ejemplo, ListCampaigns para obtener una lista de las campañas que se han creado. Puede eliminar una campaña llamando a DeleteCampaign. Si elimina una campaña, las versiones de solución que forman parte de la campaña no se eliminan.

Una vez que haya creado su campaña, utilícela para realizar recomendaciones. Para obtener más información, consulte Paso 4: Obtener recomendaciones.

Creación de una campaña (SDK de AWS)

Cuando el estado de la versión de la solución sea Activo, ya puede implementarla con una campaña de Amazon Personalize. Utilice el siguiente código para crear una campaña. Asigne un nombre a la campaña, especifique el nombre de recurso de Amazon (ARN) de la versión de la solución que se implementará y, si lo desea, especifique la TPS mínimo aprovisionado que admitirá la campaña (el valor predeterminado de este parámetro es 1). Si usa la receta User-Personalization, puede configurar la exploración de elementos con los parámetros itemExplorationWeight y explorationItemAgeCutOff.

Si tiene un conjunto de datos de elementos y quiere tener la opción de incluir metadatos al recibir recomendaciones, actualice el código campaignConfig para incluir un atributo enableMetadataWithRecommendations y establézcalo en true.

Para obtener una lista completa de todos los parámetros, consulte CreateCampaign.

SDK for Python (Boto3)

En este ejemplo, los parámetros itemExplorationWeight y explorationItemAgeCutOff son específicos de la receta User-Personalization. El valor predeterminado de itemExplorationWeight es 0,3 y el valor predeterminado de explorationItemAgeCutOff es 30. Si omite los parámetros de configuración de la campaña, se aplicarán los valores predeterminados.


import boto3

personalize = boto3.client('personalize')

response = personalize.create_campaign(
    name = 'campaign name',
    solutionVersionArn = 'solution version arn',
    minProvisionedTPS = 1,
    campaignConfig = {"itemExplorationConfig": {"explorationWeight": "0.3", "explorationItemAgeCutOff": "30"}}
)

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


public static void createCampaign(PersonalizeClient personalizeClient, 
                                String campaignName, 
                                String solutionVersionArn, 
                                Integer minProvisionedTPS, 
                                String itemExplorationWeight, 
                                String explorationItemAgeCutOff) {
                                
    //Optional code to instantiate a HashMap and add the explorationWeight and explorationItemAgeCutOff values.
    //Remove if you aren't using User-Personaliztion.
    Map<String,String> itemExploration = new HashMap<String,String>();
    itemExploration.put("explorationWeight", itemExplorationWeight);
    itemExploration.put("explorationItemAgeCutOff", explorationItemAgeCutOff);

    try {
        // Build a User-Personalization recipe specific campaignConfig object with the itemExploration map.
        // CampaignConfig construction will vary by recipe.
        CampaignConfig campaignConfig = CampaignConfig.builder()
            .itemExplorationConfig(itemExploration)
            .build();
    
        // build the createCampaignRequest
        CreateCampaignRequest createCampaignRequest = CreateCampaignRequest.builder()
            .name(campaignName)
            .solutionVersionArn(solutionVersionArn)
            .minProvisionedTPS(minProvisionedTPS)
            .campaignConfig(campaignConfig) //
            .build();

        // create the campaign
        CreateCampaignResponse campaignResponse = personalizeClient.createCampaign(createCampaignRequest);
        String campaignArn = campaignResponse.campaignArn();
        
        DescribeCampaignRequest campaignRequest = DescribeCampaignRequest.builder()
            .campaignArn(campaignArn)
            .build();
    
        DescribeCampaignResponse campaignResponse = personalizeClient.describeCampaign(campaignRequest);
        Campaign newCampaign = campaignResponse.campaign();
        
        System.out.println("The Campaign status is " + newCampaign.status());
    
    } catch (PersonalizeException e) {
        System.err.println(e.awsErrorDetails().errorMessage());
        System.exit(1);
    }
}

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_VERSION_ARN",    /* required */
  name: "CAMPAIGN_NAME",                         /* required */
  minProvisionedTPS: 1,                          /* optional */
  campaignConfig: {
    itemExplorationConfig: {
      explorationWeight: "0.3",                  /* optional */
      explorationItemAgeCutOff: "30",            /* optional */
    },
  },
};

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

La campaña estará lista cuando su estado sea ACTIVO. Para obtener el estado actual de la campaña, llame a DescribeCampaign y compruebe que el valor de la propiedad status es ACTIVE.

Si vuelve a entrenar manualmente la versión de su solución o desea cambiar la configuración de la campaña, debe actualizarla. Para obtener más información, consulte Actualización de una campaña.

Una vez que haya creado su campaña, utilícela para realizar recomendaciones. Para obtener más información, consulte Paso 4: Obtener recomendaciones.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Evaluación de una versión de solución con métricas

Actualización de una campaña