Amazon Bedrock AgentCore 執行期目標

您可以新增 Amazon Bedrock AgentCore 執行期代理程式做為閘道目標。閘道會將流量直接傳送至執行期代理程式，無需彙總或通訊協定轉譯。與將工具功能結合到統一虛擬 MCP 伺服器的 MCP 目標不同，AgentCore 執行期目標會在用戶端和執行期代理程式之間轉送請求和回應，而無需修改。

當您AgentCore想要：

重要考量和限制

使用 AgentCore 執行期目標時，請注意下列考量：

目標組態

當您建立 AgentCore 執行期目標時，您會提供執行期 ARN 和選用的限定詞。閘道會在內部解析執行時間端點，因此您不需要自行建構執行時間 URL。

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 執行期目標，請將 POST 請求傳送至目標的叫用 URL。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"}}'

您也可以使用 Amazon Bedrock AgentCore SDK 搭配端點 URL 覆寫：

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 Gateway 預付 AgentCore 執行期，讓閘道成為執行期的單一受管進入點 — 為您提供以政策為基礎的授權、Amazon Bedrock Guardrails、請求和回應攔截器，以及統一的可觀測性，這些都適用於代理程式自己的環境之外。如需完整理由，請參閱使用 AgentCore Gateway 開啟您的執行時間。但這只有在您無法略過閘道並直接存取執行時間時才有用。您現在可以達成此目標，無論執行時間是使用 IAM (SigV4) 還是 OAuth (JWT) 傳入授權。

您可以在執行時間上設定此限制。閘道會為轉送的每個請求的來源加上戳記，而執行時間會驗證傳入的來源。特定機制取決於執行時間的傳入授權類型：

與 MCP 目標的功能比較

您可以使用兩種方法將 MCP 伺服器與 Amazon Bedrock AgentCore 閘道整合：在彙總模式下使用 MCP 目標類型，或使用 AgentCore 執行期目標類型。下表會比較每種方法的功能。