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 la distribuzione diretta del codice di Amazon Bedrock AgentCore Runtime
La distribuzione diretta del codice ti consente di portare il tuo agente su Amazon Bedrock AgentCore Runtime semplicemente impacchettando il codice dell'agente e le sue dipendenze in un archivio di file .zip. Il tuo agente deve comunque seguire i requisiti di Runtime. AgentCore
Per creare il pacchetto di distribuzione come archivio di file .zip, puoi utilizzare la AgentCore CLI zip in un ambiente Linux o MacOS. Per utilizzare gli stessi comandi in Windows, puoi installare il sottosistema Windows per Linux
Nota che AgentCore Runtime utilizza i permessi dei file POSIX, quindi potrebbe essere necessario impostare le autorizzazioni per la cartella del pacchetto di distribuzione
Argomenti
Concetti di distribuzione diretta del codice
Scopri i concetti chiave per utilizzare la distribuzione diretta del codice con Amazon AgentCore Bedrock Runtime.
Argomenti
Amazon Bedrock AgentCore Runtime con distribuzione diretta del codice utilizza un modello di responsabilità condivisa simile a Lambda. AWS AgentCore Runtime gestisce l'ambiente di runtime del linguaggio e applica automaticamente le patch di sicurezza, mentre tu ti concentri sul codice dell'agente e sulle dipendenze.
Se utilizzi immagini di container per distribuire i tuoi agenti, AgentCore Runtime è responsabile dell'applicazione delle patch solo al kernel di calcolo. In questo caso, sei responsabile della ricostruzione dell'immagine del contenitore dell'agente a partire dall'immagine sicura più recente e della ridistribuzione dell'immagine del contenitore.
Ciò è riassunto nella seguente tabella:
| Deployment mode (Modalità distribuzione) | AgentCore Responsabilità del runtime | La tua responsabilità |
|---|---|---|
|
Modalità di distribuzione diretta |
Pubblica una nuova versione di runtime della lingua contenente le patch più recenti per il runtime della lingua. Applica le patch di runtime della lingua alla distribuzione diretta di AgentCore Runtime esistente. |
Aggiorna il codice dell'agente, comprese le dipendenze, per risolvere eventuali vulnerabilità di sicurezza. |
|
Immagine del contenitore |
Applica automaticamente la patch al kernel del sistema operativo di elaborazione sottostante con la versione più recente. |
Aggiorna il codice dell'agente, comprese le dipendenze, per risolvere eventuali vulnerabilità di sicurezza. Ricostruisci e reimplementa regolarmente l'immagine di container utilizzando l'immagine di base più recente. |
Per ulteriori informazioni sulla responsabilità condivisa con AWS, consulta Modello di responsabilità condivisa.
AgentCore Runtime mantiene aggiornato ogni runtime di distribuzione diretta del codice con aggiornamenti di sicurezza, correzioni di bug, nuove funzionalità, miglioramenti delle prestazioni e supporto per le versioni secondarie. Questi aggiornamenti di runtime vengono pubblicati come versioni di runtime. AgentCore Runtime applica gli aggiornamenti del runtime di distribuzione diretta del codice agli agenti migrando gli agenti da una versione di runtime precedente a una nuova versione di runtime.
Per i runtime di distribuzione diretta, Runtime applica automaticamente gli aggiornamenti AgentCore di runtime. Con gli aggiornamenti automatici del AgentCore runtime, Runtime si assume l'onere operativo dell'applicazione delle patch alle versioni di runtime. Per la maggior parte dei clienti, questa dovrebbe essere una scelta sicura in quanto verranno applicate automaticamente solo le patch di runtime del linguaggio e i clienti sono responsabili dell'introduzione e della gestione delle dipendenze del codice. Attualmente AgentCore Runtime non supporta la modifica di questo comportamento di applicazione automatica delle patch.
AgentCore Runtime si impegna a fornire aggiornamenti di runtime che siano retrocompatibili con le funzioni esistenti. Tuttavia, come nel caso delle patch software, ci sono rari casi in cui un aggiornamento del runtime può influire negativamente su una funzione esistente. Ad esempio, le patch di sicurezza possono evidenziare un problema di fondo di una funzione esistente che dipende dal comportamento precedente e non sicuro. Se in casi estremamente rari questo rischio non è accettabile, utilizza le immagini del contenitore per distribuire il tuo agente.
Alcune delle dimensioni del confronto per vedere in che modo un'opzione differisce dall'altra, quindi è utile scegliere l'opzione giusta
-
Processo di distribuzione: la distribuzione diretta del codice implementa gli agenti utilizzando file ZIP anziché contenitori, il che si presta a iterazioni di sviluppo più rapide.
-
Tempo di distribuzione: sebbene non vi sia molta differenza durante la prima distribuzione di un agente, gli aggiornamenti successivi all'agente sono notevolmente più veloci grazie alla distribuzione diretta del codice.
-
Personalizzazione: il codice diretto supporta le dipendenze personalizzate tramite ZIP-based la creazione di pacchetti, pur mantenendo la semplicità di distribuzione mentre la distribuzione basata su container dipende da un file Docker.
-
Dimensione del pacchetto: la distribuzione diretta del codice limita la dimensione del pacchetto a 250 MB, mentre i pacchetti basati su container possono avere dimensioni fino a 2 GB.
-
Velocità di creazione di sessioni: l'implementazione diretta del codice consente una maggiore creazione di 25 nuove sessioni sessions/second rispetto alle 1,6 nuove sessions/second con le distribuzioni basate su container.
La nostra guida generale è
-
Se la dimensione del pacchetto di distribuzione supera i 250 MB e disponi di CI/CD pipeline di container esistenti e hai bisogno di dipendenze e pacchetti altamente specializzati, le distribuzioni basate su container sono una buona opzione da scegliere.
-
Se le dimensioni del pacchetto di distribuzione sono ridotte, il codice e il pacchetto non sono complessi da creare e utilizzano framework e linguaggi comuni e sono necessarie prototipazione e iterazione rapide, la distribuzione diretta del codice sarebbe l'opzione.
Può esserci anche un'opzione ibrida in cui gli sviluppatori utilizzano la distribuzione diretta del codice per sperimentare e prototipare rapidamente gli agenti e quindi passare a implementazioni basate su container (per i motivi sopra indicati) per sviluppare, testare e distribuire in produzione.
