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. # Interrogation d’une base de connaissances et génération de réponses basées sur les données récupérées **Important** Les barrières de protection ne sont appliquées qu’à l’entrée et qu’à la réponse générée par le LLM. Elles ne sont pas appliqués aux références récupérées des bases de connaissances lors de l’exécution. Une fois votre base de données configurée, vous pouvez l’interroger et générer des réponses basées sur les fragments récupérés de vos données sources à l’aide de l’opération d’API [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html). Les réponses sont renvoyées avec des citations des données sources d’origine. Vous pouvez également [utiliser un modèle de reclassement](rerank.md) au lieu du modèle de classement de bases de données Amazon Bedrock par défaut pour classer les fragments de source en fonction de leur pertinence lors de leur récupération. **Limitations liées au contenu multimodal** `RetrieveAndGenerate`n'offre qu'un support limité pour le contenu multimodal. Lorsque vous utilisez Nova Multimodal Embeddings, la fonctionnalité RAG est limitée au contenu textuel uniquement. Pour une prise en charge multimodale complète, y compris le traitement audio et vidéo, utilisez BDA avec des modèles d'intégration de texte. Pour en savoir plus, consultez [Création d'une base de connaissances pour le contenu multimodal](kb-multimodal.md). **Note** Les images renvoyées par la réponse `Retrieve` pendant le flux `RetrieveAndGenerate` sont incluses dans l’invite de génération de réponse. La réponse `RetrieveAndGenerate` ne peut pas inclure d’images, mais peut citer les sources qui en contiennent. Pour découvrir comment interroger une base de connaissances, cliquez sur l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour tester votre base de connaissances** 1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. Dans le volet de navigation de gauche, sélectionnez **Bases de connaissances**. 1. Dans la section **Bases de connaissances**, effectuez l’une des actions suivantes : + Cliquez sur la case d’option en regard de la base de connaissances que vous souhaitez tester, puis sélectionnez **Tester la base de connaissances**. Une fenêtre de test s’ouvre sur la droite. + Choisissez la base de connaissances que vous souhaitez tester. Une fenêtre de test s’ouvre sur la droite. 1. Pour générer des réponses basées sur les informations extraites de votre base de connaissances, activez **Générer des réponses pour votre requête**. Amazon Bedrock génère des réponses en fonction de vos sources de données et cite les informations fournies dans des notes de bas de page. 1. Pour choisir un modèle à utiliser pour la génération de réponses, choisissez **Sélectionner le modèle**. Sélectionnez ensuite **Appliquer**. 1. (Facultatif) Sélectionnez l’icône de configuration (![\[Three horizontal sliders with adjustable circular controls for settings or parameters.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/configurations.png)) pour ouvrir **Configurations**. Pour en savoir plus sur la configuration, consultez [Configuration et personnalisation de la génération de requêtes et de réponses](kb-test-config.md). 1. Entrez une requête dans la zone de texte de la fenêtre de chat et sélectionnez **Exécuter** pour renvoyer les réponses de la base de connaissances. 1. Sélectionnez une note de bas de page pour consulter un extrait de la source citée pour cette partie de la réponse. Cliquez sur le lien pour accéder à l’objet S3 contenant le fichier. 1. Pour consulter les informations des fragments renvoyés, sélectionnez **Afficher les détails de la source**. + Pour voir les configurations que vous avez définies pour la requête, développez **Configurations des requêtes**. + Pour afficher les détails d’un fragment source, développez-le en cliquant sur la flèche droite (![\[Play button icon with a triangular shape pointing to the right.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/caret-right-filled.png)) près de celui-ci. Vous pouvez consulter les informations suivantes : + Le texte brut issu du bloc source. Pour copier ce texte, cliquez sur l’icône de copie (![\[Icon representing a crop or resize function, with two overlapping rectangles.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/copy.png)). Si vous avez utilisé Amazon S3 pour stocker vos données, cliquez sur l’icône de lien externe (![\[Icon of a square with an arrow pointing outward from its top-right corner.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/external.png)) pour accéder à l’objet S3 contenant le fichier. + Les métadonnées associées au fragment source, si vous avez utilisé Amazon S3 pour stocker vos données. Les attribute/field clés et les valeurs sont définies dans le `.metadata.json` fichier associé au document source. Pour plus d’informations, consultez la section **Métadonnées et filtrage** dans [Configuration et personnalisation de la génération de requêtes et de réponses](kb-test-config.md). **Options de chat** + Pour choisir un modèle à utiliser pour la génération de réponses, choisissez **Changer de modèle**. Si vous changez de modèle, le texte de la fenêtre de chat s’efface complètement. + Passez à la récupération directe des fragments source en désactivant la case **Générer des réponses**. Si vous modifiez ce paramètre, le texte de la fenêtre de chat s’efface complètement. + Pour effacer la fenêtre de discussion, sélectionnez l'icône en forme de balai (![\[Magnifying glass icon with a checkmark inside, symbolizing search or inspection.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/broom.png)). + Pour copier tous les résultats dans la fenêtre de discussion, sélectionnez l'icône de copie (![\[Icon representing a crop or resize function, with two overlapping rectangles.\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/images/icons/copy.png)). ------ #### [ API ] Pour interroger une base de connaissances et utiliser un modèle de fondation afin de générer des réponses basées sur les résultats des sources de données, envoyez une demande [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) avec un [point de terminaison d’exécution des agents Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). L’API [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateStream.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateStream.html) renvoie les données dans un format de streaming et vous permet d’accéder aux réponses générées par fragments sans attendre le résultat complet. Les champs suivants sont obligatoires : **Note** La réponse de l’API contient des événements de citation. Ce membre `citation` est devenu obsolète. Nous vous recommandons d’utiliser les champs `generatedResponse` et `retrievedReferences` à la place. Pour obtenir de la documentation de référence, consultez [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CitationEvent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CitationEvent.html). **** | Champ | Description de base | | --- | --- | | input | Contient un champ text permettant de spécifier la requête. | | retrieveAndGenerateConfiguration | Contient un [RetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateConfiguration.html), qui spécifie les configurations pour la récupération et la génération. Voir ci-dessous pour plus d’informations. | Les champs suivants sont facultatifs : **** | Champ | Cas d’utilisation | | --- | --- | | sessionId | Utilisez la même valeur que lors d’une session précédente pour continuer cette session et conserver le contexte du modèle à partir de celle-ci. | | sessionConfiguration | Pour inclure une clé KMS personnalisée pour le chiffrement de la session. | Incluez le `knowledgeBaseConfiguration` champ dans le [RetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateConfiguration.html). Ce champ correspond à un [KnowledgeBaseRetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrieveAndGenerateConfiguration.html)objet qui contient les champs suivants : + Les champs suivants sont obligatoires : **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/kb-test-retrieve-generate.html) + Les champs suivants sont facultatifs : **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/kb-test-retrieve-generate.html) Vous pouvez utiliser un modèle de reclassement par rapport au modèle de classement par défaut des bases de connaissances Amazon Bedrock en incluant le `rerankingConfiguration` champ dans le [KnowledgeBaseVectorSearchConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseVectorSearchConfiguration.html). [KnowledgeBaseRetrievalConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html) Le `rerankingConfiguration` champ correspond à un [VectorSearchRerankingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_VectorSearchRerankingConfiguration.html)objet, dans lequel vous pouvez spécifier le modèle de reclassement à utiliser, les champs de demande supplémentaires à inclure, les attributs de métadonnées pour filtrer les documents lors du reclassement et le nombre de résultats à renvoyer après le reclassement. Pour de plus amples informations, veuillez consulter [VectorSearchRerankingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_VectorSearchRerankingConfiguration.html). **Note** Si la `numberOfRerankedResults` valeur que vous spécifiez est supérieure à celle du [KnowledgeBaseVectorSearchConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseVectorSearchConfiguration.html), le nombre maximum de résultats qui seront renvoyés est la valeur pour`numberOfResults`. `numberOfResults` Il existe une exception si vous utilisez la décomposition des requêtes (pour plus d’informations, consultez la section **Modifications des requêtes** dans [Configuration et personnalisation de la génération de requêtes et de réponses](kb-test-config.md). Si vous utilisez la décomposition des requêtes, `numberOfRerankedResults` peut être jusqu’à cinq fois supérieur à `numberOfResults`. La réponse renvoie la réponse générée dans le champ `output` et les fragments source cités sous forme de tableau dans le champ `citations`. Chaque objet [Citation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Citation.html) contient les champs suivants. **** | Champ | Description de base | | --- | --- | | generatedResponsePart | Dans le champ textResponsePart, le text auquel se rapporte la citation est inclus. Le champ span fournit les index de début et de fin de la partie de la sortie contenant une citation. | | retrievedReferences | Tableau d'[RetrievedReference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievedReference.html)objets, chacun contenant le fragment content d'une source metadata associé au document, ainsi que l'URI ou l'URL location du document dans la source de données. Si le contenu est une image, l’URI de données du contenu codé en Base64 est renvoyé au format data:image/jpeg;base64,\$1\$1base64-encoded string\$1. | La réponse renvoie également une valeur `sessionId` que vous pouvez réutiliser dans une autre demande pour maintenir la même conversation. Si vous avez inclus `guardrailConfiguration` dans la demande, le champ `guardrailAction` vous indique si le contenu a été bloqué ou non. Si les données récupérées contiennent des images, la réponse renvoie également les en-têtes de réponse suivants, qui contiennent les métadonnées des blocs source renvoyés dans la réponse : + `x-amz-bedrock-kb-byte-content-source` : contient l’URI d’Amazon S3 de l’image. + `x-amz-bedrock-kb-description` : contient la chaîne encodée en Base64 pour l’image. **Note** Vous ne pouvez pas filtrer sur ces en-têtes de réponse de métadonnées lorsque vous [configurez des filtres de métadonnées](kb-test-config.md). ------ **Note** Si vous recevez un message d’erreur indiquant que l’invite dépasse la limite de caractères lors de la génération des réponses, vous pouvez raccourcir l’invite comme suit : Réduisez le nombre maximum de résultats récupérés (cela raccourcit ce qui est rempli dans l’espace réservé \$1search\$1results\$1 dans [Modèles d’invite de base de connaissances : orchestration et génération](kb-test-config.md#kb-test-config-prompt-template)). Recréez la source de données à l’aide d’une stratégie de découpage qui utilise des blocs plus petits (cela raccourcit ce qui est rempli dans l’espace réservé \$1search\$1results\$1 dans [Modèles d’invite de base de connaissances : orchestration et génération](kb-test-config.md#kb-test-config-prompt-template)). Raccourcissez le modèle d’invite. Raccourcissez la requête utilisateur (cela raccourcit ce qui est rempli dans l’espace réservé \$1query\$1 dans [Modèles d’invite de base de connaissances : orchestration et génération](kb-test-config.md#kb-test-config-prompt-template)).