Von Amazon Bedrock verwaltete Wissensdatenbanken als Konnektorziel

Amazon Bedrock Managed Knowledge Bases bietet vollständig verwaltete Retrieval-Augmented Generation (RAG): Amazon Bedrock kümmert sich um die Vektorspeicherung, Datenaufnahme und Abrufoptimierung, sodass Sie keine Abrufinfrastruktur bereitstellen oder betreiben müssen. Amazon Bedrock AgentCore stellt eine verwaltete Wissensdatenbank als systemeigenen Gateway-Konnektor zur Verfügung — Sie hängen sie an Ihr AgentCore Gateway an und Ihre Agenten finden und fragen sie mit standardmäßigen Model Context Protocol (MCP) -Aufrufen ab, ohne dass eine benutzerdefinierte Abrufintegration erstellt werden muss. Einzelheiten zum Erstellen und Verwalten einer verwalteten Wissensdatenbank finden Sie unter Wissensdatenbanken für Amazon Bedrock im Amazon Bedrock-Benutzerhandbuch.

Der Konnektor stellt zwei Tools zur Verfügung. Der erste istAgenticRetrieveStream. Anstatt eine einzelne Suche durchzuführen, plant es eine Abrufstrategie, führt mehrere Abfrageschritte in Ihren verwalteten Wissensdatenbanken durch, erweitert optional auf vollständige Dokumente und streamt sowohl die unterstützenden Ergebnisse als auch eine zusammengefasste, zitiergestützte Antwort zurück. Retrieveführt eine einzige Hybridsuche durch und gibt die relevantesten Passagen zurück.

In den folgenden Abschnitten werden die Funktionsweise des Konnektors, der Agentenabruf im Detail, allgemeine Anwendungsfälle, die Einrichtung eines Ziels sowie die Eingabe- und Antwortschemas für beide Tools beschrieben.

Funktionsweise

Amazon Bedrock AgentCore bietet einen integrierten Konnektor zu Amazon Bedrock Managed Knowledge Bases. Das Gateway kümmert sich um die Schemaverwaltung, die Endpunktauflösung und die Serviceauthentifizierung. Der Connector stellt zwei Tools zur Verfügung, die Ihr Agent mit folgenden Tools erkennt: tools/list

Ein einziger Retrieve Aufruf folgt diesem Ablauf:

Informationen zum Agentenabruf finden Sie unter Agentenabruf.

Agentenabruf

AgenticRetrieveStreambehandelt eine Frage als eine Aufgabe: Statt einer einzigen Hybridsuche, die für eine Abfrage Retrieve ausgeführt wird, plant es eine Abrufstrategie, führt mehrere Abfrageschritte in Ihren verwalteten Wissensdatenbanken durch und streamt die unterstützenden Ergebnisse und eine zusammengefasste, zitiergestützte Antwort zurück — alles in einem Tool-Call. Die synthetisierte Antwort wird standardmäßig zurückgegeben; diese Einstellung ist so eingestelltgenerateResponse, dass nur Ergebnisse zurückgegeben werden. false

Ihr Agent ruft es mit einer Konversation auf ()messages. Die von ihm abgefragten Retriever — die jeweils auf eine verwaltete Wissensdatenbank verweisen — werden vom Administrator auf dem Ziel konfiguriert und nicht vom Agenten bereitgestellt. Der Planungs- und Abruffortschritt wird über MCP übertragennotifications/message, und die Ergebnisse und die Antwort werden im Tool-Ergebnis zurückgegeben.

Weitere Informationen zur Funktionsweise von Agency Retrieval finden Sie in den Wissensdatenbanken für Amazon Bedrock im Amazon Bedrock-Benutzerhandbuch.

Das Anfrage- und Ereignisschema finden Sie unter AgenticRetrieveStream Eingabeschema und Antwortformat. AgenticRetrieveStream

Anwendungsfälle

Richten Sie eine verwaltete Wissensdatenbank ein

