Receber recomendações em tempo real

É possível obter recomendações de itens de um recomendador do Amazon Personalize ou de uma campanha personalizada com o console do Amazon Personalize, a AWS Command Line Interface (AWS CLI) ou AWS SDKs.

Obter recomendações de itens (console)

Para obter recomendações com o console do Amazon Personalize, você fornece as informações da solicitação na página de detalhes de um recomendador (grupo de conjuntos de dados de domínio) ou de uma campanha personalizada.

Obter recomendações de itens (AWS CLI)

Use o código a seguir para obter uma recomendação a partir de uma campanha. Para obter recomendações de um recomendador, substitua o parâmetro campaign-arn pelo recommender-arn.

Especifique o ID do usuário para o qual você deseja obter recomendações e o nome do recurso da Amazon (ARN) da sua campanha ou recomendador. É exibida uma lista dos 10 principais itens recomendados para o usuário. Se você usa a fórmula User-Personalization-v2, cada item recomendado inclui uma lista de motivos pelos quais o item foi incluído nas recomendações. Para obter mais informações, consulte Motivos de recomendação com a User-Personalization-v2.

Para alterar o número de itens recomendados, altere o valor de numResults. O padrão é 25 itens. O máximo é 500 itens. Se você usou uma fórmula RELATED_ITEMS para treinar a versão da solução da campanha, substitua o parâmetro user-id por item-id e especifique o ID do item.

Se registrou eventos de um usuário antes de ele fazer login (um usuário anônimo), será possível obter recomendações para esse usuário fornecendo o sessionId desses eventos em vez de userId. Para obter mais informações sobre a gravação de eventos para usuários anônimos, consulte Como registrar eventos de usuários anônimos.

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

Obter recomendações de itens (SDKs da AWS)

O código a seguir mostra como obter recomendações do Amazon Personalize para um usuário a partir de uma campanha com os AWS SDKs. Para obter recomendações de um recomendador, substitua o parâmetro campaignArn pelo recommenderArn.

Especifique o ID do usuário para o qual você deseja obter recomendações e o nome do recurso da Amazon (ARN) da sua campanha ou recomendador. É exibida uma lista dos 10 principais itens recomendados para o usuário. Se você usa a fórmula User-Personalization-v2, cada item recomendado inclui uma lista de motivos pelos quais o item foi incluído nas recomendações. Para obter mais informações, consulte Motivos de recomendação com a User-Personalization-v2.

Para alterar o número de itens recomendados, altere o valor de numResults. O padrão é 25 itens. O máximo é 500 itens. Se você usou uma fórmula RELATED_ITEMS para treinar a versão da solução da campanha, substitua o parâmetro userId por itemId e especifique o ID do item.

Se você habilitou os metadados nas recomendações da campanha ou do recomendador, é possível especificar as colunas de metadados do conjunto de dados de itens a serem incluídas na resposta. Para obter um exemplo de código, consulte Incluir metadados do item com recomendações (AWS SDKs). Para obter informações sobre como habilitar metadados, consulte Habilitar metadados nas recomendações.

Se registrou eventos de um usuário antes de ele fazer login (um usuário anônimo), será possível obter recomendações para esse usuário fornecendo o sessionId desses eventos em vez de userId. Para obter mais informações sobre a gravação de eventos para usuários anônimos, consulte Como registrar eventos de usuários anônimos.

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