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á.
# Etapa 5: consultar o índice do Amazon Kendra
O índice do Amazon Kendra agora está pronto para consultas em linguagem natural. Ao pesquisar o índice, o Amazon Kendra usa todos os dados e metadados fornecidos para retornar as respostas mais precisas à consulta de pesquisa.
Há três tipos de consultas que a Amazon Kendra pode responder:
+ Consultas factóides (perguntas sobre “quem”, “o quê”, “quando” ou “onde”)
+ Consultas descritivas (perguntas do tipo “como”)
+ Pesquisas por palavra-chave (perguntas cuja intenção e escopo não são claros)
**Topics**
+ [Consulte o índice do Amazon Kendra](#tutorial-search-metadata-query-kendra-basic)
+ [Filtrar os resultados de pesquisa](#tutorial-search-metadata-query-kendra-filters)
## Consulte o índice do Amazon Kendra
Você pode consultar o índice do Amazon Kendra usando perguntas que correspondem aos três tipos de consultas compatíveis com o Amazon Kendra. Para obter mais informações consulte [Consultas](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html).
As perguntas de exemplo nesta seção foram escolhidas com base no conjunto de dados de amostra.
### Para consultar um índice do Amazon Kendra (console)
1. Abra o console Amazon Kendra em. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Na lista de **Índices**, clique em `kendra-index`.
1. No menu de navegação à esquerda, escolha a opção de pesquisar no índice.
1. Para executar um exemplo de consulta de factoide, insira **Who is Lewis Hamilton?** na caixa de pesquisa e pressione enter.
O primeiro resultado retornado é a resposta sugerida pela Amazon Kendra, junto com o arquivo de dados contendo a resposta. O restante dos resultados forma o conjunto de documentos recomendados.
![\[Search interface showing query "Who is Lewis Hamilton?" with Formula One driver information results.\]](http://docs.aws.amazon.com/pt_br/kendra/latest/dg/images/tutorial-query1.png)
1. Para executar um exemplo de consulta, insira **How does Formula One work?** na caixa de pesquisa e pressione enter.
Você verá outro resultado retornado pelo console Amazon Kendra, desta vez com a frase relevante destacada.
![\[Search results for "How does Formula One work?" showing snippets about the racing series.\]](http://docs.aws.amazon.com/pt_br/kendra/latest/dg/images/tutorial-query2.png)
1. Para executar uma pesquisa por palavra-chave, insira **Formula One** na caixa de pesquisa e pressione enter.
Você verá outro resultado retornado pelo console do Amazon Kendra, seguido pelos resultados de todas as outras menções da frase no conjunto de dados.
![\[Search results for "Formula One" showing Amazon Kendra suggested answers with article snippets.\]](http://docs.aws.amazon.com/pt_br/kendra/latest/dg/images/tutorial-query3.png)
### Para consultar um índice do Amazon Kendra (AWS CLI)
1. Para executar um exemplo de consulta factoide, use o comando [consulta](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):
------
#### [ Linux ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Who is Lewis Hamilton?" \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Who is Lewis Hamilton?" \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra query ^
--index-id kendra-index-id ^
--query-text "Who is Lewis Hamilton?" ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
AWS CLI Exibe os resultados da sua consulta.
1. Para executar um exemplo de consulta descritiva, use o comando [consulta](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):
------
#### [ Linux ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "How does Formula One work?" \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "How does Formula One work?" \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra query ^
--index-id kendra-index-id ^
--query-text "How does Formula One work?" ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
AWS CLI Exibe os resultados da sua consulta.
1. Para executar uma amostra de pesquisa por palavra-chave, use o comando [consulta](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):
------
#### [ Linux ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Formula One" \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Formula One" \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra query ^
--index-id kendra-index-id ^
--query-text "Formula One" ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
AWS CLI Exibe as respostas retornadas à sua consulta.
## Filtrar os resultados de pesquisa
Você pode filtrar e classificar os resultados de pesquisa usando atributos de documentos personalizados no console do Amazon Kendra. Para obter mais informações sobre como o Amazon Kendra processa consultas, consulte [Filtragem de consultas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).
### Para filtrar os resultados da pesquisa (console)
1. Abra o console Amazon Kendra em. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Na lista de **Índices**, clique em `kendra-index`.
1. No menu de navegação à esquerda, escolha a opção de pesquisar no índice.
1. Na caixa de pesquisa, insira **Soccer matches** como uma consulta e pressione enter.
1. No menu de navegação à esquerda, escolha **Filtrar resultados da pesquisa** para ver uma lista das facetas que você pode usar para filtrar a pesquisa.
1. Marque a caixa de seleção “Liga dos Campeões” sob o subtítulo **EVENTO**, para ver os resultados da pesquisa filtrados somente pelos resultados que contêm “Liga dos Campeões”.
![\[Search interface for soccer matches with filters and Amazon Kendra suggested answers.\]](http://docs.aws.amazon.com/pt_br/kendra/latest/dg/images/tutorial-filter.png)
### Para filtrar os resultados da pesquisa (console)
1. Para ver as entidades de um tipo específico (como `EVENT`) que estão disponíveis para uma pesquisa, use o comando [consulta](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):
------
#### [ Linux ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Soccer matches" \
--facets '[{"DocumentAttributeKey":"EVENT"}]' \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Soccer matches" \
--facets '[{"DocumentAttributeKey":"EVENT"}]' \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra query ^
--index-id kendra-index-id ^
--query-text "Soccer matches" ^
--facets '[{"DocumentAttributeKey":"EVENT"}]' ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
AWS CLI Exibe os resultados da pesquisa. Para obter uma lista de facetas do tipo`EVENT`, navegue até a seção "FacetResults" da AWS CLI saída para ver uma lista de facetas filtráveis com suas contagens. Por exemplo, uma das facetas é a “Liga dos Campeões”.
**nota**
Em vez de `EVENT`, você pode escolher qualquer um dos campos de índice que você criou em [Criar um índice do Amazon Kendra](tutorial-search-metadata-create-index-ingest.md#tutorial-search-metadata-create-index) para o valor `DocumentAttributeKey`.
1. Para executar a mesma pesquisa, mas filtrar somente pelos resultados que contêm “Liga dos Campeões”, use o comando de [consulta](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):
------
#### [ Linux ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Soccer matches" \
--attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra query \
--index-id kendra-index-id \
--query-text "Soccer matches" \
--attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra query ^
--index-id kendra-index-id ^
--query-text "Soccer matches" ^
--attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
AWS CLI Exibe os resultados da pesquisa filtrada.