View a markdown version of this page

Configuración - Base amazónica AgentCore
Configuración de entrada del interceptorConfiguración de los interceptores durante la creación de la puerta de enlaceActualización de las configuraciones de los interceptores

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración

Los interceptores se pueden configurar con un parámetro de entrada denominado passRequestHeaders

Configuración de entrada del interceptor

Al configurar los interceptores, puede especificar si los encabezados de las solicitudes deben pasarse a la función de interceptor mediante el campo: passRequestHeaders

pasar RequestHeaders

Un valor booleano que determina si los encabezados de las solicitudes se incluyen en la carga útil de entrada del interceptor. Si se establece entrue, todos los encabezados de las solicitudes se pasarán a la función Lambda del interceptor. Cuando se establece en false (predeterminado), los encabezados no se incluyen.

aviso

Tenga cuidado al configurarlo, true ya que los encabezados de las solicitudes pueden contener información confidencial, como credenciales y credenciales de autenticación.

Filtro de carga útil

Para los objetivos HTTP (AgentCore tiempo de ejecución y acceso directo) y los objetivos de inferencia, que comparten la forma de carga útil del http interceptor, un filtro opcional que excluye los campos de la carga útil de entrada del interceptor. La invocación sincrónica de Lambda tiene un límite de 6 MB para la solicitud y la respuesta combinadas, por lo que si se excluye un cuerpo de respuesta grande, la carga útil se mantiene dentro de ese límite. Para excluir el cuerpo de la respuesta, configúrelo en una lista payloadFilter.exclude que contenga el campo: RESPONSE_BODY

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

passRequestHeaderses obligatorio eninputConfiguration. Inclúyelo (por ejemplo"passRequestHeaders": false) al ladopayloadFilter.

Cuando se excluye el cuerpo de la respuesta, el body campo de la carga útil de entrada del interceptor de respuesta es. null La función aún puede inspeccionar los encabezados statusCodecontentType, yheaders, e inyectar encabezados o anular el código de estado. Si la función regresabody: null, la puerta de enlace usa el cuerpo de respuesta original.

Configuración de los interceptores durante la creación de la puerta de enlace

Los siguientes ejemplos muestran cómo crear una puerta de enlace con interceptores passRequestHeaders configurados en: true

ejemplo
AgentCore CLI

  1. Con la AgentCore CLI, primero cree e implemente la puerta de enlace y, a continuación, configure los interceptores mediante la AWS CLI o el SDK de AWS Python (Boto3).

    Cree la puerta de enlace:

    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

    Tras la implementación, configure los interceptores en la puerta de enlace mediante el update-gateway comando de la AWS CLI o el SDK de AWS Python (Boto3), como se muestra en las demás pestañas.

AWS CLI

  1. Utilice el siguiente comando de la AWS CLI para crear una puerta de enlace con interceptores configurados para pasar los encabezados de las solicitudes:

    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. Utilice el siguiente código de Python con el SDK de AWS Python (Boto3) para crear una puerta de enlace con interceptores configurados para pasar los encabezados de las solicitudes:

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

Actualización de las configuraciones de los interceptores

Puede actualizar las configuraciones existentes del interceptor de la puerta de enlace para modificar la passRequestHeaders configuración u otros parámetros mediante las operaciones de la API de actualización de la puerta de enlace.