

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Fase 5: Interrogazione dell'indice Amazon Kendra
<a name="tutorial-search-metadata-query-kendra"></a>

Il tuo indice Amazon Kendra è ora pronto per le query in linguaggio naturale. Quando esegui una ricerca nel tuo indice, Amazon Kendra utilizza tutti i dati e i metadati che hai fornito per restituire le risposte più accurate alla tua query di ricerca.

Esistono tre tipi di domande a cui Amazon Kendra può rispondere:
+ Domande fattuali (domande su «chi», «cosa», «quando» o «dove»)
+ Domande descrittive (domande sul «come»)
+ Ricerche per parole chiave (domande il cui intento e ambito non sono chiari)

**Topics**
+ [Interrogazione dell'indice Amazon Kendra](#tutorial-search-metadata-query-kendra-basic)
+ [Filtrare i risultati della ricerca](#tutorial-search-metadata-query-kendra-filters)

## Interrogazione dell'indice Amazon Kendra
<a name="tutorial-search-metadata-query-kendra-basic"></a>

Puoi interrogare il tuo indice Amazon Kendra utilizzando domande che corrispondono ai tre tipi di query supportati da Amazon Kendra. [Per ulteriori informazioni, consulta Query.](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html)

Le domande di esempio in questa sezione sono state scelte in base al set di dati di esempio.

### Per interrogare il tuo indice Amazon Kendra (console)
<a name="tutorial-search-metadata-query-index-console"></a>

1. Apri la console Amazon Kendra all'indirizzo. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)

1. Dall'elenco degli **indici**, fai clic su. `kendra-index`

1. Dal menu di navigazione a sinistra, scegli l'opzione per cercare nell'indice.

1. Per eseguire una query fatttoide di esempio, inseriscila **Who is Lewis Hamilton?** nella casella di ricerca e premi invio.

   Il primo risultato restituito è la risposta suggerita da Amazon Kendra, insieme al file di dati contenente la risposta. Il resto dei risultati costituisce l'insieme di documenti consigliati.

   

     
![Amazon Kendra pagina dei risultati di ricerca che mostra le informazioni sui piloti di Formula Uno per Lewis Hamilton.](http://docs.aws.amazon.com/it_it/kendra/latest/dg/images/tutorial-query1.png)

1. Per eseguire una query descrittiva, inserisci **How does Formula One work?** nella casella di ricerca e premi invio.

   Vedrai un altro risultato restituito dalla console Amazon Kendra, questa volta con la frase pertinente evidenziata.

   

     
![Pagina dei risultati di ricerca che mostra la query Come funziona la Formula Uno con 51 risultati visualizzati.](http://docs.aws.amazon.com/it_it/kendra/latest/dg/images/tutorial-query2.png)

1. Per eseguire una ricerca per parola chiave, inserisci **Formula One** nella casella di ricerca e premi invio.

   Vedrai un altro risultato restituito dalla console Amazon Kendra, seguito dai risultati per tutte le altre menzioni della frase nel set di dati.

   

     
![Amazon Kendra pagina dei risultati di ricerca che mostra le risposte relative alla Formula Uno con frammenti.](http://docs.aws.amazon.com/it_it/kendra/latest/dg/images/tutorial-query3.png)

### Per interrogare il tuo indice Amazon Kendra (AWS CLI)
<a name="tutorial-search-metadata-query-index-cli"></a>

1. [Per eseguire una query factoid di esempio, usa il comando query:](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}}
   ```

   Dove:
   + {{kendra-index-id}}è tuo salvato, `kendra-index-id`
   + {{aws-region}}è la tua AWS regione.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id {{kendra-index-id}} \
           --query-text "Who is Lewis Hamilton?" \
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id {{kendra-index-id}} ^
           --query-text "Who is Lewis Hamilton?" ^
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------

    AWS CLI Visualizza i risultati della ricerca.

1. Per eseguire una query descrittiva di esempio, utilizzate il comando [query](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}}
   ```

   Dove:
   + {{kendra-index-id}}è stato salvato`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id {{kendra-index-id}} \
           --query-text "How does Formula One work?" \
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id {{kendra-index-id}} ^
           --query-text "How does Formula One work?" ^
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------

    AWS CLI Visualizza i risultati della tua ricerca.

1. Per eseguire un esempio di ricerca per parola chiave, usa il comando [query](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}}
   ```

   Dove:
   + {{kendra-index-id}}è stato salvato`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id {{kendra-index-id}} \
           --query-text "Formula One" \
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id {{kendra-index-id}} ^
           --query-text "Formula One" ^
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------

    AWS CLI Visualizza le risposte restituite alla tua richiesta.

## Filtrare i risultati della ricerca
<a name="tutorial-search-metadata-query-kendra-filters"></a>

Puoi filtrare e ordinare i risultati della ricerca utilizzando attributi di documento personalizzati nella console Amazon Kendra. [Per ulteriori informazioni su come Amazon Kendra elabora le query, consulta Filtraggio delle interrogazioni.](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html)

### Per filtrare i risultati della ricerca (Console)
<a name="tutorial-search-metadata-filter-index-console"></a>

1. Apri la console Amazon Kendra all'indirizzo. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)

1. Dall'elenco degli **indici**, fai clic su. `kendra-index`

1. Dal menu di navigazione a sinistra, scegli l'opzione per cercare nell'indice.

1. Nella casella di ricerca, immetti **Soccer matches** come query e premi invio.

1. Dal menu di navigazione a sinistra, scegli **Filtra i risultati della ricerca** per visualizzare un elenco di sfaccettature che puoi usare per filtrare la ricerca.

1. Seleziona la casella di controllo «Champions League» sotto il sottotitolo **EVENTO**, per vedere i risultati della ricerca filtrati solo in base ai risultati contenenti «Champions League».

   

     
![Pagina dei risultati di ricerca che mostra quattro risultati per le partite di calcio con filtri e opzioni di ordinamento.](http://docs.aws.amazon.com/it_it/kendra/latest/dg/images/tutorial-filter.png)

### Per filtrare i risultati della ricerca (AWS CLI)
<a name="tutorial-search-metadata-filter-index-cli"></a>

1. Per visualizzare le entità di un tipo specifico (ad esempio`EVENT`) disponibili per una ricerca, utilizzate il comando [query](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}}
   ```

   Dove:
   + {{kendra-index-id}}è tuo salvato`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id {{kendra-index-id}} \
           --query-text "Soccer matches" \
           --facets '[{"DocumentAttributeKey":"EVENT"}]' \
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id {{kendra-index-id}} ^
           --query-text "Soccer matches" ^
           --facets '[{"DocumentAttributeKey":"EVENT"}]' ^
           --region {{aws-region}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------

    AWS CLI Visualizza i risultati della ricerca. Per ottenere un elenco di sfaccettature di tipo`EVENT`, vai alla sezione "FacetResults" dell' AWS CLI output per visualizzare un elenco di sfaccettature filtrabili con i relativi conteggi. Ad esempio, una delle sfaccettature è «Champions League».
**Nota**  
Invece`EVENT`, puoi scegliere uno qualsiasi dei campi indice che hai creato [Creazione di un indice Amazon Kendra](tutorial-search-metadata-create-index-ingest.md#tutorial-search-metadata-create-index) per il `DocumentAttributeKey` valore.

1. Per eseguire la stessa ricerca ma filtrare solo in base ai risultati contenenti «Champions League», usa il comando [query](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}}
   ```

   Dove:
   + {{kendra-index-id}}è tuo salvato`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ 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}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------
#### [ 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}}
   ```

   Dove:
   + {{kendra-index-id}}è la tua salvezza`kendra-index-id`,
   + {{aws-region}}è la tua AWS regione.

------

    AWS CLI Visualizza i risultati della ricerca filtrati.