Anweisungen zum Erstellen eines Gateway-Ziels mit der Connectorkonfiguration von Amazon Bedrock Managed Knowledge Bases, einschließlich Einrichtungsbeispielen mit dem Python-SDK und der CLI, finden Sie unter Eine verwaltete Wissensdatenbank einrichten im Leitfaden zur Zielkonfiguration.

Konfigurieren Sie die Gateway-Servicerolle

Das Gateway benötigt eine Servicerolle, die es dem AgentCore Dienst ermöglicht, in Ihrem Namen Abrufaktionen in der verwalteten Wissensdatenbank durchzuführen. Informationen zu den erforderlichen IAM-Berechtigungen und der Richtlinienkonfiguration finden Sie unter Configure the Gateway Service Role im Leitfaden zur Zielkonfiguration.

Rufen Sie die Tools auf

Nachdem Sie das Ziel erstellt haben, erkennt Ihr Agent die Tools mit tools/list und ruft sie mit auf. tools/call Jedem Toolnamen wird der Zielname vorangestellt, und zwar in der Form <target-name>_<tool-name>_AgenticRetrieveStream odermanaged-kb___Retrieve).

Denn AgenticRetrieveStream Ihr Agent leitet nur die Konversation weiter. Die Retriever werden vom Administrator auf dem Ziel konfiguriert, sodass der Agent keine Knowledge-Base-IDs sendet:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___AgenticRetrieveStream",
    "arguments": {
      "messages": [
        { "role": "user", "content": { "text": "How do I configure a knowledge base target?" } }
      ]
    }
  }
}

Denn Retrieve die verwaltete Wissensdatenbank-ID ist an das Ziel gebunden, sodass Ihr Agent nur die Abfrage weiterleitet:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "What is Amazon Bedrock AgentCore?" }
    }
  }
}

Wenn Sie dem Agenten Abrufparameter zur Verfügung gestellt haben (siehe Steuern, welche Parameter der Agent festlegen kann), kann der Agent die vom Administrator konfigurierten Standardeinstellungen beim Anruf außer Kraft setzen:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "insurance benefits" },
      "retrievalConfiguration": {
        "managedSearchConfiguration": { "numberOfResults": 2 }
      }
    }
  }
}

AgenticRetrieveStream Eingabeschema

Das von zurückgegebene Schema tools/list ist die Gruppe von Feldern, die Ihr Agent beim Aufrufen festlegen kannAgenticRetrieveStream. Standardmäßig ist das einzige für den Agenten sichtbare Feld. messages Die abzufragenden Retriever und die gesamte Abrufkonfiguration werden vom Administrator auf dem Ziel festgelegt. Weitere Informationen finden Sie unter Eine verwaltete Wissensdatenbank einrichten. Um weitere Felder für den Agenten verfügbar zu machen, konfigurieren Sie sie parameterOverrides auf dem Ziel — siehe Steuern, welche Parameter der Agent festlegen kann.

{
  "type": "object",
  "properties": {
    "messages": {
      "description": "The messages for the agentic retrieval conversation. Contains the user query and conversation history.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "description": "The role of the message sender (user or assistant).",
            "type": "string",
            "enum": ["user", "assistant"]
          },
          "content": {
            "description": "The content of the message.",
            "type": "object",
            "properties": {
              "text": {
                "description": "The text content of the message.",
                "type": "string"
              }
            }
          }
        },
        "required": ["content", "role"]
      }
    }
  },
  "required": ["messages"]
}

Informationen zu den vom Administrator festgelegten Feldern —retrievers, agenticRetrieveConfiguration (Foundation Model, Reranking und Guardrails maxAgentIteration ThroughpolicyConfiguration) und generateResponse — finden Sie unter Eine verwaltete Wissensdatenbank einrichten und Konfigurationsreferenz.

AgenticRetrieveStream Format der Antwort

AgenticRetrieveStreamstreamt eine Abfolge von Ereignissen. Über MCP werden Trace-Ereignisse in Echtzeit übertragennotifications/message, und die Abrufergebnisse und die synthetisierte Antwort werden im Tool-Ergebnis wiedergegeben. Der Stream gibt die folgenden Ereignistypen aus:

