View a markdown version of this page

Inizia a usare Instances usando la console - Fondamento Amazon AgentCore
Fase 1: Creare un fornitore di capacitàPassaggio 2: creare un runtime dell'agente che utilizzi il provider di capacitàPassaggio 3: richiama e monitoraFase 4: puliziaFasi successive

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

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

Fase 1: Creare un fornitore di capacità

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

  2. Nella scheda Provider di capacità, scegli Crea fornitore di capacità.

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

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

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

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

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

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

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

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

  2. Inserisci un nome per l'agente o lo strumento.

  3. Per Tipo di calcolo, scegli Istanze.

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

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

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

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

  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.

  2. 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, 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.

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

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.

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

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

Fasi successive