Déploiement d'une version de la solution Amazon Personalize avec une campagne

Pour obtenir des recommandations en temps réel avec des ressources personnalisées, une fois que vous avez terminéCréation manuelle d'une version de solution, vous êtes prêt à déployer la version de votre solution dans le cadre d'une campagne.

Une campagne déploie une version de solution (modèle entraîné) dotée d'une capacité de transaction provisionnée pour générer des recommandations en temps réel. Après avoir créé une campagne, vous utilisez les opérations de l'GetPersonalizedRankingAPI GetRecommendations or pour obtenir des recommandations. Si vous recevez des recommandations d'articles par lots ou des segments d'utilisateurs, vous n'avez pas besoin de créer de campagne. Pour plus d’informations, consultez Obtenir des recommandations d'articles par lots ou Obtenir des segments d'utilisateurs par lots.

Lorsque vous créez une campagne, vous pouvez configurer les éléments suivants :

Vous pouvez créer une campagne avec la console Amazon Personalize, AWS Command Line Interface (AWS CLI) ou AWS SDKs. Si vous souhaitez modifier les paramètres d'une campagne existante, par exemple en activant les métadonnées dans les recommandations, vous devez mettre à jour votre campagne. Pour de plus amples informations, veuillez consulter Mettre à jour la configuration d'une campagne Amazon Personalize.

Vous engagez des frais de campagne lorsque celle-ci est active. Pour éviter des coûts inutiles, veillez à supprimer la campagne lorsque vous aurez terminé. Pour plus d'informations sur les coûts des campagnes, consultez la section Tarification d'Amazon Personalize.

Mises à jour automatiques des campagnes

Lorsque vous créez une campagne, vous pouvez activer les mises à jour automatiques de la campagne. Grâce aux mises à jour automatiques, la campagne est automatiquement mise à jour pour déployer la dernière version de votre solution entraînée automatiquement ou manuellement. Cela vous permet de tenir votre campagne à jour plus facilement.

Par exemple, si votre solution utilise une formation automatique pour créer une nouvelle version de solution tous les sept jours, votre campagne sera automatiquement mise à jour pour utiliser la dernière version de la solution pour chaque formation hebdomadaire. Si vous n'utilisez pas les mises à jour automatiques des campagnes, vous devez les mettre à jour manuellement afin de déployer le dernier modèle entraîné.

Nombre minimal de transactions provisionnées par seconde et auto-scaling

Lorsque vous créez une campagne Amazon Personalize, vous pouvez spécifier le nombre minimum de transactions provisionnées par seconde (minProvisionedTPS) pour la campagne. Il s'agit du débit de transaction de référence pour la campagne mise en place par Amazon Personalize. Il définit les frais de facturation minimaux pour la campagne lorsqu'elle est active. Une transaction est une transaction unique GetRecommendations ou une GetPersonalizedRanking demande. La valeur par défaut minProvisionedTPS est 1.

Si votre TPS augmente au-delà deminProvisionedTPS, Amazon Personalize redimensionne automatiquement la capacité allouée à la hausse ou à la baisse, mais jamais en dessous. minProvisionedTPS Il y a un court délai pendant lequel la capacité augmente, ce qui peut entraîner une perte de transactions. Lorsque votre trafic diminue, la capacité revient auminProvisionedTPS.

Vous êtes facturé pour le TPS minimum fourni ou, si vos demandes dépassent leminProvisionedTPS, le TPS réel. Le TPS réel est le nombre total de demandes de recommandation que vous faites. Nous vous recommandons de commencer par un faibleminProvisionedTPS, de suivre votre consommation à l'aide CloudWatch des statistiques Amazon, puis de l'minProvisionedTPSaugmenter si nécessaire.

Pour plus d'informations sur les coûts des campagnes, consultez la section Tarification d'Amazon Personalize.

Métadonnées des éléments dans les recommandations

Lorsque vous recevez des recommandations, vous pouvez demander à Amazon Personalize d'inclure les métadonnées des articles dans les résultats des recommandations. Dans votre demande, vous pouvez choisir les colonnes à inclure dans votre jeu de données Items. Amazon Personalize renvoie ces données pour chaque article dans la réponse de recommandation.

Vous pouvez utiliser les métadonnées pour enrichir les recommandations dans votre interface utilisateur, par exemple en ajoutant les genres de films aux carrousels. Vous pouvez également l'utiliser pour évaluer visuellement la qualité des recommandations. Si vous utilisez l'IA générative dans votre application, vous pouvez intégrer les métadonnées aux instructions de l'IA pour générer un contenu plus pertinent. Pour plus d'informations sur l'utilisation d'Amazon Personalize avec l'IA générative, consultezAmazon Personalize et l'IA générative.

