Distribuzione di un agente

Quando crei per la prima volta un agente di Amazon Bedrock, hai una versione della bozza di lavoro (DRAFT) e un alias di test (TSTALIASID) che rimanda alla versione della bozza di lavoro. Quando apporti modifiche al tuo agente, le modifiche si applicano alla bozza di lavoro. Continui a iterare sulla bozza di lavoro finché il comportamento dell’agente non risulta soddisfacente. Quindi, puoi configurare l’agente per implementarlo e integrarlo nell’applicazione creando gli alias dell’agente.

Alias e versioni

Per implementare l’agente, devi creare un alias. Durante la creazione dell’alias, Amazon Bedrock genera automaticamente una versione dell’agente. L’alias rimanda alla versione appena creata. In alternativa, puoi fare in modo che l’alias punti alla versione creata in precedenza dell’agente. Poi configura l’applicazione per effettuare chiamate API all’alias.

Una versione è simile a uno snapshot che conserva la risorsa così com’era al momento della creazione. Puoi continuare a modificare la bozza di lavoro e creare nuovi alias (e di conseguenza, nuove versioni) dell’agente, se necessario. In Amazon Bedrock, per generare una nuova versione dell’agente, crea un alias che rimanda per impostazione predefinita a questa versione. Amazon Bedrock crea le versioni in ordine numerico, a partire da 1.

Le versioni sono immutabili perché fungono da snapshot dell’agente al momento della creazione. Per eseguire aggiornamenti a un agente in produzione, è necessario creare una nuova versione e configurare l’applicazione in modo che chiami l’alias che punta a quella versione.

Gli alias consentono di passare comodamente da una versione all’altra dell’agente, senza che l’applicazione debba tenere traccia della versione. Per esempio, puoi modificare un alias per puntare a una versione precedente del tuo agente, se ci sono modifiche che devi ripristinare rapidamente.

Sospensione di un agente distribuito

Potrebbe essere necessario sospendere temporaneamente l’esecuzione di un agente. Ad esempio, durante la manutenzione, gli aggiornamenti o durante la risoluzione di problemi di prestazioni. Per mettere in pausa un agente, utilizzi l’alias dell’agente con l’operazione UpdateAgentAlias. Per sospendere un agente, imposta il campo aliasInvocationState su REJECT_INVOCATIONS. Per riavviare l’agente, imposta aliasInvocationState su ACCEPT_INVOCATIONS. Non è necessario apportare modifiche alla policy IAM per la sospensione dell’agente.

Per verificare se un agente è attualmente in pausa, chiama GetAgentAlias e controlla il campo aliasInvocationState. Puoi anche verificare la presenza di un alias nel campo aliasInvocationState nella risposta di ListAgentAliases.