Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzare il recupero agentico per eseguire query su una knowledge base

Il recupero agentico utilizza un modello di base per scomporre in modo intelligente le query complesse in sottoquery, recuperare in modo iterativo le informazioni pertinenti dalle basi di conoscenza e valutare se i risultati recuperati sono sufficienti per rispondere alla query originale. Questo approccio migliora la precisione del recupero per domande complesse in più fasi che un singolo passaggio di recupero potrebbe non rispondere completamente.

Ad esempio, alla domanda «Quale rivista è stata fondata per prima, Arthur's Magazine o First for Women?» , agentic retrieval lo suddivide in sottoquery separate, ad esempio «Quando è stata fondata Arthur's Magazine?» e «Quando è stata fondata First for Women?» , recupera i risultati per ciascuno e valuta se i risultati combinati sono sufficienti.

Come funziona l'agentic retrieval

Quando invii una richiesta all'AgenticRetrieveStreamAPI, si verifica il seguente processo:

Prerequisiti

Prima di poter utilizzare l'agentic retrieval, è necessario disporre di quanto segue:

Interroga una knowledge base con agentic retrieval

Per utilizzare l'agentic retrieval, invia una richiesta. AgenticRetrieveStream La risposta è un flusso che include i risultati del recupero e gli eventi di tracciamento.

La tabella seguente descrive i principali campi di richiesta:

Per la sintassi completa di richiesta e risposta, consulta il riferimento AgenticRetrieveStream all'API.

Risposta di recupero agentica

La AgenticRetrieveStream risposta è uno stream che contiene i seguenti tipi di eventi:

Usa la AgentCore memoria con il recupero di un agente

Puoi concedere ad Agentic Retrieval l'accesso a una risorsa Amazon Bedrock Memory. AgentCore Con l'accesso alla memoria, un recupero può continuare una sessione precedente e attingere a ciò che l'agente ha appreso in quelle precedenti. Fornisci al memoryConfiguration campo il valore memoryId di una risorsa di memoria presente nel tuo account che si trova in tale stato. ACTIVE

La memoria è opzionale. A memoryConfiguration che imposta solo a non memoryId è valido. Quando si forniscememoryConfiguration, è necessario utilizzare la risorsa di memoria in almeno uno dei due modi seguenti:

Fornisci i namespace esattamente come sono configurati nella strategia di memoria, con i segnaposto già risolti. Ad esempio, se la strategia definisce lo spazio dei nomi/strategy/{memoryStrategyId}/actor/{actorId}, fornisci il valore risolto anziché il modello. Per ulteriori informazioni su namespace, strategie e record di memoria, consulta la terminologia della memoria nella Amazon Bedrock Developer Guide. AgentCore

Quando sessionBinding è impostato, persistenceMode utilizzalo per controllare se lo scambio corrente viene riscritto nella sessione:

L'esempio seguente ripristina una sessione precedente, consente all'agente di accedere alla memoria a lungo termine di quell'attore e fa sì che lo scambio continui fino alla sessione:

{
    "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"
    }
}

Il flusso di risposta riporta l'attività della memoria. Il ripristino viene visualizzato come evento di traccia del caricamento della cronologia della sessione. I record restituiti dalla memoria a lungo termine vengono visualizzati nell'evento di traccia Retrieval con un tipo di origine pari aBedrockAgentCoreMemory, a seconda della fase in cui sono stati recuperati.

L'aspetto del recupero stesso dipende da quando avviene. Quando il modello di base sceglie di cercare nella memoria (tipico in una sessione continua), il recupero appare come un'memoryRetrieveazione sull'evento di traccia di Planning. In una nuova sessione, l'agente può invece recuperare la memoria a lungo termine durante il recupero speculativo, prima della prima fase di pianificazione, nel qual caso non esegue alcuna azione. memoryRetrieve Per ulteriori informazioni, consulta Risposta di recupero agentica.

Autorizzazioni richieste per il recupero tramite agente

Per utilizzare l'AgenticRetrieveStreamAPI, l'identità IAM chiamante deve disporre delle seguenti autorizzazioni:

{
    "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": "*"
        }
    ]
}

Se utilizzi guardrails con recupero tramite agente, aggiungi le seguenti autorizzazioni:

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

Se utilizzi una risorsa di AgentCore memoria con recupero agentico, aggiungi le seguenti autorizzazioni:

{
    "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:ListEventsè richiesto solo se impostato. sessionBinding bedrock-agentcore:RetrieveMemoryRecordsè richiesto solo quando si impostaretrievalConfigs. bedrock-agentcore:CreateEventè richiesto solo quando lo persistenceMode èDEFAULT.

Se la risorsa di memoria è crittografata con una chiave gestita dal cliente, aggiungi la seguente autorizzazione su quella chiave:

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

Considerazioni

Tieni presente quanto segue quando usi l'agentic retrieval: