

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à.

# Inizia a usare Instances usando la console
<a name="runtime-instances-get-started-console"></a>

Questo tutorial illustra come ospitare un agente sul tipo di ** elaborazione ** Instances utilizzando la AWS console di gestione. Prima si crea un fornitore di [ capacità ](runtime-instances-how-it-works.md#runtime-instances-capacity-provider) che definisce l'infrastruttura EC2, quindi si crea un runtime dell'agente che la utilizza e infine si richiama e si monitora l'agente.

Per i prerequisiti, consulta Guida introduttiva alle [ istanze. ](runtime-instances-getting-started.md)

## Fase 1: Creare un fornitore di capacità
<a name="runtime-instances-console-create-cp"></a>

1. Apri la AgentCore console Amazon Bedrock e scegli ** Runtime**.

1. **Nella scheda Provider di ** capacità, scegli ** Crea fornitore ** di capacità.

1. Nella sezione Dettagli del fornitore di ** capacità**, inserisci un ** nome**. I caratteri validi sono lettere, cifre e trattini bassi; il nome deve iniziare con una lettera e può contenere fino a 48 caratteri.

1. Per Sistema ** operativo**, scegli il sistema operativo per le tue istanze EC2 (ad esempio, ** Linux (64 bit x86)). ** Questo determina quali software e applicazioni sono compatibili con il tuo ambiente.

1. Per i tipi di istanze ** consentiti**, scegli fino a 30 tipi di istanze EC2 che soddisfano i requisiti del carico di lavoro. Filtra per produttore di vCPU, memoria e CPU per trovare una corrispondenza.

1. In ** Sicurezza**, scegli il ** VPC ** che controlla l'accesso alla rete per le tue istanze. Facoltativamente, configura le sottoreti e la modalità di rete del contenitore in Dettagli aggiuntivi. ** **

1. (Facoltativo) In Configurazione ** dello storage**, scegli ** Aggiungi volume ** per allegare un volume Amazon EBS per lo storage persistente. Configura il tipo di volume, le dimensioni, la velocità effettiva, gli IOPS e la crittografia. In questo modo viene salvata la configurazione del volume e AgentCore viene creato ogni volume al primo avvio della sessione.

1. In Accesso al ** servizio**, scegli il profilo dell'istanza associato all'istanza EC2 (utilizzato AgentCore per raccogliere i log di sistema; non concede autorizzazioni al codice dell'agente) e il ruolo ** Infrastruttura ** (utilizzato da AgentCore per gestire le istanze EC2 per tuo conto). Puoi utilizzare i ruoli esistenti o lasciare che la console ne crei di nuovi.

1. Scegli ** Crea fornitore di capacità**. Il fornitore di capacità inizia in uno `CREATING` stato e lo diventa `ACTIVE` dopo la convalida della sua configurazione.

**Nota**  
Dopo aver creato un fornitore di capacità, è possibile modificarne solo la descrizione. Per modificare altre configurazioni, ad esempio i tipi di istanze, la rete o lo storage, duplica il fornitore di capacità ed effettua gli aggiornamenti nel flusso di duplicazione.

## Passaggio 2: creare un runtime dell'agente che utilizzi il provider di capacità
<a name="runtime-instances-console-create-runtime"></a>

1. Nella ** pagina ** Runtime, scegli ** Create runtime ** (oppure, dalla pagina dei dettagli del fornitore di capacità, scegli ** Host agent/tool**).

1. Inserisci un ** nome ** per l'agente o lo strumento.

1. Per Tipo di ** calcolo**, scegli ** Istanze**.

1. Per ** Capacity provider**, scegli un provider di capacità esistente oppure scegli Creazione ** rapida ** per crearne uno con impostazioni preconfigurate in linea.

1. In ** Agent/tool fonte**, scegli il tipo di fonte e fornisci l'artefatto:
   +  **Fonte S3**: inizia da un modello, carica un `.zip` file o scegli un oggetto esistente in un bucket S3.
   +  **Contenitore ECR**: fornisci un URI di immagine del contenitore Amazon ECR.

1. (Facoltativo) Configura ** l'autenticazione in entrata**, le configurazioni ** avanzate ** (sicurezza, variabili di ambiente) e le ** autorizzazioni ** (ruolo di esecuzione IAM e crittografia KMS).

1. Scegli Crea runtime. ** ** AgentCore crea la versione 1 e un `DEFAULT` endpoint che punta ad essa.

**Nota**  
Non è possibile modificare il tipo di calcolo dopo aver creato il runtime.

## Passaggio 3: richiama e monitora
<a name="runtime-instances-console-invoke"></a>

1. Dalla pagina dei dettagli del runtime, scegli ** Test ** e fornisci un payload oppure utilizza lo ** snippet di codice di richiamo ** View per chiamare l'agente dalla tua applicazione.

1. La prima chiamata per una nuova sessione esegue il provisioning di un'istanza EC2 nel tuo account e avvia l'agente, quindi in genere richiede più tempo rispetto alle chiamate successive. Le chiamate successive alla stessa sessione sono molto più veloci. AgentCore esegue il provisioning dell'istanza come istanza gestita da [ Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html), che per impostazione predefinita è nascosta alle visualizzazioni della console EC2. `DescribeInstances` Per ulteriori informazioni sulla visibilità delle istanze gestite, consulta l'impostazione di visibilità delle risorse [ gestite. ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html#managed-resource-visibility-settings)

1. Utilizza le ** metriche ** di osservabilità e ** i log e la traccia ** nella pagina dei dettagli del runtime per monitorare sessioni, richiami, tasso di errore e consumo di risorse.

## Fase 4: pulizia
<a name="runtime-instances-console-cleanup"></a>

Per evitare addebiti continui per le istanze Amazon EC2 e i volumi Amazon EBS di cui hai effettuato il provisioning nel tuo account, ripulisci le risorse che hai creato per questo tutorial quando hai finito:

1. Elimina la sessione in modo da eliminare il provisioning dell' AgentCore istanza EC2 e dei relativi volumi persistenti. L'interruzione del runtime di un singolo agente in una sessione non termina l'istanza. Per ulteriori informazioni sulle operazioni API, consulta Guida [ introduttiva alle istanze utilizzando la AWS CLI o l'SDK. ](runtime-instances-get-started-cli.md)

1. Dissocia il runtime dal fornitore di capacità eliminando il runtime, i relativi endpoint o le relative versioni.

1. Elimina il fornitore di capacità una volta che nessun runtime vi fa riferimento.

## Fasi successive
<a name="runtime-instances-console-next-steps"></a>
+  [Istanze](runtime-instances-how-it-works.md) 
+  [Confronta i tipi di elaborazione ](runtime-instances-how-it-works.md#runtime-instances-compute-comparison) 
+  [Modello di sicurezza e autorizzazioni per le istanze di runtime ](runtime-instances-security.md) 