As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Metas do Amazon Bedrock AgentCore Runtime

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

Adicionar um alvo 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 alvo AgentCore de tempo de execução, você fornece o ARN de 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 de tempo de execução 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 alvo AgentCore de tempo de execução por meio do gateway, envie uma solicitação POST para o 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 alvo 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 As metas 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 liderar seu AgentCore tempo de execução com um AgentCore gateway para que o gateway se torne o ponto de entrada único e controlado para o tempo de execução, oferecendo autorização baseada em políticas, Amazon Bedrock Guardrails, interceptores de solicitação e resposta e observabilidade unificada, tudo aplicado fora do próprio ambiente do agente. Para obter a justificativa completa, consulte Front your runtime with an AgentCore Gateway. Mas isso só é útil se você não conseguir ignorar o gateway e acessar o tempo de execução diretamente. Agora você pode fazer isso independentemente de o tempo de execução usar autorização de entrada IAM (SigV4) ou OAuth (JWT).

Você configura essa restrição no tempo de execução. O gateway carimba a origem de cada solicitação encaminhada, 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 capacidades com metas 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 alvo Runtime. A tabela a seguir compara os recursos de cada abordagem.