Utiliser la récupération magnétique pour interroger une base de connaissances

Agentic Retrieval utilise un modèle de base pour décomposer intelligemment les requêtes complexes en sous-requêtes, récupérer de manière itérative les informations pertinentes de vos bases de connaissances et évaluer si les résultats extraits sont suffisants pour répondre à la requête initiale. Cette approche améliore la précision de la récupération pour les questions complexes en plusieurs étapes auxquelles une seule passe de récupération risque de ne pas répondre complètement.

Par exemple, étant donné la requête « Quel magazine a été créé en premier, Arthur's Magazine ou First for Women ? » , agentic retrieval le divise en sous-requêtes distinctes telles que « Quand a été fondé Arthur's Magazine ? » et « Quand a été fondée First for Women ? » , récupère les résultats pour chacun d'entre eux et évalue si les résultats combinés sont suffisants.

Comment fonctionne la récupération magnétique

Lorsque vous envoyez une demande à l'AgenticRetrieveStreamAPI, le processus suivant se produit :

1. Planification : le modèle de base analyse votre requête et crée un plan pour la décomposer en une ou plusieurs sous-requêtes. Chaque sous-requête cible un récupérateur spécifique que vous avez configuré. Une fois les résultats de récupération collectés, le modèle de base évalue s'ils sont suffisants pour répondre à la requête initiale. Dans le cas contraire, il planifie et exécute des itérations de récupération supplémentaires, jusqu'au maximum configuré.

2. Récupération — Les sous-requêtes sont exécutées sur les récupérateurs de la base de connaissances configurés. Les résultats sont collectés à partir de chaque extraction.

3. Extension complète du document — Lorsque le modèle de base détermine que le contenu complet d'un document est nécessaire (par exemple, pour le résumé, pour vérifier l'exhaustivité ou pour accéder à des sections spécifiques), il appelle l' GetDocumentContent API pour récupérer le contenu complet du document.

4. Génération de réponses : lorsque generateResponse ce paramètre est défini sur true (valeur par défaut), le modèle de base synthétise une réponse en langage naturel à partir des résultats extraits. La réponse vous est transmise par le biais d'responseEventévénements.

5. Événement de résultat — Les résultats de récupération dédupliqués de toutes les itérations, la synthèse complète de la réponse en langage naturel et les citations vous sont renvoyés. Les événements de suivi sont diffusés tout au long du processus à des fins d'observabilité.

Conditions préalables

Avant de pouvoir utiliser la récupération agentique, vous devez disposer des éléments suivants :

• Une base de connaissances Amazon Bedrock entièrement gérée. La récupération agentique ne prend actuellement en charge que les bases de connaissances gérées.

• Accès à un modèle de base dans Amazon Bedrock à utiliser pour la planification et l'évaluation des requêtes.

• Les autorisations IAM requises. Pour de plus amples informations, veuillez consulter Autorisations requises pour la récupération par agent.

Interrogez une base de connaissances avec agentic retrieval

Pour utiliser la récupération magnétique, envoyez une demande. AgenticRetrieveStream La réponse est un flux qui inclut les résultats de récupération et les événements de suivi.

Le tableau suivant décrit les principaux champs de demande :

Champs obligatoires

Champ	Description
messages	La requête d'entrée et l'historique des conversations. Chaque message contient un content champ avec une text valeur et un role champ (userouassistant).
retrievers	Les récupérateurs de la base de connaissances à partir desquels récupérer des données. Vous pouvez spécifier jusqu'à 5 récupérateurs, chacun pointant vers une base de connaissances gérée par son identifiant. Chaque récupérateur peut éventuellement inclure des filtres de métadonnées et un nombre maximum de résultats.
agentic RetrieveConfiguration	La configuration de récupération agentic, y compris le modèle de base à utiliser pour la planification et l'évaluation des requêtes, et éventuellement un modèle de reclassement et le nombre maximal d'itérations des agents.

Champs facultatifs

Champ	Description
Configuration des politiques	Configure un garde-corps Amazon Bedrock à appliquer lors de la récupération magnétique. Spécifiez un guardrailId etguardrailVersion.
Contexte utilisateur	Fournit un contexte utilisateur pour le filtrage du contrôle d'accès.
Générer une réponse	Champ booléen qui, lorsqu'il est défini sur true (valeur par défaut), indique au modèle de base de générer une réponse en langage naturel à partir des résultats récupérés. La réponse est retransmise sous forme de blocs de texte et incluse dans l'événement de résultat.

Pour connaître la syntaxe complète des demandes et des réponses, reportez-vous AgenticRetrieveStreamà la référence de l'API.

Réponse de récupération agentique

