Implementación de una versión de la solución Amazon Personalize con una campaña - Amazon Personalize
Habilitar las actualizaciones automáticas de las campañasAprovisionamiento mínimo TPSMetadatos de los artículos en las recomendacionesCrear una campaña (consola)Crear una campaña (AWS CLI)Crear una campaña (AWS SDKs)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Implementación de una versión de la solución 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 la 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, se utilizan las GetPersonalizedRanking API operaciones GetRecommendations o para obtener recomendaciones. Si recibes recomendaciones de artículos por lotes o segmentos de usuarios, no necesitas crear una campaña. Para obtener más información, consulte Obtener recomendaciones de artículos por lotes o Obtener 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 quieres cambiar la configuración de una campaña existente, por ejemplo, habilitar los metadatos en las recomendaciones, debes actualizar tu campaña. Para obtener más información, consulte Actualización de la configuración de una campaña de Amazon Personalize.

Mientras la campaña esté activa, incurrirás en gastos de campaña. Para evitar costes innecesarios, asegúrate de eliminar la campaña cuando hayas terminado. Para obtener información sobre los costes de la campaña, consulta los precios de Amazon Personalize.

Habilitar las actualizaciones automáticas de las campañas

Al crear una campaña, puede activar las actualizaciones automáticas de la campaña. Con las actualizaciones automáticas, la campaña se actualiza automáticamente para implementar la última versión de la solución configurada de forma automática o manual. De este modo, le resultará más fácil mantener su campaña actualizada.

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

  • Para activar las actualizaciones automáticas de las campañas al crear una campaña con la consola Amazon Personalize, selecciona Actualizar automáticamente para usar la última versión de la solución de tu solución en los detalles de la campaña. Puedes encontrar la fecha y hora de la última actualización en la página de detalles de la campaña.

    Para obtener más información, consulte Crear una campaña (consola).

  • Para habilitar las actualizaciones automáticas de la campaña cuando utilice la CreateCampaign API operación, especifique el nombre del recurso de Amazon (ARN) de la solución en el SolutionArn/$LATEST formato correspondiente al SolutionVersionArn parámetro. En elcampaignConfig, enableMetadataInInferenceResponse establézcalo entrue.

    Para obtener la fecha y hora de la última actualización de la campaña, puedes utilizar la DescribeCampaign API operación y comprobar los latestCampaignUpdate detalles de la respuesta.

    Para ver ejemplos de código que muestran cómo activar las actualizaciones automáticas, consulta Crear una campaña (AWS CLI) o. Crear una campaña (AWS SDKs)

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

importante

