View a markdown version of this page

Configuration - Base rocheuse de l'Amazonie AgentCore
Configuration des entrées de l'intercepteurConfiguration des intercepteurs lors de la création de la passerelleMise à jour des configurations des intercepteurs

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.

Configuration

Les intercepteurs peuvent être configurés avec un paramètre d'entrée appelé passRequestHeaders

Configuration des entrées de l'intercepteur

Lors de la configuration des intercepteurs, vous pouvez spécifier si les en-têtes de demande doivent être transmis à la fonction d'interception à l'aide du champ : passRequestHeaders

passer RequestHeaders

Valeur booléenne qui détermine si les en-têtes de demande sont inclus dans la charge utile d'entrée de l'intercepteur. Lorsque ce paramètre est défini surtrue, tous les en-têtes de demande seront transmis à la fonction Lambda de votre intercepteur. Lorsqu'il est défini sur false (par défaut), les en-têtes ne sont pas inclus.

Avertissement

Soyez prudent lorsque vous définissez ce paramètre sur, true car les en-têtes de demande peuvent contenir des informations sensibles telles que des jetons d'authentification et des informations d'identification.

Filtre de charge utile

Pour les cibles HTTP (AgentCore Runtime et passthrough) et les cibles d'inférence, qui partagent la forme de la charge utile de l'httpintercepteur, un filtre facultatif exclut les champs de la charge utile d'entrée de l'intercepteur. L'invocation synchrone Lambda a une limite de 6 Mo pour la combinaison de la demande et de la réponse. L'exclusion d'un corps de réponse volumineux permet de maintenir la charge utile dans cette limite. Pour exclure le corps de la réponse, définissez payloadFilter.exclude une liste contenant le RESPONSE_BODY champ :

{
  "inputConfiguration": {
    "passRequestHeaders": false,
    "payloadFilter": {
      "exclude": [{ "field": "RESPONSE_BODY" }]
    }
  }
}
Note

passRequestHeadersest obligatoire dansinputConfiguration. Incluez-le (par exemple"passRequestHeaders": false) à côtépayloadFilter.

Lorsque le corps de réponse est exclu, le body champ de la charge utile d'entrée de l'intercepteur de réponse est. null Votre fonction peut toujours inspecter lesstatusCode, et contentTypeheaders, et peut injecter des en-têtes ou remplacer le code d'état. Si votre fonction revientbody: null, la passerelle utilise le corps de réponse d'origine.

Configuration des intercepteurs lors de la création de la passerelle

Les exemples suivants montrent comment créer une passerelle avec des intercepteurs passRequestHeaders définis sur : true

Exemple
AgentCore CLI

  1. À l'aide de la AgentCore CLI, créez et déployez d'abord la passerelle, puis configurez les intercepteurs à l'aide de la AWS CLI ou du SDK AWS Python (Boto3).

    Créez la passerelle :

    agentcore add gateway \
  --name my-gateway-with-headers \
  --authorizer-type CUSTOM_JWT \
  --discovery-url "https://cognito-idp.us-west-2.amazonaws.com/some-user-pool/.well-known/openid-configuration" \
  --allowed-audience "api.example.com"
agentcore deploy

    Après le déploiement, configurez les intercepteurs sur la passerelle à l'aide de la update-gateway commande AWS CLI ou du SDK AWS Python (Boto3), comme indiqué dans les autres onglets.

AWS CLI

  1. Utilisez la commande AWS CLI suivante pour créer une passerelle avec des intercepteurs configurés pour transmettre les en-têtes de demande :

    aws bedrock-agentcore-control create-gateway \
  --name my-gateway-with-headers \
  --role-arn arn:aws:iam::123456789012:role/my-gateway-service-role \
  --protocol-type MCP \
  --authorizer-type CUSTOM_JWT \
  --authorizer-configuration '{
    "customJWTAuthorizer": {
      "discoveryUrl": "https://cognito-idp.us-west-2.amazonaws.com/some-user-pool/.well-known/openid-configuration",
      "allowedClients": ["clientId"]
    }
  }' \
  --interceptor-configurations '[{
      "interceptor": {
          "lambda": {
            "arn":"arn:aws:lambda:us-west-2:123456789012:function:my-interceptor-lambda"
          }
      },
      "interceptionPoints": ["REQUEST", "RESPONSE"],
      "inputConfiguration": {
        "passRequestHeaders": true
      }
  }]'
AWS Python SDK (Boto3)

  1. Utilisez le code Python suivant avec le SDK AWS Python (Boto3) pour créer une passerelle avec des intercepteurs configurés pour transmettre les en-têtes de demande :

    import boto3

# Initialize the AgentCore client
client = boto3.client('bedrock-agentcore-control')

# Create a gateway
gateway = client.create_gateway(
  name="my-gateway-with-headers",
  roleArn="arn:aws:iam::123456789012:role/my-gateway-service-role",
  protocolType="MCP",
  authorizerType="CUSTOM_JWT",
  authorizerConfiguration={
      "customJWTAuthorizer": {
          "discoveryUrl": "https://cognito-idp.us-west-2.amazonaws.com/some-user-pool/.well-known/openid-configuration",
          "allowedClients": ["clientId"]
      }
  },
  interceptorConfigurations=[{
      "interceptor": {
          "lambda": {
            "arn":"arn:aws:lambda:us-west-2:123456789012:function:my-interceptor-lambda"
          }
      },
      "interceptionPoints": ["REQUEST", "RESPONSE"],
      "inputConfiguration": {
        "passRequestHeaders": True
      }
  }]
)

print(f"MCP Endpoint: {gateway['gatewayUrl']}")

Mise à jour des configurations des intercepteurs

Vous pouvez mettre à jour les configurations d'intercepteurs de passerelle existantes pour modifier le passRequestHeaders paramètre ou d'autres paramètres à l'aide des opérations de l'API de mise à jour de la passerelle.