Obiettivi di 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 delle destinazioni 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:

• Fornisci una gestione centralizzata degli accessi per i tuoi agenti di runtime tramite un unico endpoint gateway.

• Utilizza l'autenticazione e l'osservabilità integrate nel gateway per i tuoi agenti di runtime.

• Instrada le richieste a agenti di runtime specifici utilizzando il routing basato sul percorso quando più destinazioni sono collegate a un gateway.

• Ottimizza le prestazioni del tuo agente utilizzando l' AgentCore ottimizzazione di Amazon Bedrock per generare consigli dalle tracce degli agenti, A/B testare le modifiche con il traffico in tempo reale attraverso il gateway e implementare configurazioni vincenti. Per ulteriori informazioni, consulta ottimizzazione. AgentCore

Considerazioni e limitazioni chiave

Quando lavori con obiettivi AgentCore Runtime, tieni presente le seguenti considerazioni:

• Il gateway invia il traffico direttamente agli obiettivi di AgentCore Runtime senza funzionalità di aggregazione.

• AgentCore I target di runtime possono essere aggiunti ai gateway per i quali non è impostato un tipo di protocollo. Non possono essere aggiunti ai gateway di tipo di protocollo MCP.

• Non è disponibile alcuna sincronizzazione delle funzionalità o ricerca di strumenti semantici per gli obiettivi Runtime. AgentCore I client devono indirizzare ogni destinazione individualmente tramite un routing basato sul percorso.

• Server-Sent Lo streaming di eventi (SSE) è supportato per AgentCore gli obiettivi Runtime.

• Le funzioni Lambda degli intercettori di richieste e risposte sono supportate in modalità bufferizzata. Gli intercettori non sono ancora supportati in modalità streaming.

Configurazione del bersaglio

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

La configurazione di destinazione per un oggetto 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"
                    }
                }
            }
        }
    }
}

• arn (obbligatorio) — L'ARN dell'agente Amazon AgentCore Bedrock Runtime.

• qualifier (opzionale) — Il qualificatore di runtime. L’impostazione predefinita è DEFAULT.

• schema (opzionale) — Lo schema dell'API che descrive la struttura di richiesta e risposta del target di runtime. Il gateway utilizza questo schema per abilitare le funzionalità del motore di policy come i guardrails. Il formato dello schema viene rilevato automaticamente come OpenAPI o Smithy.

  Per gli agenti di runtime che utilizzano i protocolli MCP o A2A, uno schema predefinito viene applicato automaticamente e non è necessario fornirne uno. Per gli agenti di runtime che utilizzano il protocollo HTTP, è necessario fornire uno schema per utilizzare i guardrails.

  L'schemaoggetto contiene uno source che specifica dove si trova il contenuto dello schema:

  • s3 — Un URI S3 che punta al file di schema (ad esempio,). s3://DOC-EXAMPLE-BUCKET/agent-schema.yaml

  • inlinePayLoad — Il contenuto dello schema fornito direttamente come stringa.

Nota

Se il tuo agente di runtime utilizza il protocollo HTTP e desideri applicare i guardrail tramite il motore di policy del gateway, devi fornire uno schema. Per gli agenti di runtime che utilizzano i protocolli MCP o A2A, viene applicato automaticamente uno schema predefinito.

Richiamo di un target Runtime AgentCore

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

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

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

L'esempio seguente utilizza 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 Amazon Bedrock AgentCore SDK con un 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 Gli obiettivi di runtime supportano i seguenti tipi di autorizzazione in uscita:

• IAM (SigV4): il gateway assume il ruolo di servizio gateway per ottenere le credenziali per la firma delle richieste verso il target di runtime. Quando configuri l'autorizzazione IAM, puoi utilizzare le policy IAM per limitare l'accesso esclusivamente al ruolo del gateway, assicurando che tutte le richieste di runtime fluiscano attraverso il gateway.

• Credenziali IAM del chiamante: il gateway utilizza le credenziali IAM del chiamante per firmare le richieste al target di runtime. Il gateway assume un ruolo per conto del chiamante e firma la richiesta in uscita con l'identità del chiamante.

• OAuth (JWT): il gateway recupera i token OAuth dai provider di credenziali configurati nella destinazione tramite il servizio di identità Amazon Bedrock. AgentCore

• Token passthrough: il gateway convalida il token in entrata e lo trasmette alla destinazione di runtime senza modifiche. Ciò è utile quando il runtime gestisce la propria autorizzazione.

Imposizione del traffico attraverso il gateway

Puoi integrare il tuo AgentCore Runtime con un AgentCore gateway in modo che il gateway diventi l'unico punto di accesso gestito al runtime, offrendoti autorizzazioni basate su policy, Amazon Bedrock Guardrails, intercettori di richieste e risposte e osservabilità unificata, il tutto applicato al di fuori 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 sul runtime. Il gateway timbra l'origine di ogni richiesta inoltrata e il runtime convalida tale fonte durante l'ingresso. Il meccanismo specifico dipende dal tipo di autorizzazione in entrata del runtime:

• Runtime IAM (SigV4): allega una policy basata sulle risorse che limiti l'invocazione al ruolo di esecuzione del gateway. Per la policy e il rafforzamento della policy di fiducia che richiede, consulta Restrict IAM (SigV4) inbound invocation to your gateway.

• Runtime OAuth (JWT): allowedWorkloadConfiguration configurate i runtime per consentire solo il carico di lavoro del gateway. customJWTAuthorizer Per la configurazione e il riferimento sul campo, consulta Limita l'invocazione al gateway.

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 AgentCore tipo di destinazione Runtime. La tabella seguente confronta le funzionalità di ciascun approccio.

Funzionalità	Gateway MCP con obiettivi MCP	AgentCore Obiettivo del runtime
Tool/capability aggregazione	Aggrega le funzionalità di tutti i target MCP in un unico server MCP virtuale unificato. I clienti ricevono un'unica risposta consolidata. tools/list	Funziona in modo isolato. Il gateway invia il traffico direttamente alla destinazione senza unire le funzionalità. I client devono indirizzare ogni destinazione individualmente tramite un routing basato sul percorso.
Ricerca semantica tramite strumenti	Indicizza le descrizioni degli strumenti e ne consente la scoperta tramite interrogazioni in linguaggio naturale.	Non disponibile. Il gateway non acquisisce né indicizza le funzionalità. I client devono conoscere i nomi esatti degli strumenti o utilizzare quelli del server. tools/list
Intercettore di risposta Lambda	Supporta intercettori di richiesta e risposta per operazioni MCP non in streaming.	Supporta le funzioni Lambda dell'intercettore di richieste e risposte in modalità bufferizzata. Gli intercettori non sono ancora supportati in modalità streaming.