Un valor elevado de minProvisionedTPS aumentará los costos. Le recomendamos empezar con 1 para minProvisionedTPS (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y minProvisionedTPS auméntalas 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 TPS aumenta más allá de esa ciframinProvisionedTPS, Amazon Personalize escala automáticamente la capacidad aprovisionada hacia arriba y hacia abajo, pero nunca por debajo. 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 aprovisionamiento mínimo TPS o, si sus solicitudes lo superanminProvisionedTPS, por el importe real. TPS El número real TPS es el número total de solicitudes de recomendación que realizas. 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 los artículos en las recomendaciones

importante

Si utilizas la receta user-Personalization-v2 o Personalized-Ranking-v2, no incurrirás en costes adicionales por los metadatos. Para todas las demás recetas y todos los casos de uso de dominios, incurrirás en costes adicionales. Para obtener más información, consulte Precios de Amazon Personalize.

Cuando recibas recomendaciones, puedes hacer que Amazon Personalize incluya los metadatos de los artículos en los resultados de las recomendaciones. En tu solicitud, puedes elegir las columnas del conjunto de datos de artículos que deseas incluir. 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 Crear un esquema y un conjunto de datos. Para obtener información sobre la actualización de los datos, consulteActualización de datos en conjuntos de datos después del entrenamiento.

Si utilizas la fórmula user-Personalization-v2 o Personalized-Ranking-v2, las campañas tienen automáticamente la opción de incluir los metadatos de los artículos en los resultados de las recomendaciones. No tienes que activar manualmente los metadatos de tu campaña. Para el resto de recetas y casos de uso de dominios, debes habilitar la opción de metadatos:

  • 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 AWS SDKso AWS CLI, utilice la CreateCampaign API operación y en el campaignConfig conjunto enableMetadataInInferenceResponse paratrue. Para obtener más información, consulte Crear una campaña (AWS CLI) o Crear una campaña (AWS SDKs).

Crear una campaña (consola)

importante

Mientras la campaña esté activa, incurrirás en gastos de campaña. Para evitar costes innecesarios, asegúrate de eliminar la campaña cuando hayas terminado. Para obtener información sobre los costes de la campaña, consulta los precios de Amazon Personalize.

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)

  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 versión de la solución que desee implementar.

  3. En el panel de navegación, en Recursos personalizados, elija Campañas.

  4. En la pestaña Campañas, elija Crear campaña.

  5. 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.

    • Actualice automáticamente para usar la última versión de la solución: elija esta opción para que la campaña use automáticamente la última versión de la solución activa. Si no elige esta opción, debe actualizar manualmente la campaña cada vez que desee implementar una nueva versión de la solución. Para obtener más información, consulte Habilitar las actualizaciones automáticas de las campañas.

    • ID de versión de la solución: si no utilizas las actualizaciones automáticas de la campaña para usar la versión más reciente de la solución, elige el ID de la versión de la solución que deseas implementar.

    • Transacciones aprovisionadas mínimas por segundo (llamadas minProvisioned TPSAPIs): establece las transacciones aprovisionadas mínimas por segundo que admite Amazon Personalize. Un valor alto aumentará sus cargos. Te recomendamos que empieces con 1 (el valor predeterminado). Realiza un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y minProvisionedTPS auméntalas según sea necesario. Para obtener más información, consulte Transacciones mínimas aprovisionadas por segundo y escalado automático.

    • Devolver los metadatos de los artículos en los resultados de las recomendaciones: elige esta opción si quieres incluir los metadatos en los resultados de las recomendaciones. Si está habilitada, puedes especificar las columnas de tu conjunto de datos de artículos cuando recibas recomendaciones. Para obtener más información, consulte Metadatos de los artículos en las recomendaciones.

  6. Si has utilizado la fórmula de personalización del usuario, en la configuración de la campaña, puedes introducir de forma opcional valores para el peso de exploración y el límite de edad de los objetos de exploración. Para obtener más información, consulte User-Personalization.

  7. 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.

  8. Elija Crear una campaña.

  9. 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 Obtener recomendaciones de Amazon Personalize.

    La campaña estará lista cuando su estado seaACTIVE. Si renueva la versión de la solución o si quiere 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.

Crear una campaña (AWS CLI)

importante

Incurrirás en gastos de campaña mientras la campaña esté activa. Para evitar costes innecesarios, asegúrate de eliminar la campaña cuando hayas terminado. Para obtener información sobre los costes de la campaña, consulta los precios de Amazon Personalize.

Una vez que la versión de la solución esté activa, estará listo para implementarla con una campaña de Amazon Personalize. Para crear una campaña con AWS CLI, se utiliza el create-campaign comando.

