View a markdown version of this page

AgentCore Controllo delle versioni e degli endpoint in fase di esecuzione - Fondamento Amazon AgentCore

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AgentCore Controllo delle versioni e degli 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.

Ogni AgentCore Runtime in Amazon Bedrock ha una versione automatica: AgentCore

  • 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

  • Una volta create, le versioni sono immutabili

  • 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 tuo AgentCore Runtime:

  • L'DEFAULTendpoint punta automaticamente alla versione più recente del tuo Runtime AgentCore

  • Gli endpoint possono puntare a versioni specifiche, consentendoti di gestire ambienti diversi (ad esempio, sviluppo, staging, produzione)

  • Quando si aggiorna un AgentCore Runtime, l'DEFAULTendpoint viene aggiornato automaticamente in modo da puntare alla nuova versione

  • Gli endpoint devono essere aggiornati in modo esplicito per puntare 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 il controllo delle versioni e gli endpoint interagiscono 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 a 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» alla V3

Nessuna nuova versione creata

V3

Aggiornamenti PROD 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 a autorizzazioni, contenitore o altri problemi

PRONTA

Endpoint è pronto ad accettare le richieste

AGGIORNAMENTO IN CORSO

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.