Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Agentenbasierte Abrufe zur Abfrage einer Wissensdatenbank verwenden

Agentic Retrieval verwendet ein Basismodell, um komplexe Abfragen intelligent in Unterabfragen zu zerlegen, iterativ relevante Informationen aus Ihren Wissensdatenbanken abzurufen und zu bewerten, ob die abgerufenen Ergebnisse ausreichen, um die ursprüngliche Anfrage zu beantworten. Dieser Ansatz verbessert die Abrufgenauigkeit bei komplexen, mehrstufigen Fragen, die in einem einzelnen Abrufdurchgang möglicherweise nicht vollständig beantwortet werden.

Zum Beispiel bei der Abfrage „Welches Magazin wurde zuerst veröffentlicht, Arthur's Magazine oder First for Women?“ , agentic retrieval unterteilt dies in separate Unterabfragen wie „Wann wurde Arthur's Magazine gegründet?“ und „Wann wurde First for Women gegründet?“ , ruft die Ergebnisse für jedes Objekt ab und bewertet, ob die kombinierten Ergebnisse ausreichend sind.

So funktioniert der Agentenabruf

Wenn Sie eine Anfrage an die AgenticRetrieveStream API senden, läuft der folgende Prozess ab:

Voraussetzungen

Bevor Sie Agentic Retrieval verwenden können, müssen Sie über Folgendes verfügen:

Fragen Sie eine Wissensdatenbank mit agentischem Abruf ab

Um Agentic Retrieval zu verwenden, senden Sie eine Anfrage. AgenticRetrieveStream Die Antwort ist ein Stream, der Abrufergebnisse und Ablaufverfolgungsereignisse enthält.

In der folgenden Tabelle werden die wichtigsten Anforderungsfelder beschrieben:

Die vollständige Anfrage- und Antwortsyntax finden Sie AgenticRetrieveStream in der API-Referenz.

Antwort auf den Agentenabruf

Die AgenticRetrieveStream Antwort ist ein Stream, der die folgenden Ereignistypen enthält:

AgentCore Speicher mit agentischem Abruf verwenden

Sie können Agentic Retrieval Zugriff auf eine Amazon Bedrock Memory-Ressource gewähren. AgentCore Mit Speicherzugriff kann ein Abruf eine frühere Sitzung fortsetzen und auf dem aufbauen, was der Agent in früheren Sitzungen gelernt hat. Füllen Sie das memoryConfiguration Feld mit memoryId einer Speicherressource in Ihrem Konto aus, die sich im ACTIVE Status befindet.

Speicher ist optional. AmemoryConfiguration, das nur a festlegt, memoryId ist nicht gültig. Wenn Sie angebenmemoryConfiguration, müssen Sie die Speicherressource auf mindestens eine der beiden folgenden Arten verwenden:

Geben Sie die Namespaces genau so an, wie sie in der Speicherstrategie konfiguriert sind, wobei die Platzhalter bereits aufgelöst sind. Wenn die Strategie beispielsweise den Namespace definiert, geben Sie den aufgelösten Wert /strategy/{memoryStrategyId}/actor/{actorId} und nicht die Vorlage an. Weitere Informationen zu Namespaces, Strategien und Speicherdatensätzen finden Sie unter Speicher-Terminologie im Amazon Bedrock Developer Guide. AgentCore

Wenn gesetzt sessionBinding ist, verwenden Sie, persistenceMode um zu steuern, ob der aktuelle Austausch in die Sitzung zurückgeschrieben wird:

Das folgende Beispiel stellt eine frühere Sitzung wieder her, gewährt dem Agenten Zugriff auf das Langzeitgedächtnis dieses Akteurs und speichert den Austausch zurück in die Sitzung:

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

Der Antwortstream meldet Speicheraktivität. Die Wiederherstellung wird als Load-Trace-Ereignis für den Sitzungsverlauf angezeigt. Die Datensätze, die das Langzeitgedächtnis zurückgibt, werden im Trace-Ereignis „Abruf“ mit dem Quelltyp angezeigt, unabhängig davonBedrockAgentCoreMemory, welcher Schritt sie abgerufen hat.

Wie der Abruf selbst aussieht, hängt davon ab, wann er stattfindet. Wenn sich das Foundation-Modell dafür entscheidet, den Speicher zu durchsuchen (typischerweise bei einer fortgesetzten Sitzung), wird der Abruf als memoryRetrieve Aktion für das Planning-Trace-Ereignis angezeigt. In einer neuen Sitzung kann der Agent stattdessen während des spekulativen Abrufs vor dem ersten Planungsschritt das Langzeitgedächtnis abrufen. In diesem Fall gibt er keine Aktion aus. memoryRetrieve Weitere Informationen finden Sie unter Antwort auf den Agentenabruf.

Erforderliche Berechtigungen für den agentischen Abruf

Um die AgenticRetrieveStream API verwenden zu können, muss die aufrufende IAM-Identität über die folgenden Berechtigungen verfügen:

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

Wenn Sie Guardrails mit agentischem Abruf verwenden, fügen Sie die folgenden Berechtigungen hinzu:

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

Wenn Sie eine AgentCore Speicherressource mit agentischem Abruf verwenden, fügen Sie die folgenden Berechtigungen hinzu:

{
    "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:ListEventsist nur erforderlich, wenn Sie Folgendes festlegen. sessionBinding bedrock-agentcore:RetrieveMemoryRecordsist nur erforderlich, wenn Sie festlegenretrievalConfigs. bedrock-agentcore:CreateEventist nur erforderlich, wenn persistenceMode es istDEFAULT.

Wenn die Speicherressource mit einem vom Kunden verwalteten Schlüssel verschlüsselt ist, fügen Sie diesem Schlüssel die folgende Berechtigung hinzu:

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

Überlegungen

Beachten Sie Folgendes, wenn Sie Agentic Retrieval verwenden: