As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Obter recomendações de itens em tempo real

Você pode obter recomendações de itens em tempo real de um recomendador ou campanha personalizada do Amazon Personalize com o console Amazon Personalize, AWS Command Line Interface () ou.AWS CLI 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 receber recomendações e o Nome do recurso Amazon (ARN) da sua campanha ou do seu recomendador. É exibida uma lista dos 10 principais itens recomendados para o usuário. Se você usar User-Personalization-v 2, cada item recomendado incluirá 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 User-Personalization-v 2.

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 ITEMS receita RELATED _ para treinar a versão da solução de apoio à campanha, substitua o user-id parâmetro 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 (AWS SDKs)

O código a seguir mostra como obter recomendações do Amazon Personalize para um usuário de uma campanha com o. 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 receber recomendações e o Nome do recurso Amazon (ARN) da sua campanha ou do seu recomendador. É exibida uma lista dos 10 principais itens recomendados para o usuário. Se você usar User-Personalization-v 2, cada item recomendado incluirá 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 User-Personalization-v 2.

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 ITEMS receita RELATED _ para treinar a versão da solução de apoio à campanha, substitua o userId parâmetro 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 Incluindo metadados do item com recomendações ()AWS SDKs. Para obter informações sobre como habilitar metadados, consulte Metadados do item 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();