View a markdown version of this page

Propagazione e osservabilità del pacchetto di configurazione - Amazon Bedrock AgentCore
Come si propagano i pacchetti di configurazioneComportamento sugli obiettivi MCPVincoliOsservabilità per la risoluzione delle regole

Propagazione e osservabilità del pacchetto di configurazione

Quando il gateway risolve un pacchetto di configurazione tramite regole, lo propaga ai servizi a valle tramite le intestazioni per bagagli (OtEL). OpenTelemetry Ciò consente la gestione completa della configurazione attraverso l'architettura del gateway e dell'agente.

Come si propagano i pacchetti di configurazione

Il gateway imposta l'ARN e la versione del pacchetto risolto nel bagaglio OTel utilizzando le seguenti chiavi:

Chiave per il bagaglio Description

aws.agentcore.configbundle_arn

L'ARN del pacchetto di configurazione risolto.

aws.agentcore.configbundle_version

La versione del pacchetto di configurazione risolto.

Il flusso di propagazione funziona come segue:

  1. Il gateway valuta le regole e risolve un pacchetto di configurazione.

  2. Il gateway imposta l'ARN e la versione del pacchetto nelle intestazioni per bagagli Otel sulla richiesta in uscita.

  3. L'agent runtime riceve la richiesta con le intestazioni dei bagagli. Il runtime è controllato da te. Il tuo codice agente può leggere l'ARN e la versione del pacchetto di configurazione dal bagaglio dell'Otel, se necessario.

  4. Se l'agente richiama un gateway con obiettivi MCP, il gateway legge il pacchetto dal bagaglio dell'Otel e alle risposte applica delle sostituzioni alla descrizione dello strumento. tools/list Per informazioni dettagliate, vedi Comportamento sugli obiettivi MCP.

Comportamento sugli obiettivi MCP

Il gateway applica le sostituzioni dei pacchetti di configurazione sulle destinazioni MCP solo per il percorso. tools/list I search_tool percorsi invoke_tool and non supportano le sostituzioni dei pacchetti di configurazione.

Ad esempio, se un pacchetto di configurazione sostituisce la descrizione dello strumento di un target, la descrizione aggiornata viene visualizzata nelle risposte ma non nelle tools/list risposte. search_tool

Per applicare queste sostituzioni, il gateway chiama GetConfigurationBundleVersion per leggere il contenuto del pacchetto. Aggiungi questa autorizzazione al ruolo di esecuzione del gateway:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock-agentcore:GetConfigurationBundleVersion",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:123456789012:configuration-bundle/*"
        }
    ]
}
Nota

Questa autorizzazione è richiesta solo per il ruolo di esecuzione del gateway per tools/list le operazioni MCP. Il runtime dell'agente trasmette il pacchetto senza accedervi e non necessita di questa autorizzazione.

Vincoli

  • Il pacchetto di configurazione deve trovarsi nello stesso account del gateway. Cross-account l'accesso al bundle non è supportato.

  • I gateway con destinazioni HTTP non leggono i pacchetti di configurazione dal bagaglio OTel. Risolvono i pacchetti solo in base alle proprie regole. Se trasferisci un pacchetto di bagagli OTel a un gateway con obiettivi HTTP, il gateway lo ignora.

  • I gateway con obiettivi MCP leggono i pacchetti di configurazione presenti nel bagaglio Otel e applicano le eccezioni solo sul percorso. tools/list

Osservabilità per la risoluzione delle regole

Quando il gateway risolve le regole per una richiesta, emette attributi span sullo span del server gateway. È possibile utilizzare questi attributi per osservare la versione del pacchetto di configurazione e le decisioni di routing applicate.

Gli attributi del pacchetto di configurazione sostituiscono gli attributi

Attributo Span Description

aws.agentcore.configbundle_arn

L'ARN del pacchetto di configurazione risolto.

aws.agentcore.configbundle_version

La versione del pacchetto di configurazione risolto.

Attributi di routing di destinazione

Attributo Span Description

aws.agentcore.gateway.resolved_target_name

Il nome dell'obiettivo risolto.

Utilizzate questi attributi per verificare che le regole si risolvano come previsto e per risolvere i problemi relativi al comportamento di routing.