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

亚马逊 Bedrock AgentCore 运行时目标

您可以添加亚马逊 Bedrock AgentCore 运行时代理作为网关目标。网关直接将流量发送到运行时代理，无需聚合或协议转换。与将工具功能合并到统一虚拟 MCP 服务器中的 MCP 目标不同， AgentCore 运行时目标无需修改即可在客户端和运行时代理之间转发请求和响应。

当您想执行以下操作时，向网关添加 AgentCore 运行时目标很有用：

主要注意事项和局限性

使用 AgentCore 运行时目标时，请注意以下注意事项：

目标配置

创建 AgentCore 运行时目标时，需要提供运行时 ARN 和可选限定符。网关在内部解析运行时端点，因此您无需自己构造运行时网址。

AgentCore 运行时目标的目标配置使用以下结构：

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

调用 AgentCore 运行时目标

要通过网关调用 AgentCore 运行时目标，请向目标的调用 URL 发送 POST 请求。URL 格式如下：

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

{gatewayId}替换为您的网关 ID、{region} AWS 区域和{targetName}目标名称。

以下示例使用 curl 调用 AgentCore 运行时目标：

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

您还可以使用带有终端节点 URL 覆盖的亚马逊 Bedrock AgentCore SDK：

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

出站授权

AgentCore 运行时目标支持以下出站授权类型：

强制通过网关进行流量

您可以在 AgentCore 运行时前使用 AgentCore 网关，使网关成为运行时的单一、受管控的入口点——为您提供基于策略的授权、Amazon Bedrock Guardrails、请求和响应拦截器以及统一的可观察性，所有这些都应用在代理自己的环境之外。有关完整理由，请参见使用 AgentCore 网关作为运行时前端。但是，这仅在你无法绕过网关直接访问运行时时才有用。现在，无论运行时使用 IAM (SigV4) 还是 OAuth (JWT) 入站授权，您都可以实现此目的。

您可以在运行时配置此限制。网关会标记其转发的每个请求的来源，运行时会在传入的途中验证该来源。具体机制取决于运行时的入站授权类型：

与 MCP 目标的能力比较

您可以使用两种方法将 MCP 服务器与 Amazon Bedrock AgentCore 网关集成：在聚合模式下使用 MCP 目标类型，或者使用 AgentCore 运行时目标类型。下表比较了每种方法的能力。