Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Objectifs Amazon Bedrock AgentCore Runtime

Vous pouvez ajouter un agent Amazon Bedrock AgentCore Runtime en tant que cible de passerelle. La passerelle envoie le trafic directement à l'agent d'exécution sans agrégation ni traduction de protocole. Contrairement aux cibles MCP qui combinent les fonctionnalités des outils au sein d'un serveur MCP virtuel unifié, la cible AgentCore Runtime transmet les demandes et les réponses entre les clients et l'agent d'exécution sans modification.

L'ajout AgentCore d'une cible Runtime à votre passerelle est utile lorsque vous souhaitez :

Principales considérations et limites

Lorsque vous travaillez avec des cibles AgentCore Runtime, tenez compte des points suivants :

Configuration cible

Lorsque vous créez une cible AgentCore d'exécution, vous fournissez l'ARN d'exécution et un qualificatif facultatif. La passerelle résout le point de terminaison d'exécution en interne, vous n'avez donc pas besoin de créer vous-même l'URL d'exécution.

La configuration cible d'une cible AgentCore Runtime utilise la structure suivante :

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

Invocation d'une cible AgentCore d'exécution

Pour invoquer une cible AgentCore Runtime via la passerelle, envoyez une requête POST à l'URL d'invocation de la cible. Le format de l'URL est le suivant :

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

{gatewayId}Remplacez-le par l'ID de votre passerelle, {region} par la AWS région et {targetName} par le nom de la cible.

L'exemple suivant utilise curl pour invoquer une cible AgentCore Runtime :

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

Vous pouvez également utiliser le AgentCore SDK Amazon Bedrock en remplaçant l'URL du point de terminaison :

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

Autorisation sortante

AgentCore Les cibles d'exécution prennent en charge les types d'autorisation sortante suivants :

Exécution du trafic via la passerelle

Vous pouvez intégrer une AgentCore passerelle à votre AgentCore environnement d'exécution afin que celle-ci devienne le point d'entrée unique et régi du runtime, ce qui vous donne accès à une autorisation basée sur des règles, à Amazon Bedrock Guardrails, à des intercepteurs de demandes et de réponses et à une observabilité unifiée, le tout appliqué en dehors de l'environnement de l'agent. Pour en savoir plus, consultez la section Démarrez votre environnement d'exécution avec une AgentCore passerelle. Mais cela n'est utile que si vous ne pouvez pas contourner la passerelle et accéder directement au runtime. Vous pouvez désormais y parvenir, que le moteur d'exécution utilise l'autorisation entrante IAM (Sigv4) ou OAuth (JWT).

Vous configurez cette restriction sur le runtime. La passerelle marque la source de chaque requête qu'elle transmet, et le moteur d'exécution valide cette source en cours d'entrée. Le mécanisme spécifique dépend du type d'autorisation entrante du runtime :

Comparaison des capacités avec les cibles MCP

Vous pouvez intégrer des serveurs MCP à la AgentCore passerelle Amazon Bedrock en utilisant deux approches : en utilisant le type de cible MCP en mode agrégation ou en utilisant le type de cible AgentCore Runtime. Le tableau suivant compare les capacités de chaque approche.