En el siguiente ejemplo de código se muestra cómo crear una campaña. Implementa la última versión de una solución que utiliza la receta de personalización del usuario. La campaña que crea se actualiza automáticamente para usar futuras versiones de la solución. El código usa la siguiente configuración:

  • Configura la campaña para que se actualice automáticamente y utilice la versión más reciente de la solución: solution-version-arn está en solution ARN/$LATEST formato y syncWithLatestSolutionVersion esTrue. Para usar el código, solution ARN sustitúyalo por el nombre de recurso de Amazon (ARN) de tu solución.

    Para deshabilitar la opción automáticasyncWithLatestSolutionVersion, especifique únicamente la versión de la solución ARN (sin ella/$LATEST) y syncWithLatestSolutionVersion configúrela enFalse.

  • Establece la enableMetadataWithRecommendations opción enTrue. Esto habilita una opción de solicitud de recomendación para incluir metadatos de elementos de un conjunto de datos de artículos con los resultados de las recomendaciones. Para deshabilitar esta opción, configúrela enFalse. Para obtener más información, consulte Metadatos de los artículos en las recomendaciones.

  • Se establece min-provisioned-tps en 1 (el valor predeterminado). Le recomendamos empezar con 1 para minProvisionedTPS (el valor predeterminado). Realiza un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y minProvisionedTPS auméntalas según sea necesario. Para obtener más información, consulte Transacciones mínimas aprovisionadas por segundo y escalado automático.

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 esté en estadoACTIVE. Para obtener el estado actual de la campaña, llame a DescribeCampaign y compruebe que el valor de la propiedad status es ACTIVE.

Si renuevas la versión de tu solución y tu campaña no se actualiza automáticamente para usar la versión más reciente de la solución, o si deseas cambiar la configuración de la campaña, debes 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 campañas, por ejemplo, ListCampaigns para enumerar 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 creada la campaña, puede utilizarla para hacer recomendaciones. Para obtener más información, consulte Obtener recomendaciones de Amazon Personalize.

Crear una campaña (AWS SDKs)

importante

Incurrirás en gastos de campaña mientras la campaña esté activa. Para evitar costes innecesarios, asegúrate de eliminar la campaña cuando hayas terminado. Para obtener información sobre los costes de la campaña, consulta los precios de Amazon Personalize.

Una vez que la versión de la solución esté activa, estará listo para implementarla con una campaña de Amazon Personalize. Para crear una campaña con AWS SDKs, se utiliza la CreateCampaign API operación.

En el siguiente ejemplo de código se muestra cómo crear una campaña. El código implementa la última versión de una solución que utiliza la receta de personalización del usuario. La campaña que crea se actualiza automáticamente para usar futuras versiones de la solución. El código usa la siguiente configuración:

  • Configura la campaña para que se actualice automáticamente y utilice la versión más reciente de la solución: solutionVersionArn está en solution ARN/$LATEST formato y syncWithLatestSolutionVersion esTrue. Para usar el código, solution ARN sustitúyalo por el nombre del recurso de Amazon (ARN) de la versión de tu solución.

    Para deshabilitar la opción automáticasyncWithLatestSolutionVersion, especifique solo la versión de la solución ARN (sin ella/$LATEST) y syncWithLatestSolutionVersion configúrela enFalse.

  • Establece la enableMetadataWithRecommendations opción enTrue. Esto habilita una opción de solicitud de recomendación para incluir metadatos de elementos de un conjunto de datos de artículos con los resultados de las recomendaciones. Para deshabilitar esta opción, configúrela enFalse. Para obtener más información, consulte Metadatos de los artículos en las recomendaciones.

  • Se establece minProvisionedTPS en 1 (el valor predeterminado). Se recomienda empezar por 1 para minProvisionedTPS (el valor predeterminado). Realiza un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y minProvisionedTPS auméntalas según sea necesario. Para obtener más información, consulte Transacciones mínimas aprovisionadas por segundo y escalado automático.

Para obtener una lista completa de todos los 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();

La campaña estará lista cuando esté en estadoACTIVE. Para ver el estado actualDescribeCampaign, llama y comprueba que el status campo estéACTIVE.

Si modificas manualmente la versión de tu solución o si quieres cambiar la configuración de la campaña, debes 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 campañas, por ejemplo, ListCampaigns para enumerar 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 Obtener recomendaciones de Amazon Personalize.