

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 la cui portata 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.

   

     
![\[Search interface showing query "Who is Lewis Hamilton?" with Formula One driver information results.\]](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.

   

     
![\[Search results for "How does Formula One work?" showing snippets about the racing series.\]](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.

   

     
![\[Search results for "Formula One" showing Amazon Kendra suggested answers with article snippets.\]](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».

   

     
![\[Search interface for soccer matches with filters and Amazon Kendra suggested answers.\]](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, 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" \
           --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.