View a markdown version of this page

Stellen Sie über AgentCore Gateway eine Verbindung zu Ihrer Wissensdatenbank her - Amazon Bedrock
Mit Strands Agents aufrufen

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.

Stellen Sie über AgentCore Gateway eine Verbindung zu Ihrer Wissensdatenbank her

AgentCore Mit Gateway können Sie Ihre von Amazon Bedrock verwaltete Wissensdatenbank mithilfe des Model Context Protocol (MCP) als Tool bereitstellen. Nachdem Sie einem Gateway ein Wissensdatenbank-Ziel hinzugefügt haben, kann jeder MCP-compatible Kunde die Wissensdatenbank als Standard-MCP-Tool abfragen. Der Connector stellt zwei Tools zur Verfügung:

  • AgenticRetrieveStream— ein mehrstufiger, agentischer Streaming-Abruf, der Ergebnisse plant, iterativ abruft und zurückstreamt, sowie eine optionale synthetisierte, zitationsgestützte Antwort.

  • Retrieve— eine einzige Suche, die die relevantesten Passagen mit Quellenangaben zurückgibt.

Das Gateway fungiert als Vermittler, der die Authentifizierung, die Parameterinjektion und die Schemaunterteilung abwickelt. Als Administrator binden Sie die Wissensdatenbank ein und kontrollieren, welche Parameter für den aufrufenden Agenten sichtbar sind und welche durch vorkonfigurierte Standardeinstellungen ausgeblendet werden.

Anmerkung

Knowledge Base-Gateway-Ziele werden nur für verwaltete Wissensdatenbanken und nur mit IAM-based ausgehender Authentifizierung (der Typ des GATEWAY_IAM_ROLE Anmeldeinformationsanbieters) unterstützt.

Voraussetzungen

  • Eine verwaltete Wissensdatenbank und ihre Wissensbank-ID.

  • Ein AgentCore Gateway und eine Gateway-Servicerolle mit der Berechtigung zum Abrufen von Daten aus der Wissensdatenbank (bedrock:Retrieveauf dem Knowledge Base-ARN).

Vollständige Anweisungen — einschließlich der Erstellung des Gateway-Ziels mit dem AWS SDK oder der AWS CLI, der Konfiguration der Gateway-Servicerolle und der Vertrauensrichtlinie, der Steuerung, welche Abrufparameter der Agent festlegen kann, dem Aufrufen der Tools und der vollständigen Eingabe- und Antwortschemas — finden Sie unter Amazon Bedrock Managed Knowledge Bases as Connector Target im Amazon Bedrock Developer Guide. AgentCore

Mit Strands Agents aufrufen

Wenn Sie bereits einen Agenten haben, der mit dem Strands Agents SDK und dem AgentCore Starter-Toolkit erstellt wurde, können Sie ihn mit Ihrem Knowledge Base-Gateway-Ziel verbinden, indem Sie den MCP-Client so einstellen, dass er die SigV4-Authentifizierung für den Gateway-Endpunkt verwendet.

Installieren Sie das Paket mcp-proxy-for-aws:

pip install mcp-proxy-for-aws

Aktualisieren Sie dann Ihren MCP-Client so, dass er auf die Gateway-URL mit IAM-Authentifizierung verweist:

from mcp_proxy_for_aws.client import aws_iam_streamablehttp_client
from strands.tools.mcp.mcp_client import MCPClient

GATEWAY_URL = "https://your-gateway-url/mcp"

def get_streamable_http_mcp_client() -> MCPClient:
    """Returns an MCP Client with SigV4 auth for AgentCore Gateway."""
    return MCPClient(lambda: aws_iam_streamablehttp_client(
        endpoint=GATEWAY_URL,
        aws_region="us-west-2",
        aws_service="bedrock-agentcore",
    ))

Die wichtigsten Änderungen gegenüber einem Standard-MCP-Client-Setup sind:

  • Ersetzen Sie streamablehttp_client aus dem mcp Paket durch aws_iam_streamablehttp_client vonmcp-proxy-for-aws.

  • Stellen Sie die endpoint auf Ihre AgentCore Gateway-URL ein.

  • Geben Sie aws_service="bedrock-agentcore" für die SigV4-Signatur an.

Sobald die Verbindung hergestellt ist, werden die Tools der Wissensdatenbank automatisch erkannt tools/list und stehen dem Agenten ohne zusätzliche Konfiguration zur Verfügung.