Interrogez une base de connaissances et récupérez des données - Amazon Bedrock

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.

Interrogez une base de connaissances et récupérez des données

Une fois votre base de connaissances configurée, vous pouvez l'interroger et récupérer des fragments de vos données source qui sont pertinents pour la requête à l'aide du RetrieveAPIopération. Vous pouvez également utiliser un modèle de reclassement au lieu du classement par défaut des bases de connaissances Amazon Bedrock pour classer les fragments de source en fonction de leur pertinence lors de leur extraction.

Pour savoir comment interroger votre base de connaissances, choisissez l'onglet correspondant à votre méthode préférée, puis suivez les étapes suivantes :

Console
Pour tester votre base de connaissances

  1. Connectez-vous à l' AWS Management Console aide d'un IAMrôle avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse. https://console.aws.amazon.com/bedrock/

  2. Dans le volet de navigation de gauche, sélectionnez Knowledge bases.

  3. 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'étend à partir de la droite.

    • Choisissez la base de connaissances que vous souhaitez tester. Une fenêtre de test s'étend à partir de la droite.

  4. Dans la fenêtre de test, décochez Générer des réponses pour votre requête afin de renvoyer des informations extraites directement de votre base de connaissances.

  5. (Facultatif) Sélectionnez l'icône de configuration ( ) pour ouvrir Configurations. Vous pouvez modifier les configurations suivantes :

    • Type de recherche — Spécifiez la manière dont votre base de connaissances est interrogée. Pour de plus amples informations, veuillez consulter Type de recherche.

    • Nombre maximum de résultats extraits — Spécifiez le nombre maximum de résultats à récupérer. Pour de plus amples informations, veuillez consulter Nombre maximum de résultats récupérés.

    • Filtres — Spécifiez jusqu'à 5 groupes de filtres et jusqu'à 5 filtres au sein de chaque groupe à utiliser avec les métadonnées de vos fichiers. Pour de plus amples informations, veuillez consulter Filtrage manuel des métadonnées.

  6. 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.

  7. Les segments source sont renvoyés directement par ordre de pertinence. Les images extraites de votre source de données peuvent également être renvoyées sous forme de bloc source.

  8. Pour voir les détails 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 les configurations de requête.

    • Pour afficher les détails d'un fragment source, développez-le en cliquant sur la flèche droite ( ) à côté 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 ( ). Si vous avez utilisé Amazon S3 pour stocker vos données, cliquez sur l'icône de lien externe ( ) pour accéder à l'objet S3 contenant le fichier.

      • Les métadonnées associées au bloc source, si vous avez utilisé Amazon S3 pour stocker vos données. Les clés et les valeurs des attributs/champs sont définies dans le .metadata.json fichier associé au document source. Pour plus d'informations, consultez la section Métadonnées et filtrage dansConfiguration et personnalisation des requêtes et de la génération de réponses.

Options de chat

  • Passez à la génération de réponses en fonction des fragments source récupérés en activant l'option 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 ( ).

  • Pour copier tous les résultats dans la fenêtre de discussion, sélectionnez l'icône de copie ( ).

API

Pour interroger une base de connaissances et ne renvoyer que le texte pertinent provenant de sources de données, envoyez un Retrievedemande auprès d'un point de terminaison Agents for Amazon Bedrock.

Les champs suivants sont obligatoires :

Champ Description de base
knowledgeBaseId Pour spécifier la base de connaissances à interroger.
retrievalQuery Contient un text champ permettant de spécifier la requête.
guardrailsConfiguration Incluez guardrailsConfiguration des champs tels que guardrailsId et guardrailsVersion pour utiliser votre garde-corps dans la demande

Les champs suivants sont facultatifs :

Champ Cas d’utilisation
nextToken Pour renvoyer le prochain lot de réponses (voir les champs de réponse ci-dessous).
retrievalConfiguration Pour inclure des configurations de requête afin de personnaliser la recherche vectorielle. Pour plus d’informations, consultez KnowledgeBaseVectorSearchConfiguration.

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 Le rerankingConfiguration champ correspond à un VectorSearchRerankingConfigurationobjet, 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.

Note

Si la numberOfRerankedResults valeur que vous spécifiez est supérieure à celle du KnowledgeBaseVectorSearchConfiguration, le nombre maximum de résultats renvoyés est la valeur pournumberOfResults. 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 dansConfiguration et personnalisation des requêtes et de la génération de réponses. Si vous utilisez la décomposition des requêtes, elle numberOfRerankedResults peut être jusqu'à cinq fois supérieure ànumberOfResults.

La réponse renvoie les fragments de la source de données sous la forme d'un tableau d'KnowledgeBaseRetrievalResultobjets dans le retrievalResults champ. Chacun KnowledgeBaseRetrievalResultcontient les champs suivants :

Champ Description
content Contient un fragment de source de texte dans le champ text ou un fragment de source d'image dans le byteContent champ. Si le contenu est une image, les données URI du contenu codé en base64 sont renvoyées au format suivant :. data:image/jpeg;base64,${base64-encoded string}
métadonnées Contient chaque attribut de métadonnées sous forme de clé et la valeur de métadonnées sous forme de JSON valeur à laquelle la clé correspond.
location Contient le URI ou URL du document auquel appartient le bloc source.
score Le score de pertinence du document. Vous pouvez utiliser ce score pour analyser le classement des résultats.

Si le nombre de segments source dépasse ce que peut contenir la réponse, une valeur est renvoyée dans le nextToken champ. Utilisez cette valeur dans une autre demande pour renvoyer le prochain lot de résultats.

Si les données extraites contiennent des images, la réponse renvoie également les en-têtes de réponse suivants, qui contiennent les métadonnées des segments source renvoyés dans la réponse :

  • x-amz-bedrock-kb-byte-content-source— Contient l'Amazon S3 URI de l'image.

  • x-amz-bedrock-kb-description— Contient la chaîne codée en base64 pour l'image.

Note

Vous ne pouvez pas filtrer sur ces en-têtes de réponse aux métadonnées lorsque vous configurez des filtres de métadonnées.

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 de la manière suivante :