Metas do Amazon Bedrock AgentCore Runtime

Você pode adicionar um agente Amazon Bedrock AgentCore Runtime como destino do gateway. O gateway envia tráfego diretamente para o agente de tempo de execução sem agregação ou tradução de protocolo. Ao contrário dos alvos MCP que combinam recursos de ferramentas em um servidor MCP virtual unificado, o destino AgentCore Runtime encaminha solicitações e respostas entre clientes e o agente de tempo de execução sem modificação.

Adicionar um destino AgentCore de tempo de execução ao seu gateway é útil quando você deseja:

Principais considerações e limitações

Ao trabalhar com metas AgentCore de tempo de execução, esteja ciente das seguintes considerações:

Configurações de destino

Ao criar um destino AgentCore de tempo de execução, você fornece o ARN do tempo de execução e um qualificador opcional. O gateway resolve o endpoint de tempo de execução internamente, então você não precisa criar o URL de tempo de execução sozinho.

A configuração de destino para um alvo AgentCore Runtime usa a seguinte estrutura:

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

Invocando um alvo de AgentCore tempo de execução

Para invocar um destino AgentCore de tempo de execução por meio do gateway, envie uma solicitação POST para a URL de invocação do destino. O formato do URL é:

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

{gatewayId}Substitua pelo ID do gateway, pela AWS região e {targetName} pelo nome do destino. {region}

O exemplo a seguir usa curl para invocar um destino de AgentCore tempo de execução:

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

Você também pode usar o Amazon Bedrock AgentCore SDK com uma substituição de URL de endpoint:

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

Autorização de saída

AgentCore Os destinos de tempo de execução oferecem suporte aos seguintes tipos de autorização de saída:

Impondo o tráfego por meio do gateway

Você pode usar um AgentCore gateway em seu AgentCore Runtime para que o gateway se torne o único ponto de entrada controlado para o tempo de execução, oferecendo autorização baseada em políticas, Amazon Bedrock Guardrails, interceptores de solicitações e respostas e observabilidade unificada, tudo aplicado fora do próprio ambiente do agente. Para obter a justificativa completa, consulte Enfrente seu tempo de execução com um AgentCore gateway. Mas isso só é útil se você não puder ignorar o gateway e acessar o tempo de execução diretamente. Agora você pode fazer isso independentemente de o tempo de execução usar a autorização de entrada IAM (SigV4) ou OAuth (JWT).

Você configura essa restrição no tempo de execução. O gateway marca a origem de cada solicitação que encaminha, e o tempo de execução valida essa fonte na entrada. O mecanismo específico depende do tipo de autorização de entrada do tempo de execução:

Comparação de capacidade com alvos de MCP

Você pode integrar servidores MCP ao AgentCore gateway Amazon Bedrock usando duas abordagens: usando o tipo de alvo MCP no modo de agregação ou usando o AgentCore tipo de destino Runtime. A tabela a seguir compara os recursos de cada abordagem.