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

# Envio de feedback para aprendizado incremental
<a name="submitting-feedback"></a>

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

Amazon Kendra usa aprendizado incremental para melhorar os resultados da pesquisa. Usando o feedback das consultas, o aprendizado incremental melhora os algoritmos de classificação e otimiza os resultados da pesquisa para obter maior precisão.

Por exemplo, suponha que os usuários pesquisam a frase “benefícios de assistência médica”. Se os usuários escolherem consistentemente o segundo resultado da lista, com o tempo, o Amazon Kendra aumentará esse resultado para o primeiro lugar. O aumento diminui com o tempo, portanto, se os usuários pararem de selecionar um resultado, Amazon Kendra eventualmente o removerá e mostrará outro resultado mais popular. Isso ajuda a Amazon Kendra priorizar os resultados com base na relevância, idade e conteúdo.

O aprendizado incremental é ativado para todos os índices e para todos os tipos de [documentos com suporte](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html).

Amazon Kendra começa a aprender assim que você fornece feedback, embora possa levar mais de 24 horas para ver os resultados do feedback. Amazon Kendra fornece três métodos para você enviar feedback: o AWS console, uma JavaScript biblioteca que você pode incluir na sua página de resultados de pesquisa e uma API que você pode usar.

Amazon Kendra aceita dois tipos de feedback do usuário:
+ **Cliques** – Informações sobre quais resultados de consulta o usuário escolheu. O feedback inclui o ID do resultado e a marcação de tempo do UNIX, da data e hora em que o resultado da pesquisa foi escolhido. 

  Para enviar o feedback de cliques, o aplicativo deve coletar informações de cliques das atividades dos usuários e, em seguida, enviar essas informações para o Amazon Kendra. Você pode coletar informações de cliques com o console, a JavaScript biblioteca e a Amazon Kendra API.
+ **Relevância** – Informações sobre a relevância de um resultado de pesquisa, que o usuário normalmente fornece. O feedback contém o ID do resultado e um indicador de relevância (`RELEVANT` ou`NOT_RELEVANT`). O usuário determina as informações relevantes. 

  Para enviar o feedback de relevância, o aplicativo deve fornecer um mecanismo de feedback que permita ao usuário escolher a relevância apropriada para o resultado de uma consulta e, em seguida, enviar essas informações para o Amazon Kendra. Você só pode coletar informações relevantes com o console e a Amazon Kendra API.

O feedback é usado enquanto o índice está ativo. O feedback afeta apenas o índice ao qual é enviado, não pode ser usado em vários índices ou em contas diferentes.

Você deve fornecer contexto de usuário adicional ao consultar seu Amazon Kendra índice. Quando você fornece o contexto do usuário, Amazon Kendra é capaz de saber se o feedback é fornecido por um único usuário ou por vários usuários e ajustar os resultados da pesquisa adequadamente.

Ao fornecer o contexto do usuário, o feedback da consulta é associado ao usuário específico fornecido no contexto. Se não especificar o contexto do usuário, poderá fornecer um ID de visitante usado para agrupar e agregar consultas. 

Se não fornecer o contexto do usuário ou um ID de visitante, o feedback será anônimo e agregado a outros comentários anônimos.

O código a seguir mostra como incluir o contexto do usuário como token ou ID do visitante.

```
response = kendra.query(
    QueryText = query,
    IndexId = index,
    UserToken = {
        Token = "{{token}}"
    })
    
    OR
    
    response = kendra.query(
    QueryText = query,
    IndexId = index,
    VisitorId = "{{visitor-id}}")
```

Para aplicativos da web, use cookies, localizações ou usuários do navegador para gerar um ID de visitante para cada usuário.

Para consultas principais, o maior volume de consultas, fornecer feedback por clique fornece informações suficientes para melhorar a precisão geral. Para consultas finais, aquelas que são raras, os especialistas no assunto devem enviar feedback relevante e não relevante para melhorar a precisão dessas consultas.

Além do console, você pode usar um dos dois métodos: uma JavaScript biblioteca ou a [SubmitFeedback](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html)API. Você só deverá usar um método de coleta de feedback. Para obter melhores resultados, envie feedback dentro de 24 horas após fazer a consulta.

**Topics**
+ [Usando a Amazon Kendra JavaScript biblioteca para enviar feedback](feedback-javascript.md)
+ [Usando a Amazon Kendra API para enviar feedback](feedback-api.md)