View a markdown version of this page

配置 - 亚马逊基岩 AgentCore
拦截器输入配置在网关创建期间配置拦截器更新拦截器配置

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

配置

可以使用名为的输入参数来配置拦截器 passRequestHeaders

拦截器输入配置

配置拦截器时，您可以使用字段指定是否应将请求标头传递给拦截器函数：passRequestHeaders

通过 RequestHeaders

一个布尔值，用于确定请求标头是否包含在拦截器输入负载中。设置为时true，所有请求标头都将传递给您的拦截器 Lambda 函数。当设置为false（默认）时，不包括标题。

警告

将此设置为时要小心，true因为请求标头可能包含身份验证令牌和凭据等敏感信息。

有效载荷过滤器

对于共享http拦截器负载形状的 HTTP 目标（AgentCore 运行时和直通）和推理目标，可选过滤器将字段排除在拦截器输入负载中。Lambda 同步调用对请求和响应的总限制为 6 MB，因此排除大型响应正文可使有效负载保持在该限制之内。要排除响应正文，payloadFilter.exclude请设置为包含该RESPONSE_BODY字段的列表：

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

passRequestHeaders是必填项inputConfiguration。将其包括在旁边（例如，"passRequestHeaders": false）payloadFilter。

当排除响应正文时，响应拦截器输入负载中的body字段为null。您的函数仍然可以检查statusCodecontentType、和headers，并且可以注入标头或覆盖状态码。如果您的函数返回body: null，则网关使用原始响应正文。

在网关创建期间配置拦截器

以下示例显示如何使用已passRequestHeaders设置为的拦截器创建网关：true

例
AgentCore CLI

  1. 使用 AgentCore CLI，首先创建和部署网关，然后使用 CL AWS I 或 AWS Python 软件开发工具包 (Boto3) 配置拦截器。

    创建网关：

    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

    部署后，使用 AWS CLI update-gateway 命令或 AWS Python SDK (Boto3) 在网关上配置拦截器，如其他选项卡所示。

AWS CLI

  1. 使用以下 AWS CLI 命令创建网关，拦截器配置为传递请求标头：

    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. 将以下 Python 代码与 P AWS ython 软件开发工具包 (Boto3) 一起使用配置为传递请求标头的拦截器来创建网关：

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

更新拦截器配置

您可以使用更新网关 API 操作更新现有的网关拦截器配置，以修改passRequestHeaders设置或其他参数。