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

# Recomendações de ação em tempo real no Amazon Personalize
<a name="get-action-recommendations"></a>

 Se você usar uma fórmula PERSONALIZED\$1ACTIONS, poderá obter recomendações de ações da campanha em tempo real. É possível obter recomendações de ações com o console do Amazon Personalize, a AWS Command Line Interface (AWS CLI) ou os SDKs da AWS. 

**Topics**
+ [

## Como funciona a pontuação de recomendações
](#how-action-recommendation-scoring-works)
+ [

## Obter recomendações de ações (console)
](#get-action-recommendations-console)
+ [

## Obter recomendações de ações (AWS CLI)
](#get-action-recommendations-cli-example)
+ [

## Obter recomendações de ações (SDKs da AWS)
](#get-action-recommendations-sdk-example)

## Como funciona a pontuação de recomendações
<a name="how-action-recommendation-scoring-works"></a>

Com a fórmula Next-Best-Action, o Amazon Personalize gera pontuações para ações com base na probabilidade de o usuário interagir com a ação. As pontuações podem estar entre 0 e 1,0. Quanto mais próxima estiver de 1,0, maior será a probabilidade de o usuário interagir com a ação.

 Se você não importou dados de interações com ações, todas as ações recomendadas terão uma pontuação de 0,0. Se o Amazon Personalize recomendar uma ação como parte da *exploração*, o item terá uma pontuação de 0,0. O Amazon Personalize usa a exploração para recomendar ações sem dados de interações com ações. Para obter mais informações sobre exploração, consulte [Exploration (Exploração)](use-case-recipe-features.md#about-exploration).

## Obter recomendações de ações (console)
<a name="get-action-recommendations-console"></a>

 Para obter recomendações de ações com o console do Amazon Personalize, você deve fornecer as informações da solicitação na página de detalhes de uma campanha personalizada.

**Como obter recomendações de ações**

1. Acesse [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) para abrir o console do Amazon Personalize e faça login na sua conta. 

1. Selecione o grupo de conjuntos de dados que contém a campanha utilizada.

1. No painel de navegação, em **Recursos personalizados**, selecione **Campanhas**.

1. Selecione a campanha de destino.

1. Em **Testar resultados da campanha**, insira os detalhes da solicitação de recomendação.

    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](recording-events.md#recording-anonymous-user-events). 

1. Ou então, selecione um filtro. Para obter mais informações, consulte [Como filtrar recomendações e segmentos de usuários](filter.md). 

1. Escolha **Obter recomendações**. Será exibida uma tabela com as cinco principais ações recomendadas. 

## Obter recomendações de ações (AWS CLI)
<a name="get-action-recommendations-cli-example"></a>

Use o código a seguir para obter recomendações de ações de uma campanha. Especifique o ID do usuário para o qual você deseja obter recomendações e o nome do recurso da Amazon (ARN) da campanha.

Para alterar o número de ações recomendadas, altere o valor de `numResults`. O padrão são cinco ações. O máximo são cem ações. 

Para filtrar as recomendações de ações por critérios personalizados, é possível criar um filtro e aplicá-lo à operação `get-action-recommendations`. Para obter mais informações, consulte [Como filtrar recomendações e segmentos de usuários](filter.md).

 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](recording-events.md#recording-anonymous-user-events). 

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

## Obter recomendações de ações (SDKs da AWS)
<a name="get-action-recommendations-sdk-example"></a>

O código a seguir mostra como obter recomendações do Amazon Personalize para um usuário a partir de uma campanha. Especifique o ID do usuário para o qual você deseja obter recomendações e o nome do recurso da Amazon (ARN) da campanha. 

Para alterar o número de ações recomendadas, altere o valor de `numResults`. O padrão são cinco ações. O máximo são cem ações.

Para filtrar as recomendações de ações por critérios personalizados, é possível criar um filtro e aplicá-lo à solicitação de API [GetActionRecommendations](API_RS_GetActionRecommendations.md). Para obter mais informações, consulte [Como filtrar recomendações e segmentos de usuários](filter.md).

 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](recording-events.md#recording-anonymous-user-events). 

```
import boto3

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

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

print("Recommended actions")
for item in response['actionList']:
    print (item['actionId'])
```