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.

# Génération de requêtes en langage naturel dans Amazon OpenSearch Service
<a name="natural-language-query"></a>

La fonctionnalité de génération de requêtes en langage naturel d'Amazon OpenSearch Service vous permet d'interroger les données de vos journaux opérationnels et de sécurité par le biais du langage naturel. OpenSearch est une option idéale pour explorer les données des journaux, car il s'agit d'un moteur d'analyse et de recherche de journaux hautement évolutif et performant. Vous pouvez désormais utiliser le langage naturel pour explorer ces journaux. Cette fonctionnalité vous permet d'identifier les problèmes sans recourir au langage PPL ( OpenSearch Piped Processing Language) ou sans avoir à rechercher des définitions de données lorsque vous créez vos requêtes. Vous pouvez utiliser la fonctionnalité de génération de requêtes en langage naturel sur les domaines OpenSearch de service avec les versions 2.13 et ultérieures. Vous devez avoir activé le contrôle d'accès détaillé. 

Cette fonctionnalité a été développée avec le kit d'[outils OpenSearch Assistant](https://opensearch.org/docs/latest/ml-commons-plugin/opensearch-assistant/). Si vous souhaitez créer des fonctionnalités similaires qui se connectent à vos grands modèles linguistiques, vous pouvez utiliser la boîte à outils pour configurer vos propres agents et outils.

## Conditions préalables
<a name="Prerequisites"></a>

Avant de pouvoir utiliser la fonctionnalité de génération de requêtes en langage naturel, votre domaine doit disposer des éléments suivants :
+ Version 2.13 ou ultérieure.
+ Logiciel de service R20240520-P4 ou supérieur.
+ Contrôle d'accès détaillé activé. Pour de plus amples informations, veuillez consulter [Activation du contrôle précis des accès](fgac.md#fgac-enabling).

## Prise en main
<a name="natural-language-query-getting-started"></a>

La génération de requêtes en langage naturel est activée par défaut sur tous les domaines créés avec la version 2.13 ou ultérieure pour lesquels le contrôle d'accès détaillé est activé.

Pour les autres domaines, activez-le en sélectionnant **Activer la génération de requêtes en langage naturel et les fonctionnalités Amazon Q Developer**.

Une fois que vous l'avez activée, accédez à la page **Logs** dans les OpenSearch tableaux de bord. Choisissez **Event Explorer** et posez une question à l'aide de l'assistant de requête.

## Configurer les autorisations
<a name="natural-language-query-permissions"></a>

Si vous activez la génération de requêtes en langage naturel sur un domaine de OpenSearch service préexistant, le rôle **query\$1assistant\$1access** risque de ne pas être défini sur le domaine. Les utilisateurs non-administrateurs doivent être mappés à ce rôle pour gérer les index à chaud des domaines utilisant le contrôle précis des accès. Pour créer manuellement le rôle **query\$1assistant\$1access**, effectuez les opérations suivantes :

1. Dans les OpenSearch tableaux de bord, accédez à **Sécurité**, puis sélectionnez **Rôles**.

1. Choisissez **Créer un rôle** et configurez les autorisations de cluster suivantes : 
   + `cluster:admin/opensearch/ml/config/get`
   + `cluster:admin/opensearch/ml/execute`
   + `cluster:admin/opensearch/ml/predict`
   + `cluster:admin/opensearch/ppl`

1. Nommez le rôle **query\$1assistant\$1access**.

1. Choisissez **Créer un rôle**. Le rôle **query\$1assistant\$1access** est désormais disponible.
**Note**  
Vous devez également disposer des autorisations `indices:admin/mappings/get` et d'indexation pour les `read` index avec lesquels vous souhaitez utiliser des questions en langage naturel.

## Automatisation de la configuration
<a name="natural-language-query-automation"></a>

Flow Framework est un OpenSearch plugin qui permet d'[automatiser les OpenSearch configurations](https://opensearch.org/docs/latest/automating-configurations/index/) pour des cas d'utilisation tels que la génération de requêtes et le chat conversationnel. Étant donné que le plugin suit les ressources qui activent la fonctionnalité de génération de requêtes en langage naturel, l'index du framework de flux stocke un modèle pour chaque domaine qui utilise l'assistance aux requêtes.

Flow Framework vous permet de sélectionner parmi un ensemble de [modèles prédéfinis](https://opensearch.org/docs/latest/automating-configurations/workflow-templates/) ou de créer vos propres automatisations pour les connecteurs, outils, agents et autres composants d'apprentissage automatique destinés à servir de OpenSearch backend aux modèles génératifs.