View a markdown version of this page

Pacchetti di configurazione - Amazon Bedrock AgentCore

Pacchetti di configurazione

Un pacchetto di configurazione è un'istantanea con versione e immutabile della configurazione dinamica dell'agente: istruzioni di sistema, ID dei modelli, descrizioni degli strumenti e qualsiasi altra coppia chiave-valore letta dall'agente in fase di esecuzione. I bundle separano il comportamento dell'agente dal codice, consentendoti di modificare il modo in cui l'agente risponde senza ridistribuire il codice.

Concetti chiave

  • I componenti sono codificati dall'ARN della AgentCore risorsa che configurano (ad esempio, un ARN di runtime). Ogni componente contiene un configuration oggetto con coppie chiave-valore arbitrarie.

  • Le versioni sono immutabili. Ogni aggiornamento crea una nuova versione con un UUID univoco. Le versioni formano una catena tramiteparentVersionIds, simile ai git commits.

  • I rami organizzano il lignaggio delle versioni (ad esempiomainline,experiment-1).

  • I nomi dei pacchetti devono iniziare con una lettera e possono contenere lettere, cifre e caratteri di sottolineatura (senza trattini). Motivo:. [a-zA-Z][a-zA-Z0-9_]{0,99}

Quando utilizzare i pacchetti di configurazione

  • A/B test. Ogni variante di un A/B test fa riferimento a una versione specifica del pacchetto. Il gateway inserisce il riferimento al bundle in ogni richiesta.

  • Raccomandazioni. L'API Recommendations può leggere la configurazione corrente da un pacchetto e scrivere la configurazione ottimizzata come nuova versione del pacchetto.

  • Rollback. Poiché le versioni sono immutabili, puoi tornare a qualsiasi versione precedente facendo riferimento all'ID della versione.

  • Traccia di controllo. La catena di versioni fornisce una cronologia completa delle modifiche alla configurazione.