Obter recomendações de itens (console)Obtendo recomendações de itens (AWS CLI)Obtendo recomendações de itens (AWS SDKs)

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 (AWS CLI), ou AWS SDKs.

Tópicos

Obter recomendações de itens (console)
Obtendo recomendações de itens (AWS CLI)
Obtendo recomendações de itens (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.

Como obter recomendações

Abra o console Amazon Personalize em https://console.aws.amazon.com/personalize/casa e faça login na sua conta.
Escolha o grupo de conjuntos de dados que contém a campanha ou o recomendador que você está usando.
No painel de navegação, selecione Campanhas ou Recomendadores.
Escolha a campanha ou o recomendador.
Para uma campanha, em Resultados da campanha de teste, insira os detalhes da sua solicitação de recomendação com base na fórmula que você usou. No caso dos recomendadores, escolha Recomendador de teste e insira os detalhes da solicitação de recomendação dependendo do seu caso de uso.

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.
Ou então, selecione um filtro. Para obter mais informações, consulte Como filtrar recomendações e segmentos de usuários.
Se você usa metadados contextuais, forneça dados para cada contexto. Em cada contexto, para a Chave, insira o campo de metadados. Para o Valor, insira os dados contextuais. Para obter mais informações, consulte Como aumentar a relevância das recomendações com metadados contextuais.
Se você habilitou os metadados nas recomendações da campanha ou do recomendador, para as colunas do conjunto de dados de itens, selecione as colunas de metadados a serem incluídas nos resultados das recomendações. Para obter informações sobre como habilitar metadados para uma campanha, consulte Metadados do item nas recomendações. Para obter informações sobre como habilitar metadados para um recomendador, consulte Habilitando metadados em recomendações para um recomendador de domínio no Amazon Personalize.
Se você quiser promover um subconjunto de itens, pode preencher os campos Promoção. Para ter mais informações, consulte Como promover itens nas recomendações.
Escolha Get recommendations (Obter recomendações). É exibida uma tabela contendo os 25 itens mais recomendados pelo usuário. Se você usa 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 personalização do usuário-v2.

Obtendo 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ê usa 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 personalização do usuário-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 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

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

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.

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

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Recomendações de itens em tempo real

Obtendo metadados do item com recomendações