View a markdown version of this page

Stellen Sie über AgentCore Gateway Connect zu Ihrer Wissensdatenbank her - Amazon Bedrock
Rufen Sie mit Strands Agents auf

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 Connect 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 Konnektor stellt zwei Tools zur Verfügung:

  • AgenticRetrieveStream— ein mehrstufiger, von Streaming-Agent ausgeführter Abruf, der Ergebnisse plant, iterativ abruft und zurückstreamt, sowie optional eine synthetisierte, zitiergestützte Antwort.

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

Das Gateway fungiert als Vermittler, der sich um Authentifizierung, Parameterinjektion und Schemaunterteilung kümmert. Als Administrator binden Sie die Wissensdatenbank ein und kontrollieren, welche Parameter dem aufrufenden Agenten zugänglich gemacht werden und welche mit vorkonfigurierten Standardwerten ausgeblendet werden.

Anmerkung

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

Voraussetzungen

  • Eine verwaltete Wissensdatenbank und ihre Wissensdatenbank-ID.

  • Eine AgentCore Gateway- und eine Gateway-Servicerolle mit der Berechtigung zum Abrufen aus der Wissensdatenbank (bedrock:Retrievein der Wissensdatenbank 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, des Aufrufs 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

Rufen Sie mit Strands Agents auf

Wenn Sie bereits einen Agenten haben, der mit dem Strands Agents SDK und dem AgentCoreStarter-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 frommcp-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 Knowledge-Base-Tools automatisch erkannt tools/list und stehen dem Agenten ohne zusätzliche Konfiguration zur Verfügung.