Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Étape 5 : Interrogation de l'index Amazon Kendra Votre index Amazon Kendra est désormais prêt pour les requêtes en langage naturel. Lorsque vous effectuez une recherche dans votre index, Amazon Kendra utilise toutes les données et métadonnées que vous avez fournies pour renvoyer les réponses les plus précises à votre requête de recherche. Amazon Kendra peut répondre à trois types de requêtes : + Requêtes factuelles (questions « qui », « quoi », « quand » ou « où ») + Requêtes descriptives (questions « comment ») + Recherches par mots clés (questions dont l'intention et la portée ne sont pas claires) **Topics** + [Interrogation de votre index Amazon Kendra](#tutorial-search-metadata-query-kendra-basic) + [Filtrer les résultats de recherche](#tutorial-search-metadata-query-kendra-filters) ## Interrogation de votre index Amazon Kendra Vous pouvez interroger votre index Amazon Kendra à l'aide de questions correspondant aux trois types de requêtes pris en charge par Amazon Kendra. Pour plus d'informations, consultez la section [Requêtes](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html). Les exemples de questions de cette section ont été choisis en fonction de l'ensemble de données d'exemple. ### Pour interroger votre index Amazon Kendra (console) 1. Ouvrez la console Amazon Kendra à l'adresse. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/) 1. Dans la liste **des index**, cliquez sur`kendra-index`. 1. Dans le menu de navigation de gauche, choisissez l'option de recherche dans votre index. 1. Pour exécuter un exemple de requête factoïdale, entrez **Who is Lewis Hamilton?** dans le champ de recherche et appuyez sur Entrée. Le premier résultat renvoyé est la réponse suggérée par Amazon Kendra, ainsi que le fichier de données contenant la réponse. Le reste des résultats constitue l'ensemble des documents recommandés. ![\[Search interface showing query "Who is Lewis Hamilton?" with Formula One driver information results.\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/images/tutorial-query1.png) 1. Pour exécuter une requête descriptive, entrez **How does Formula One work?** dans le champ de recherche et appuyez sur Entrée. Vous verrez un autre résultat renvoyé par la console Amazon Kendra, cette fois avec la phrase correspondante surlignée. ![\[Search results for "How does Formula One work?" showing snippets about the racing series.\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/images/tutorial-query2.png) 1. Pour lancer une recherche par mot clé, entrez **Formula One** dans le champ de recherche et appuyez sur Entrée. Vous verrez un autre résultat renvoyé par la console Amazon Kendra, suivi des résultats pour toutes les autres mentions de la phrase dans l'ensemble de données. ![\[Search results for "Formula One" showing Amazon Kendra suggested answers with article snippets.\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/images/tutorial-query3.png) ### Pour interroger votre index Amazon Kendra ()AWS CLI 1. Pour exécuter un exemple de requête factoid, utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra query \ --index-id kendra-index-id \ --query-text "Who is Lewis Hamilton?" \ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra query ^ --index-id kendra-index-id ^ --query-text "Who is Lewis Hamilton?" ^ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ AWS CLI Affiche les résultats de votre requête. 1. Pour exécuter un exemple de requête descriptive, utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra query \ --index-id kendra-index-id \ --query-text "How does Formula One work?" \ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra query ^ --index-id kendra-index-id ^ --query-text "How does Formula One work?" ^ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ AWS CLI Affiche les résultats de votre requête. 1. Pour exécuter un exemple de recherche par mot clé, utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra query \ --index-id kendra-index-id \ --query-text "Formula One" \ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra query ^ --index-id kendra-index-id ^ --query-text "Formula One" ^ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ AWS CLI Affiche les réponses renvoyées à votre requête. ## Filtrer les résultats de recherche Vous pouvez filtrer et trier les résultats de recherche à l'aide d'attributs de document personnalisés dans la console Amazon Kendra. Pour plus d'informations sur la façon dont Amazon Kendra traite les requêtes, consultez la section [Filtrage](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html) des requêtes. ### Pour filtrer les résultats de recherche (Console) 1. Ouvrez la console Amazon Kendra à l'adresse. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/) 1. Dans la liste **des index**, cliquez sur`kendra-index`. 1. Dans le menu de navigation de gauche, choisissez l'option de recherche dans votre index. 1. Dans le champ de recherche, entrez **Soccer matches** sous forme de requête et appuyez sur Entrée. 1. Dans le menu de navigation de gauche, choisissez **Filtrer les résultats de recherche** pour afficher une liste de facettes que vous pouvez utiliser pour filtrer votre recherche. 1. Cochez la case « Ligue des champions » sous le sous-titre **ÉVÉNEMENT**, pour que les résultats de votre recherche soient filtrés uniquement en fonction des résultats contenant « Ligue des champions ». ![\[Search interface for soccer matches with filters and Amazon Kendra suggested answers.\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/images/tutorial-filter.png) ### Pour filtrer les résultats de votre recherche (AWS CLI) 1. Pour voir les entités d'un type spécifique (par exemple`EVENT`) disponibles pour une recherche, utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra query \ --index-id kendra-index-id \ --query-text "Soccer matches" \ --facets '[{"DocumentAttributeKey":"EVENT"}]' \ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra query ^ --index-id kendra-index-id ^ --query-text "Soccer matches" ^ --facets '[{"DocumentAttributeKey":"EVENT"}]' ^ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ AWS CLI Affiche les résultats de la recherche. Pour obtenir une liste des facettes par type`EVENT`, accédez à la section « FacetResults » de la AWS CLI sortie pour voir une liste des facettes filtrables avec leur nombre. Par exemple, l'une des facettes est la « Ligue des champions ». **Note** Au lieu de cela`EVENT`, vous pouvez choisir l'un des champs d'index que vous avez créés [Création d'un index Amazon Kendra](tutorial-search-metadata-create-index-ingest.md#tutorial-search-metadata-create-index) pour la `DocumentAttributeKey` valeur. 1. Pour exécuter la même recherche mais filtrer uniquement en fonction des résultats contenant « Champions League », utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ 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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ 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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ AWS CLI Affiche les résultats de recherche filtrés.