Ein result Ereignis hat die folgende Struktur:

{
  "result": {
    "results": [
      {
        "content": {
          "text": "Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...",
          "mimeType": "text/plain"
        },
        "sourceRetriever": { "identifier": "kb-retriever-1" },
        "metadata": { "x-amz-bedrock-kb-source-uri": "s3://example-bucket/docs/overview.pdf" }
      }
    ],
    "generatedResponse": {
      "answer": "A managed knowledge base lets Amazon Bedrock AgentCore handle the vector store, ingestion, and retrieval for you.",
      "citations": [
        {
          "startIndex": 0,
          "endIndex": 98,
          "references": [ { "..." : "references to supporting results" } ]
        }
      ]
    }
  }
}

Eingabeschema abrufen

Das von zurückgegebene Schema tools/list ist die Gruppe von Feldern, die Ihr Agent beim Aufrufen festlegen kannRetrieve. Standardmäßig ist das einzige für den Agenten sichtbare Feld. retrievalQuery.text Die verwaltete Wissensdatenbank-ID und alle Abrufeinstellungen werden vom Administrator auf dem Ziel festgelegt. Um Abrufeinstellungen wie Metadaten numberOfResults oder Metadaten für den Agenten verfügbar filter zu machen, konfigurieren Sie die Konfiguration parameterOverrides auf dem Ziel. Weitere Informationen finden Sie unter Steuern, welche Parameter der Agent festlegen kann.

{
  "type": "object",
  "properties": {
    "retrievalQuery": {
      "description": "Contains the query to send the managed knowledge base.",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text of the query made to the managed knowledge base.",
          "type": "string"
        }
      }
    }
  },
  "required": ["retrievalQuery"]
}

Informationen zu den vom Administrator festgelegten und überschreibbaren Feldern — MetadatennumberOfResults, Reranking und multimodale filteroverrideSearchType Bildabfragen — finden Sie in der Konfigurationsreferenz.

Antwortformat abrufen

Das Retrieve Tool gibt ein tools/call MCP-Ergebnis zurück, das in einem JSON-RPC Umschlag verpackt ist. Die content Felder isError und befinden sich darinresult, und das text Feld enthält die serialisierte retrievalResults Nutzlast:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": false,
    "content": [
      {
        "type": "text",
        "text": "{\"retrievalResults\":[{\"content\":{\"type\":\"TEXT\",\"text\":\"Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...\"},\"location\":{\"type\":\"S3\",\"s3Location\":{\"uri\":\"s3://example-bucket/docs/overview.pdf\"}},\"score\":0.87,\"metadata\":{\"x-amz-bedrock-kb-source-uri\":\"s3://example-bucket/docs/overview.pdf\"}}]}"
      }
    ]
  }
}

Jedes Element in retrievalResults hat die folgende Struktur:

Konfigurationsreferenz

Die folgenden Felder werden vom Administrator bei parameterValues der Erstellung des Ziels festgelegt oder dem Agenten mit parameterOverrides angezeigt. Informationen darüber, wo sie eingerichtet werden können, finden Sie unter Eine verwaltete Wissensdatenbank einrichten und Steuern, welche Parameter der Agent festlegen kann.

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

Filterung der Zugriffskontrolle

Wenn Ihre verwaltete Wissensdatenbank die Zugriffskontrolle verwendet, um Ergebnisse nach Benutzern oder Gruppen zu filtern, muss die aufrufende Anwendung der Anfrage eine Zeichenfolge userContext beifügen. Das userContext Gateway leitet an die Wissensdatenbank weiter, die darauf aufbauend eine Filterung der Zugriffskontrolle anwendet. Das Gateway nutzt die Daten nicht userContext anhand der IAM-Identität des Anrufers — Ihre Anwendung muss sie explizit angeben.

Um es zu verwenden:

{
  "arguments": {
    "retrievalQuery": { "text": "insurance benefits" },
    "userContext": {
      "userId": "user@example.com"
    }
  }
}