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 à l’aide de l’extraction agentique

La récupération agentique 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 récupérés sont suffisants pour répondre à la requête d'origine. Cette approche améliore la précision de récupération pour les questions complexes en plusieurs étapes auxquelles une seule passe de récupération peut 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 divise cela en sous-requêtes distinctes telles que « Quand a été fondé Arthur's Magazine ? » et « Quand a été fondée First for Women ? » , extrait les résultats pour chacun et évalue si les résultats combinés sont suffisants.

Comment fonctionne la récupération agentique

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

Conditions préalables

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

Interrogez une base de connaissances grâce à la recherche agentique

Pour utiliser la récupération agentique, 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 :

Pour la syntaxe complète de la demande et de la réponse, consultez AgenticRetrieveStream la référence de l'API.

Réponse de récupération agentique

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

Utiliser AgentCore la mémoire avec la récupération agentique

Vous pouvez autoriser Agentic Retrieval à accéder à une ressource Amazon AgentCore Bedrock Memory. Grâce à l'accès à la mémoire, une extraction peut poursuivre une session précédente et s'appuyer sur ce que l'agent a appris lors des sessions précédentes. Indiquez memoryConfiguration dans le champ le memoryId nom d'une ressource mémoire de votre compte qui est dans ACTIVE cet état.

La mémoire est optionnelle. A memoryConfiguration qui définit uniquement a n'memoryIdest pas valide. Lors de la fourniturememoryConfiguration, vous devez utiliser la ressource mémoire d'au moins l'une des deux manières suivantes :

Fournissez les espaces de noms exactement tels qu'ils sont configurés dans la stratégie de mémoire, les espaces réservés étant déjà résolus. Par exemple, si la stratégie définit l'espace de noms/strategy/{memoryStrategyId}/actor/{actorId}, fournissez la valeur résolue plutôt que le modèle. Pour plus d'informations sur les espaces de noms, les stratégies et les enregistrements de mémoire, consultez la section Terminologie de la mémoire dans le guide du AgentCore développeur Amazon Bedrock.

Quand sessionBinding est défini, utilisez-le persistenceMode pour contrôler si l'échange en cours est réécrit dans la session :

L'exemple suivant restaure une session précédente, permet à l'agent d'accéder à la mémoire à long terme de cet acteur et poursuit l'échange jusqu'à la session :

{
    "messages": [
        {
            "content": {
                "text": "What did we decide about the migration timeline?"
            },
            "role": "user"
        }
    ],
    "retrievers": [
        {
            "configuration": {
                "knowledgeBase": {
                    "knowledgeBaseId": "KB12345678"
                }
            }
        }
    ],
    "agenticRetrieveConfiguration": {
        "foundationModelType": "MANAGED",
        "rerankingModelType": "MANAGED"
    },
    "memoryConfiguration": {
        "memoryId": "projectAssistantMemory-1a2b3c4d5e",
        "sessionBinding": {
            "actorId": "user-123",
            "sessionId": "session-456"
        },
        "retrievalConfigs": [
            {
                "namespace": "/strategy/summarization-1a2b3c4d5e/actor/user-123"
            }
        ],
        "persistenceMode": "DEFAULT"
    }
}

Le flux de réponse indique l'activité de la mémoire. La restauration apparaît sous la forme d'un événement de suivi du chargement de l'historique de session. Les enregistrements renvoyés par la mémoire à long terme apparaissent dans l'événement Retrieval trace avec le type de sourceBedrockAgentCoreMemory, quelle que soit l'étape à laquelle ils ont été récupérés.

L'apparence de la récupération elle-même dépend du moment où elle se produit. Lorsque le modèle de base choisit d'effectuer une recherche dans la mémoire (généralement lors d'une session continue), la récupération apparaît sous la forme d'une memoryRetrieve action sur l'événement Planning trace. Lors d'une nouvelle session, l'agent peut à la place récupérer de la mémoire à long terme lors de la récupération spéculative, avant la première étape de planification, auquel cas il n'émet aucune action. memoryRetrieve Pour de plus amples informations, veuillez consulter Réponse de récupération agentique.

Autorisations requises pour la récupération des données d'agence

Pour utiliser l'AgenticRetrieveStreamAPI, l'identité IAM de l'appelant 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 garde-corps avec la récupération des données agentiques, ajoutez les autorisations suivantes :

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

Si vous utilisez une ressource AgentCore mémoire avec extraction agentique, ajoutez les autorisations suivantes :

{
    "Effect": "Allow",
    "Action": [
        "bedrock-agentcore:GetMemory",
        "bedrock-agentcore:ListEvents",
        "bedrock-agentcore:RetrieveMemoryRecords",
        "bedrock-agentcore:CreateEvent"
    ],
    "Resource": "arn:aws:bedrock-agentcore:region:account-id:memory/memory-id"
}

bedrock-agentcore:ListEventsn'est requis que lorsque vous définissezsessionBinding. bedrock-agentcore:RetrieveMemoryRecordsn'est requis que lorsque vous définissezretrievalConfigs. bedrock-agentcore:CreateEventn'est requis que lorsque persistenceMode c'est le casDEFAULT.

Si la ressource mémoire est chiffrée à l'aide d'une clé gérée par le client, ajoutez l'autorisation suivante à cette clé :

{
    "Effect": "Allow",
    "Action": "kms:Decrypt",
    "Resource": "arn:aws:kms:region:account-id:key/key-id"
}

Considérations

Lorsque vous utilisez la récupération agentique, gardez les points suivants à l'esprit :