

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

# Ajuste e classificação de respostas
<a name="tuning-sorting-responses"></a>

**nota**  
O suporte a recursos varia de acordo com o tipo de índice e a API de pesquisa usada. Consulte se esse recurso é compatível com o tipo de índice e a API de pesquisa que você está usando em [Tipos de índice](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html).

Você poderá modificar o efeito de um campo ou atributo na relevância da pesquisa por meio do ajuste de relevância. Você também poderá classificar os resultados da pesquisa por um determinado atributo ou campo.

**Topics**
+ [Ajuste de respostas](#tuning-responses)
+ [Classificando respostas](#sorting-responses)

## Ajuste de respostas
<a name="tuning-responses"></a>

Modifique o efeito de um campo ou atributo na relevância da pesquisa por meio do ajuste de relevância. Para testar rapidamente o ajuste de relevância, use a API de [consulta](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) para transmitir configurações de ajuste na consulta. Em seguida, visualize os diferentes resultados de pesquisa obtidos em diferentes configurações. O ajuste de relevância no nível da consulta não tem suporte no console. Você também poderá ajustar campos ou atributos que são do tipo `StringList`somente no nível do índice. Para obter mais informações, consulte [Ajustar a relevância da pesquisa](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html).

Por padrão, as respostas da consulta são classificadas pela pontuação de relevância que Amazon Kendra determina cada resultado na resposta.

Você pode ajustar os resultados para qualquer um attribute/field dos seguintes tipos incorporados ou personalizados:
+ Valor da data
+ Valor longo
+ Valor da sequência de caracteres

Não é possível classificar atributos do seguinte tipo:
+ Valores da lista de sequência de caracteres

**Classifique e ajuste os resultados do documento (AWS SDK)**  
Defina o parâmetro `Searchable` como verdadeiro para aumentar a configuração dos metadados do documento.

Para ajustar um atributo em uma consulta, defina o parâmetro `DocumentRelevanceOverrideConfigurations` da API de `Query` e especifique o nome do atributo a ser ajustado.

O exemplo de JSON a seguir mostra um objeto `DocumentRelevanceOverrideConfigurations` que substitui o ajuste do atributo chamado “departamento” no índice.

```
"DocumentRelevanceOverrideConfigurations" : [
    "Name": "department",
    "Relevance": {
        "Importance": 1,
        "ValueImportanceMap": {
            "IT": 3,
            "HR": 7
        }
    }
]
```

## Classificando respostas
<a name="sorting-responses"></a>

Amazon Kendra usa o atributo ou campo de classificação como parte dos critérios para os documentos retornados pela consulta. Por exemplo, os resultados retornados por uma consulta classificada por “\$1created\$1at” podem não conter os mesmos resultados de uma consulta classificada por “\$1version”.

Por padrão, as respostas da consulta são classificadas pela pontuação de relevância que Amazon Kendra determina cada resultado na resposta. Para alterar a ordem de classificação, torne um atributo do documento classificável e configure Amazon Kendra para usar esse atributo para classificar as respostas.

Você pode classificar os resultados em qualquer um attribute/field dos seguintes tipos incorporados ou personalizados:
+ Valor da data
+ Valor longo
+ Valor da sequência de caracteres

Não é possível classificar atributos do seguinte tipo:
+ Valores da lista de sequência de caracteres

Classifique em um ou mais atributos do documento em cada consulta. As consultas retornam 100 resultados. Se houver menos de 100 documentos com o conjunto de atributos de classificação, os documentos sem um valor para o atributo de classificação serão retornados no final dos resultados, classificados por relevância para a consulta.

**Para classificar os resultados do documento (AWS SDK)**

1. Para usar a [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API para tornar um atributo classificável, defina o `Sortable` parâmetro como. `true` O exemplo de JSON a seguir é usado o `DocumentMetadataConfigurationUpdates`, para adicionar um atributo chamado “Departamento” ao índice e torná-lo classificável.

   ```
   "DocumentMetadataConfigurationUpdates": [
      {
          "Name": "Department",
          "Type": "STRING_VALUE",
          "Search": {
              "Sortable": "true"
          }
      }
   ]
   ```

1. Para usar um atributo classificável em uma consulta, defina o parâmetro `SortingConfiguration` da API de [consulta](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html). Especifique o nome do atributo a ser classificado e se a resposta deve ser classificada em ordem crescente ou decrescente.

   O exemplo de JSON a seguir mostra o parâmetro `SortingConfiguration` a ser usado para classificar os resultados de uma consulta pelo atributo “Departamento” em ordem crescente.

   ```
      "SortingConfiguration": { 
         "DocumentAttributeKey": "Department",
         "SortOrder": "ASC"
      }
   ```

1. Para usar mais de um atributo classificável em uma consulta, defina o parâmetro `SortingConfigurations` da API de [consulta](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html). Configure até 3 campos que o Amazon Kendra deve classificar os resultados. Você também poderá especificar se os resultados devem ser classificados em ordem crescente ou decrescente. A cota do campo de classificação pode ser aumentada.

   Se você não fornecer uma configuração de classificação, os resultados serão classificados pela relevância que Amazon Kendra determina o resultado. No caso de empates na classificação dos resultados, os resultados são classificados por relevância. 

   O exemplo de JSON a seguir mostra o parâmetro `SortingConfigurations` a ser usado para classificar os resultados de uma consulta pelos atributos “Nome” e “Preço” em ordem crescente.

   ```
   "CollapseConfiguration" : {
       "DocumentAttributeKey": "Name",
       "SortingConfigurations": [
           { 
               "DocumentAttributeKey": "Price",
               "SortOrder": "ASC"
           }
       ],
       "MissingAttributeKeyStrategy": "IGNORE"
   }
   ```

**Para classificar resultados do documento (console)**
**nota**  
Atualmente, a classificação de vários atributos não tem suporte pelo Console de gerenciamento da AWS.

1. Para tornar um atributo classificável no console, escolha **Classificável** na definição do atributo. Torne um atributo classificável ao criar o atributo ou modificá-lo posteriormente.

1. Para classificar uma resposta de consulta no console, escolha o atributo para classificar a resposta no menu **Classificar**. Somente os atributos marcados como classificáveis durante a configuração da fonte de dados aparecem na lista.