

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
<a name="agent-runtime-versioning"></a>

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
<a name="endpoint-versioning"></a>

Gli endpoint forniscono un modo per fare riferimento a versioni specifiche del tuo AgentCore Runtime:
+ L'`DEFAULT`endpoint 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'`DEFAULT`endpoint 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
<a name="versioning-scenarios"></a>

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
<a name="endpoint-lifecycle"></a>

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
<a name="listing-versions"></a>

È possibile elencare tutte le versioni di un AgentCore Runtime chiamando l'`ListAgentRuntimeVersions`operazione. Per elencare gli endpoint di un AgentCore Runtime, chiama`ListAgentRuntimeEndpoints`.