La AgenticRetrieveStream réponse est un flux contenant les types d'événements suivants :

• Événement de résultat (AgenticRetrieveResultEvent) : événement final délivré une fois le traitement terminé. Contient les résultats de l'extraction et, lorsque la génération de réponse est activée, la réponse générée. L'événement qui en résulte inclut :

  • Résultats de récupération (results) — Les fragments source récupérés au cours de toutes les itérations. Chaque résultat inclut le contenu, l'identifiant du récupérateur de source et des métadonnées facultatives. Lorsque le même fragment est récupéré par plusieurs sous-requêtes, il n'apparaît qu'une seule fois dans les résultats finaux.

  • Réponse générée (generatedResponse) — Lorsque generateResponse ce paramètre est défini sur true (valeur par défaut), l'événement de résultat inclut un generatedResponse objet contenant :

    • answer— Le texte de réponse complet synthétisé en langage naturel.

    • citations— Une liste facultative qui fait correspondre la durée de la réponse aux résultats de récupération à l'appui. Chaque citation contient :

      • startIndex— Le décalage de caractères à l'endroit où le passage cité commence dans la answer chaîne.

      • endIndex— Le décalage de caractères à la fin du passage cité (exclusif, le texte cité s'étend du startIndex haut vers mais sans inclureendIndex).

      • references— Une liste dans laquelle chaque référence comporte un resultIndex champ indexé dans le results tableau sur le même événement de résultat, indiquant quel résultat de récupération prend en charge la plage citée.

• Evénements de réponse (AgenticRetrieveResponseEvent) : lorsque generateResponse ce paramètre est défini sur true (valeur par défaut), les responseEvent événements sont diffusés en continu lors de la génération des réponses. Chaque événement contient un text champ contenant une partie incrémentielle de la réponse synthétisée en langage naturel.

• Suivi des événements (AgenticRetrieveTraceEvent) : événements diffusés en continu pendant le processus de récupération agentique qui fournissent une visibilité sur chaque étape. Voici les types d'événements de suivi :

  • Planification : indique que le modèle de base analyse la requête et crée des sous-requêtes. Comprend les actions planifiées et les récupérateurs de cibles.

  • Récupération — Indique qu'une extraction est en cours d'exécution dans une base de connaissances. Inclut l'entrée et la sortie de récupération, ainsi que les éventuels avertissements ou défaillances.

  • Récupération spéculative : extraction initiale exécutée avant la première étape de planification afin de réduire le temps de latence. Pour une base de connaissances unique, cela permet de récupérer les résultats à l'aide de la requête utilisateur brute. Pour plusieurs bases de connaissances, cela permet d'effectuer une recherche approfondie pour aider à acheminer les requêtes vers les récupérateurs appropriés.

  • Extension complète du document : indique que l'agent est en train de récupérer le contenu complet d'un document spécifique. Inclut l'ID du document, l'extracteur de la source et son statut (InProgressSuccès ou échec).

Autorisations requises pour la récupération par agent

Pour utiliser l'AgenticRetrieveStreamAPI, l'identité IAM appelante doit disposer des autorisations suivantes :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock:AgenticRetrieveStream",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock:Retrieve",
                "bedrock:GetDocumentContent"
            ],
            "Resource": "arn:aws:bedrock:region:account-id:knowledge-base/*"
        },
        {
            "Effect": "Allow",
            "Action": "bedrock:InvokeModelWithResponseStream",
            "Resource": "*"
        }
    ]
}

Si vous utilisez des glissières de sécurité avec récupération magnétique, ajoutez les autorisations suivantes :

{
    "Effect": "Allow",
    "Action": [
        "bedrock:GetGuardrail",
        "bedrock:ApplyGuardrail"
    ],
    "Resource": "*"
}

Considérations

Gardez les points suivants à l'esprit lorsque vous utilisez la récupération par agent :

• Agentic Retrieval prend uniquement en charge les bases de connaissances Amazon Bedrock gérées.

• Pour les quotas de récupérateurs par demande, les résultats par appel de récupération et le nombre maximal d'itérations d'agents, voir. Quotas de service pour les bases de connaissances gérées

• La réduction du nombre maximal d'itérations peut entraîner l'arrêt anticipé de l'agent, ce qui peut réduire la précision des requêtes complexes.

• Lors de la configuration des garde-corps, seule l'BLOCKaction est prise en charge. L'MASKaction n'est pas prise en charge par la récupération magnétique.

• Le client fournit et possède le modèle de base, le modèle d'intégration et le modèle de reclassement utilisés lors de la récupération agentique, s'ils sont fournis. Vos informations d'identification IAM sont utilisées pour appeler ces modèles.