Implementación de una versión de solución de Amazon Personalize con una campaña

Para obtener recomendaciones en tiempo real con recursos personalizados, una vez finalizada Creación manual 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 de elementos o de segmentos de usuarios por lotes, no es necesario que cree una campaña. Para obtener más información, consulte Obtención de recomendaciones de elemento por lotes o Obtención de segmentos de usuarios por lotes.

Al crear una campaña, puede configurar lo siguiente:

Puedes crear una campaña con la consola Amazon Personalize, AWS Command Line Interface (AWS CLI) o AWS SDKs. Si desea 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 la configuración de una campaña de Amazon Personalize.

Generará costos de campaña mientras la campaña esté activa. Para evitar costos innecesarios, asegúrese de eliminar la campaña cuando haya terminado. Para obtener información sobre los costos de campaña, consulte Precios de Amazon Personalize.

Actualizaciones de campaña automáticas

Al crear una campaña, puede habilitar las actualizaciones de campaña automáticas. Con las actualizaciones automáticas, la campaña se actualiza automáticamente para implementar la última versión de solución entrenada de forma automática o manual. Esto le facilita la actualización de la campaña.

Por ejemplo, si la solución usa el entrenamiento automático para crear una nueva versión de solución cada siete días, la campaña se actualizará automáticamente para usar la última versión de solución en cada entrenamiento semanal. Si no utiliza las actualizaciones de campaña automáticas, debe actualizarla manualmente para implementar el modelo entrenado más reciente.

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

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á el valor de TPS aprovisionado mínimo o, si las solicitudes superan el valor de minProvisionedTPS, el TPS real. El TPS real es el número total de solicitudes de recomendación que realiza. Te recomendamos empezar con un nivel bajominProvisionedTPS, realizar un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y, a continuación, aumentarlo minProvisionedTPS según sea necesario.

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

Metadatos de elemento en las recomendaciones

Cuando reciba recomendaciones, puede hacer que Amazon Personalize incluya metadatos de elemento en los resultados de las recomendaciones. En la solicitud, puede elegir las columnas del conjunto de datos de elementos que se incluirán. 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.

Habilitación de metadatos

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 esquema y un conjunto de datos. Para obtener información sobre la actualización de datos, consulte Actualización de datos en conjuntos de datos después del entrenamiento.

Si utilizas la receta de User-Personalization-v 2 o Personalized-Ranking-v 2, las nuevas campañas tienen automáticamente la opción de incluir los metadatos de los artículos en los resultados de las recomendaciones. No tiene que activar manualmente los metadatos de la campaña. Para el resto de las recetas y casos de uso de dominio, debes habilitar la opción de metadatos:

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.

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

Cuando el estado de la versión de solución sea Activo, podrá implementarla con una campaña de Amazon Personalize. Para crear una campaña con el AWS CLI, se utiliza el create-campaign comando.

En la siguiente muestra de código se presenta cómo crear una campaña. Implementa la última versión de solución de una solución que utiliza la receta User-Personalization. La campaña que crea se actualiza automáticamente para usar futuras versiones de solución. El código utiliza la siguiente configuración:

Para obtener una lista completa de todos los 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"}"

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 solución y la campaña no se actualiza automáticamente para usar la última versión de solución, o si desea cambiar la configuración de la campaña, debe actualizarla. Para obtener más información, consulte Actualización de la configuración de una campaña de Amazon Personalize.

Amazon Personalize le proporciona operaciones para administrar las campañas como, por ejemplo, ListCampaigns para obtener una lista de las campañas que ha 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 la campaña, puede utilizarla para realizar recomendaciones. Para obtener más información, consulte Obtención de recomendaciones de Amazon Personalize.

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

Cuando el estado de la versión de solución sea Activo, podrá implementarla con una campaña de Amazon Personalize. Para crear una campaña AWS SDKs, utilizas la operación CreateCampaign API.

En la siguiente muestra de código se presenta cómo crear una campaña. El código implementa la última versión de solución de una solución que utiliza la receta User-Personalization. La campaña que crea se actualiza automáticamente para usar futuras versiones de solución. El código utiliza la siguiente configuración:

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

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'])

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

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

Amazon Personalize le proporciona operaciones para administrar las campañas como, por ejemplo, ListCampaigns para obtener una lista de las campañas que ha 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 Obtención de recomendaciones de Amazon Personalize.