Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Obiettivi Amazon Bedrock AgentCore Runtime

Puoi aggiungere un agente Amazon Bedrock AgentCore Runtime come destinazione del gateway. Il gateway invia il traffico direttamente all'agente di runtime senza aggregazione o traduzione del protocollo. A differenza dei target MCP che combinano le funzionalità degli strumenti in un server MCP virtuale unificato, il target AgentCore Runtime inoltra le richieste e le risposte tra i client e l'agente di runtime senza modifiche.

L'aggiunta AgentCore di un target Runtime al gateway è utile quando si desidera:

Considerazioni e limitazioni principali

Quando lavorate con i target AgentCore Runtime, tenete presente le seguenti considerazioni:

Configurazione del bersaglio

Quando si crea un target AgentCore Runtime, si forniscono l'ARN di runtime e un qualificatore opzionale. Il gateway risolve internamente l'endpoint di runtime, quindi non è necessario creare personalmente l'URL di runtime.

La configurazione di destinazione per un target AgentCore Runtime utilizza la seguente struttura:

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

Richiamo di un target Runtime AgentCore

Per richiamare un target AgentCore Runtime tramite il gateway, invia una richiesta POST all'URL di richiamo del target. Il formato dell'URL è:

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

Sostituiscilo {gatewayId} con il tuo ID del gateway, {targetName} con la AWS regione e con il nome della destinazione. {region}

L'esempio seguente usa curl per richiamare un target AgentCore Runtime:

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

Puoi anche utilizzare l'Amazon Bedrock AgentCore SDK con l'override dell'URL dell'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

Autorizzazione in uscita

AgentCore Le destinazioni di runtime supportano i seguenti tipi di autorizzazione in uscita:

Applicazione del traffico attraverso il gateway

Puoi dotare il tuo AgentCore Runtime di un AgentCore gateway in modo che il gateway diventi l'unico punto di accesso controllato al runtime, offrendoti un'autorizzazione basata su policy, Amazon Bedrock Guardrails, intercettori di richieste e risposte e osservabilità unificata, il tutto applicato all'esterno dell'ambiente dell'agente. Per una spiegazione completa, consulta Front your runtime with an Gateway. AgentCore Ma questo è utile solo se non puoi bypassare il gateway e accedere direttamente al runtime. Ora puoi farlo indipendentemente dal fatto che il runtime utilizzi l'autorizzazione in entrata IAM (SigV4) o OAuth (JWT).

È possibile configurare questa restrizione in fase di esecuzione. Il gateway contrassegna l'origine di ogni richiesta inoltrata e il runtime convalida tale origine all'ingresso. Il meccanismo specifico dipende dal tipo di autorizzazione in entrata del runtime:

Confronto delle capacità con gli obiettivi MCP

Puoi integrare i server MCP con il AgentCore gateway Amazon Bedrock utilizzando due approcci: utilizzando il tipo di destinazione MCP in modalità aggregazione o utilizzando il tipo di destinazione Runtime. AgentCore La tabella seguente confronta le funzionalità di ciascun approccio.