Activation des métadonnées

Pour ajouter des métadonnées aux recommandations, vous devez disposer d'un jeu de données Items avec une colonne de métadonnées. Vous n'êtes pas obligé d'utiliser les métadonnées lors de l'entraînement. Pour plus d'informations sur la création d'un jeu de données, consultezCréation d'un schéma et d'un jeu de données. Pour plus d'informations sur la mise à jour des données, consultezMise à jour des données dans les ensembles de données après l'entraînement.

Si vous utilisez la formule User-Personalization-v 2 ou Personalized-Ranking-v 2, les nouvelles campagnes ont automatiquement la possibilité d'inclure les métadonnées des articles dans les résultats des recommandations. Vous n'avez pas activé manuellement les métadonnées pour votre campagne. Pour toutes les autres recettes et cas d'utilisation du domaine, vous devez activer l'option de métadonnées :

Création d'une campagne (console)

Une fois que le statut de la version de votre solution est actif, vous êtes prêt à la déployer dans le cadre d'une campagne Amazon Personalize.

Création d'une campagne (AWS CLI)

Une fois que la version de votre solution est active, vous êtes prêt à la déployer dans le cadre d'une campagne Amazon Personalize. Pour créer une campagne avec le AWS CLI, vous devez utiliser la create-campaign commande.

L'exemple de code suivant vous montre comment créer une campagne. Il déploie la dernière version d'une solution qui utilise la recette de personnalisation utilisateur. La campagne qu'il crée est automatiquement mise à jour pour utiliser les futures versions de la solution. Le code utilise la configuration suivante :

Pour obtenir la liste complète de tous les paramètres, voirCreateCampaign.

aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"

La campagne est prête lorsque son statut est ACTIF. Pour obtenir l'état actuel, appelez l'API DescribeCampaign et vérifiez que le champ status est ACTIVE.

Si vous modifiez la version de votre solution et que votre campagne n'est pas automatiquement mise à jour pour utiliser la dernière version de la solution, ou si vous souhaitez modifier les paramètres de votre campagne, vous devez mettre à jour votre campagne. Pour de plus amples informations, veuillez consulter Mettre à jour la configuration d'une campagne Amazon Personalize.

Amazon Personalize vous propose des opérations de gestion de campagnes, telles que ListCampaigns la liste des campagnes que vous avez créées. Vous pouvez supprimer une campagne en appelant l'API DeleteCampaign. Si vous supprimez une campagne, les versions des solutions qui font partie de cette campagne ne sont pas supprimées.

Après avoir créé votre campagne, vous pouvez l'utiliser pour faire des recommandations. Pour de plus amples informations, veuillez consulter Obtenir des recommandations de la part d'Amazon Personalize.

Création d'une campagne (AWS SDKs)

Une fois que la version de votre solution est active, vous êtes prêt à la déployer dans le cadre d'une campagne Amazon Personalize. Pour créer une campagne avec AWS SDKs, vous devez utiliser l'opération CreateCampaign API.

L'exemple de code suivant vous montre comment créer une campagne. Le code déploie la dernière version d'une solution qui utilise la recette de personnalisation utilisateur. La campagne qu'il crée est automatiquement mise à jour pour utiliser les futures versions de la solution. Le code utilise la configuration suivante :

Pour obtenir la liste complète de tous les paramètres, voirCreateCampaign.

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 campagne est prête lorsque son statut est ACTIF. Pour connaître le statut actuelDescribeCampaign, appelez et vérifiez que le status champ est bien renseignéACTIVE.

Si vous modifiez manuellement la version de votre solution ou si vous souhaitez modifier les paramètres de votre campagne, vous devez mettre à jour votre campagne. Pour de plus amples informations, veuillez consulter Mettre à jour la configuration d'une campagne Amazon Personalize.

Amazon Personalize vous propose des opérations de gestion de campagnes, telles que ListCampaigns la liste des campagnes que vous avez créées. Vous pouvez supprimer une campagne en appelant l'API DeleteCampaign. Si vous supprimez une campagne, les versions des solutions qui font partie de cette campagne ne sont pas supprimées.

Une fois que vous avez créé votre campagne, utilisez-la pour effectuer des recommandations. Pour de plus amples informations, veuillez consulter Obtenir des recommandations de la part d'Amazon Personalize.