Amazon Bedrock AgentCore Runtime-Ziele

Sie können einen Amazon Bedrock AgentCore Runtime-Agenten als Gateway-Ziel hinzufügen. Das Gateway sendet den Datenverkehr ohne Aggregation oder Protokollübersetzung direkt an den Runtime-Agenten. Im Gegensatz zu MCP-Zielen, die Toolfunktionen zu einem einheitlichen virtuellen MCP-Server kombinieren, leitet das AgentCore Runtime-Ziel Anfragen und Antworten zwischen Clients und dem Runtime-Agenten ohne Änderung weiter.

Das Hinzufügen eines AgentCore Runtime-Ziels zu Ihrem Gateway ist nützlich, wenn Sie:

Wichtigste Überlegungen und Einschränkungen

Beachten Sie bei der Arbeit mit AgentCore Runtime-Zielen die folgenden Überlegungen:

Zielkonfiguration

Wenn Sie ein AgentCore Runtime-Ziel erstellen, geben Sie den Runtime-ARN und einen optionalen Qualifier an. Das Gateway löst den Laufzeitendpunkt intern auf, sodass Sie die Laufzeit-URL nicht selbst erstellen müssen.

Die Zielkonfiguration für ein AgentCore Runtime-Ziel verwendet die folgende Struktur:

{
    "http": {
        "agentcoreRuntime": {
            "arn": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID",
            "qualifier": "DEFAULT",
            "schema": {
                "source": {
                    "s3": {
                        "uri": "s3://DOC-EXAMPLE-BUCKET/agent-schema.yaml"
                    }
                }
            }
        }
    }
}

Ein Runtime-Ziel wird aufgerufen AgentCore

Um ein AgentCore Runtime-Ziel über das Gateway aufzurufen, senden Sie eine POST-Anfrage an die Aufruf-URL des Ziels. Das URL-Format ist:

https://{gatewayId}.gateway.bedrock-agentcore.{region}.amazonaws.com/{targetName}/invocations

{gatewayId}Ersetzen Sie es durch Ihre Gateway-ID, {region} durch die AWS Region und {targetName} durch den Namen des Ziels.

Im folgenden Beispiel wird curl verwendet, um ein AgentCore Runtime-Ziel aufzurufen:

curl -X POST https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target/invocations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{"input": {"prompt": "Hello"}}'

Sie können das Amazon Bedrock AgentCore SDK auch mit einer Endpunkt-URL-Überschreibung verwenden:

aws bedrock-agentcore invoke-agent-runtime \
    --endpoint-url https://gateway-id.gateway.bedrock-agentcore.us-west-2.amazonaws.com/my-target \
    --runtimeArn arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/RUNTIME_ID

Ausgehende Autorisierung

AgentCore Runtime-Ziele unterstützen die folgenden Autorisierungstypen für ausgehende Anfragen:

Erzwingen des Datenverkehrs durch das Gateway

Sie können Ihre AgentCore Runtime mit einem AgentCore Gateway versehen, sodass das Gateway zum einzigen, kontrollierten Einstiegspunkt zur Runtime wird. So erhalten Sie richtlinienbasierte Autorisierung, Amazon Bedrock Guardrails, Request and Response Interceptors und einheitliche Beobachtbarkeit, die alle außerhalb der eigenen Umgebung des Agenten angewendet werden. Die vollständige Begründung finden Sie unter Front your Runtime with an Gateway. AgentCore Dies ist jedoch nur sinnvoll, wenn Sie das Gateway nicht umgehen und direkt auf die Runtime zugreifen können. Sie können dies jetzt unabhängig davon erreichen, ob die Runtime die eingehende IAM- (SigV4) oder OAuth- (JWT) -Autorisierung verwendet.

Sie konfigurieren diese Einschränkung für die Laufzeit. Das Gateway stempelt die Quelle jeder Anfrage, die es weiterleitet, und die Runtime validiert diese Quelle bei der Eingabe. Der spezifische Mechanismus hängt vom Typ der eingehenden Autorisierung der Runtime ab:

Vergleich der Fähigkeiten mit MCP-Zielen

Sie können MCP-Server auf zwei Arten in das Amazon Bedrock AgentCore Gateway integrieren: mit dem MCP-Zieltyp im Aggregationsmodus oder mit dem AgentCore Runtime-Zieltyp. In der folgenden Tabelle werden die Funktionen der einzelnen Ansätze verglichen.