

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

# Configurar a exploração para um recomendador de domínio
<a name="create-recommender-configure-exploration"></a>

Para os casos de uso `Top picks for your` ou `Recommended for you`, o Amazon Personalize usa a exploração ao recomendar itens. A exploração envolve testar recomendações de itens diferentes para saber como os usuários respondem aos itens com poucos dados de interação. Você pode configurar a exploração com o seguinte: 
+ Ênfase na exploração de itens menos relevantes (peso de exploração) — Configure o quanto explorar. Especifique um valor decimal entre 0 e 1. O padrão é de 0,3. Quanto mais próximo o valor estiver de 1, maior será a exploração. Com maior exploração, as recomendações incluem mais itens com menos dados de interações ou relevância com base no comportamento anterior. Em zero, nenhuma exploração ocorre, e as recomendações são baseadas nos dados atuais (relevância).
+ Limite de idade do item de exploração: especifique a idade máxima do item em dias desde a última interação em todos os itens no conjunto de dados de interações com itens. Isso define o escopo da exploração do item com base na idade do item. O Amazon Personalize determina a idade do item com base no carimbo de data e hora de criação ou, se não houver dados de carimbo de data e hora de criação, serão usados os dados das interações com itens. Para obter mais informações sobre como o Amazon Personalize determina a idade do item, consulte [Dados de carimbo de data e hora de criação](items-datasets.md#creation-timestamp-data). 

  Para aumentar os itens que o Amazon Personalize considera durante a exploração, insira um valor maior. O mínimo é 1 dia e o padrão é 30 dias. As recomendações podem incluir itens mais antigos do que o limite de idade do item especificado. Isso ocorre porque esses itens são relevantes para o usuário e a exploração não os identificou.

Os exemplos de código a seguir mostram como configurar a exploração para um recomendador com o AWS CLI ou o. AWS SDKs Para fazer isso com o console Amazon Personalize, especifique a configuração de exploração na página **Configuração avançada** ao criar o recomendador. Para obter mais informações, consulte [Criar recomendadores (console)](creating-domain-recommenders.md#creating-recommenders-console). 

## Configurar a exploração (AWS CLI)
<a name="domain-config-explore-cli"></a>

O código a seguir mostra como configurar a exploração ao criar um recomendador para o caso de uso `Top picks for you`. O exemplo usa os valores padrão.

Se você tiver um conjunto de dados de itens e quiser a opção de incluir metadados ao receber recomendações, atualize a `recommender-config` para adicionar um campo `enableMetadataWithRecommendations` e defini-lo como `true`.

```
aws personalize create-recommender \
--name recommender name \
--dataset-group-arn dataset group ARN \
--recipe-arn arn:aws:personalize:::recipe/aws-vod-top-picks \
--recommender-config "{\"itemExplorationConfig\":{\"explorationWeight\":\"0.3\",\"explorationItemAgeCutOff\":\"30\"}}"
```

## Configurar a exploração (AWS SDKs)
<a name="domain-config-explore-sdk"></a>

Para os casos de uso `Top picks for your` ou `Recommended for you`, o Amazon Personalize usa a exploração ao recomendar itens. A exploração envolve testar recomendações de itens diferentes para saber como os usuários respondem aos itens com poucos dados de interação. Você pode configurar a exploração com o seguinte: 
+ Ênfase na exploração de itens menos relevantes (peso de exploração) — Configure o quanto explorar. Especifique um valor decimal entre 0 e 1. O padrão é de 0,3. Quanto mais próximo o valor estiver de 1, maior será a exploração. Com maior exploração, as recomendações incluem mais itens com menos dados de interações ou relevância com base no comportamento anterior. Em zero, nenhuma exploração ocorre, e as recomendações são baseadas nos dados atuais (relevância).
+ Limite de idade do item de exploração: especifique a idade máxima do item em dias desde a última interação em todos os itens no conjunto de dados de interações com itens. Isso define o escopo da exploração do item com base na idade do item. O Amazon Personalize determina a idade do item com base no carimbo de data e hora de criação ou, se não houver dados de carimbo de data e hora de criação, serão usados os dados das interações com itens. Para obter mais informações sobre como o Amazon Personalize determina a idade do item, consulte [Dados de carimbo de data e hora de criação](items-datasets.md#creation-timestamp-data). 

  Para aumentar os itens que o Amazon Personalize considera durante a exploração, insira um valor maior. O mínimo é 1 dia e o padrão é 30 dias. As recomendações podem incluir itens mais antigos do que o limite de idade do item especificado. Isso ocorre porque esses itens são relevantes para o usuário, e a exploração não os identificou.

O código a seguir mostra como configurar a exploração ao criar um recomendador. O exemplo usa os valores padrão.

------
#### [ SDK for Python (Boto3) ]

```
import boto3

personalize = boto3.client('personalize')

create_recommender_response = personalize.create_recommender(
  name = 'recommender name',
  recipeArn = 'arn:aws:personalize:::recipe/aws-vod-top-picks',
  datasetGroupArn = 'dataset group ARN',
  recommenderConfig = {"itemExplorationConfig": {"explorationWeight": "0.3", "explorationItemAgeCutOff": "30"}}
)

recommender_arn = create_recommender_response['recommenderArn']

print('Recommender ARN:' + recommender_arn)
```

------
#### [ SDK for JavaScript v3 ]

```
// Get service clients and commands using ES6 syntax.
import { CreateRecommenderCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";

// create personalizeClient
const personalizeClient = new PersonalizeClient({
  region: "REGION"
});

// set the recommender's parameters
export const createRecommenderParam = {
  name: "RECOMMENDER_NAME",                    /* required */
  recipeArn: "RECIPE_ARN",                     /* required */
  datasetGroupArn: "DATASET_GROUP_ARN",        /* required */
  recommenderConfig: {
    itemExplorationConfig: {
      explorationWeight: "0.3",
      explorationItemAgeCutOff: "30"
    }
  }
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(new CreateRecommenderCommand(createRecommenderParam));
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();
```

------