Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Obtenir des recommandations d'articles en temps réel

Vous pouvez obtenir des recommandations d'articles en temps réel à partir d'un outil de recommandation Amazon Personalize ou d'une campagne personnalisée à l'aide de la console Amazon Personalize, AWS Command Line Interface (AWS CLI), ou AWS SDKs.

Obtenir des recommandations d'articles (console)

Pour obtenir des recommandations à l'aide de la console Amazon Personalize, vous devez fournir les informations relatives à la demande sur la page détaillée d'un recommandeur (groupe de données de domaines) ou d'une campagne personnalisée.

Obtenir des recommandations d'articles (AWS CLI)

Utilisez le code suivant pour obtenir les recommandations d'une campagne. Pour obtenir les recommandations d'un recommandeur, remplacez le campaign-arn paramètre par. recommender-arn

Spécifiez l'ID de l'utilisateur pour lequel vous souhaitez obtenir des recommandations, ainsi que le nom de ressource Amazon (ARN) de votre campagne ou de votre recommandateur. La liste des 10 principaux éléments recommandés pour l'utilisateur s'affiche. Si vous utilisez User-Personalization-v 2, chaque élément recommandé inclut une liste des raisons pour lesquelles l'élément a été inclus dans les recommandations. Pour de plus amples informations, veuillez consulter Motifs de recommandation avec User-Personalization-v 2.

Pour modifier le nombre d'éléments recommandés, modifiez la valeur denumResults. La valeur par défaut est de 25 éléments. Le maximum est de 500 articles. Si vous avez utilisé une ITEMS recette RELATED _ pour former la version de solution soutenant la campagne, remplacez le user-id paramètre par item-id et spécifiez l'ID de l'article.

Si vous avez enregistré des événements pour un utilisateur avant qu'il ne se connecte (utilisateur anonyme), vous pouvez obtenir des recommandations pour cet utilisateur en fournissant les informations sessionId issues de ces événements comme s'il s'agissait du sienuserId. Pour plus d'informations sur l'enregistrement d'événements pour les utilisateurs anonymes, consultezEnregistrement d'événements pour les utilisateurs anonymes.

aws personalize-runtime get-recommendations \
--campaign-arn campaign arn \
--user-id User ID \
--num-results 10

Obtenir des recommandations d'articles (AWS SDKs)

Le code suivant montre comment obtenir des recommandations Amazon Personalize pour un utilisateur à partir d'une campagne avec le AWS SDKs. Pour obtenir les recommandations d'un recommandeur, remplacez le campaignArn paramètre par. recommenderArn

Spécifiez l'ID de l'utilisateur pour lequel vous souhaitez obtenir des recommandations, ainsi que le nom de ressource Amazon (ARN) de votre campagne ou de votre recommandateur. La liste des 10 principaux éléments recommandés pour l'utilisateur s'affiche. Si vous utilisez User-Personalization-v 2, chaque élément recommandé inclut une liste des raisons pour lesquelles l'élément a été inclus dans les recommandations. Pour de plus amples informations, veuillez consulter Motifs de recommandation avec User-Personalization-v 2.

Pour modifier le nombre d'éléments recommandés, modifiez la valeur denumResults. La valeur par défaut est de 25 éléments. Le maximum est de 500 articles. Si vous avez utilisé une ITEMS recette RELATED _ pour former la version de solution soutenant la campagne, remplacez le userId paramètre par itemId et spécifiez l'ID de l'article.

Si vous avez activé les métadonnées dans les recommandations pour votre campagne ou votre recommandateur, vous pouvez spécifier les colonnes de métadonnées du jeu de données Items à inclure dans la réponse. Pour obtenir un exemple de code, consultez Inclure les métadonnées des éléments avec les recommandations (AWS SDKs). Pour plus d'informations sur l'activation des métadonnées, consultezMétadonnées des éléments dans les recommandations.

Si vous avez enregistré des événements pour un utilisateur avant qu'il ne se connecte (utilisateur anonyme), vous pouvez obtenir des recommandations pour cet utilisateur en fournissant les informations sessionId issues de ces événements comme s'il s'agissait du sienuserId. Pour plus d'informations sur l'enregistrement d'événements pour les utilisateurs anonymes, consultezEnregistrement d'événements pour les utilisateurs anonymes.

SDK for Python (Boto3)

import boto3

personalizeRt = boto3.client('personalize-runtime')

response = personalizeRt.get_recommendations(
    campaignArn = 'Campaign ARN',
    userId = 'User ID',
    numResults = 10
)

print("Recommended items")
for item in response['itemList']:
    print (item['itemId'])

SDK for Java 2.x

    public static void getRecs(PersonalizeRuntimeClient personalizeRuntimeClient, String campaignArn, String userId) {

        try {
            GetRecommendationsRequest recommendationsRequest = GetRecommendationsRequest.builder()
                    .campaignArn(campaignArn)
                    .numResults(20)
                    .userId(userId)
                    .build();

            GetRecommendationsResponse recommendationsResponse = personalizeRuntimeClient
                    .getRecommendations(recommendationsRequest);
            List<PredictedItem> items = recommendationsResponse.itemList();
            for (PredictedItem item : items) {
                System.out.println("Item Id is : " + item.itemId());
                System.out.println("Item score is : " + item.score());
            }

        } catch (AwsServiceException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }

SDK for JavaScript v3

// Get service clients module and commands using ES6 syntax.
import { GetRecommendationsCommand } from
  "@aws-sdk/client-personalize-runtime";

import { personalizeRuntimeClient } from "./libs/personalizeClients.js";
// Or, create the client here.
// const personalizeRuntimeClient = new PersonalizeRuntimeClient({ region: "REGION"});

// Set the recommendation request parameters.
export const getRecommendationsParam = {
  campaignArn: 'CAMPAIGN_ARN', /* required */
  userId: 'USER_ID',      /* required */
  numResults: 15    /* optional */
}

export const run = async () => {
  try {
    const response = await personalizeRuntimeClient.send(new GetRecommendationsCommand(getRecommendationsParam));
    console.log("Success!", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();