AgentCore Versioni ed endpoint in fase di esecuzione
Amazon Bedrock AgentCore implementa il controllo automatico delle versioni per i AgentCore runtime e consente di gestire diverse configurazioni utilizzando gli endpoint.
A ogni AgentCore runtime in Amazon Bedrock AgentCore viene assegnata automaticamente una versione:
-
Quando crei un AgentCore Runtime, AgentCore Runtime crea automaticamente la versione 1 (V1)
-
Ogni aggiornamento del AgentCore Runtime crea una nuova versione con una configurazione completa e autonoma
-
Le versioni sono immutabili una volta create
-
Ogni versione contiene tutta la configurazione necessaria per l'esecuzione
In che modo gli endpoint fanno riferimento alle versioni
Gli endpoint forniscono un modo per fare riferimento a versioni specifiche del Runtime: AgentCore
-
L'
DEFAULTendpoint punta automaticamente alla versione più recente del Runtime AgentCore -
Gli endpoint possono puntare a versioni specifiche, che consentono di mantenere ambienti diversi (ad esempio, sviluppo, gestione temporanea, produzione)
-
Quando aggiorni un AgentCore Runtime, l'
DEFAULTendpoint viene aggiornato automaticamente in modo che punti alla nuova versione -
Gli endpoint devono essere aggiornati in modo esplicito in modo che puntino a nuove versioni
Esempio di aggiornamento di un endpoint a una nuova versione
bedrock_agentcore_client = boto3.client('bedrock-agentcore', region_name='us-west-2') response = bedrock_agentcore_client.update_agent_runtime_endpoint( agentRuntimeId='agent-runtime-12345', endpointName='production-endpoint', agentRuntimeVersion='v2.1', description='Updated production endpoint' ) print(response)
Scenari di controllo delle versioni
La tabella seguente illustra come interagiscono il controllo delle versioni e gli endpoint durante il ciclo di vita di un Runtime: AgentCore
| Tipo di modifica | Comportamento di creazione della versione | Versione più recente | Comportamento degli endpoint |
|---|---|---|---|
|
Creazione iniziale |
Crea automaticamente la versione 1 (V1) |
V1 |
DEFAULT punta a V1 |
|
Modifica del protocollo |
Crea una nuova versione con impostazioni di protocollo aggiornate |
V2 |
DEFAULT si aggiorna automaticamente alla V2 |
|
Crea un endpoint «PROD» con V2 |
Nessuna nuova versione creata |
V2 |
L'endpoint PROD punta alla V2 |
|
Aggiornamento dell'immagine del contenitore |
Crea una nuova versione con un nuovo riferimento al contenitore |
V3 |
L'impostazione PREDEFINITA si aggiorna alla V3, PROD rimane sulla V2 |
|
Aggiorna «PROD» a V3 |
Nessuna nuova versione creata |
V3 |
PROD si aggiorna alla V3 |
|
Modifica delle impostazioni di rete |
Crea una nuova versione con parametri di sicurezza aggiornati |
V4 |
L'impostazione PREDEFINITA si aggiorna alla V4, PROD rimane sulla V3 |
Stati del ciclo di vita degli endpoint
AgentCore Gli endpoint di runtime attraversano vari stati durante il loro ciclo di vita:
- CREAZIONE IN CORSO
-
Stato iniziale al momento della creazione di un endpoint
- CREATE_FAILED
-
Indica un errore di creazione dovuto alle autorizzazioni, al contenitore o ad altri problemi
- PRONTA
-
L'endpoint è pronto ad accettare le richieste
- AGGIORNAMENTO IN CORSO
-
L'endpoint è in fase di aggiornamento a una nuova versione
- UPDATE_FAILED
-
Indica un errore nell'operazione di aggiornamento
Elenco delle versioni e degli endpoint di AgentCore Runtime
È possibile elencare tutte le versioni di un AgentCore Runtime chiamando l'ListAgentRuntimeVersionsoperazione. Per elencare gli endpoint di un AgentCore Runtime, chiamaListAgentRuntimeEndpoints.
