View a markdown version of this page

Gestisci i tuoi dati sulle istanze di runtime - 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à.

Gestisci i tuoi dati sulle istanze di runtime

Quando ospiti agenti sul tipo di elaborazione Instances, i tuoi dati vengono archiviati su volumi Amazon EBS nel tuo account. AWS

Questo argomento descrive cosa vi è AgentCore archiviato e come leggerlo, modificarlo, estrarlo ed eliminarlo.

Per informazioni sul modello di responsabilità condivisa che si applica a tutto Amazon Bedrock AgentCore, consulta Protezione dei dati in Amazon AgentCore Bedrock.

Quali sono gli archivi di Instances e dove

Le istanze memorizzano due categorie di dati. La tabella seguente mostra dove risiede ciascuna categoria e quale risorsa ne controlla il ciclo di vita.

Categoria Dove è archiviato Il ciclo di vita è controllato da

Contenuto del volume

Volumi Amazon Elastic Block Store (Amazon EBS) che vengono AgentCore creati nel tuo AWS account e inseriti nel tuo agente

La sessione che monta il volume

Configurazione delle risorse

I record di runtime del fornitore di capacità e dell'agente, inclusi il nome, la descrizione, i tipi di istanza consentiti, le definizioni di rete e di archiviazione

Il provider di capacità e il runtime dell'agente

Il contenuto del volume è tutto ciò che l'agente legge e scrive nel percorso di montaggio. I volumi Amazon EBS vengono creati nel tuo account, quindi i controlli dell'account esistenti si applicano a essi. Per informazioni su come vengono crittografati i volumi, consulta Encryption at rest for Runtime Instances.

Leggi e modifica i tuoi dati

Il tuo agente legge e scrive il contenuto del volume nel percorso di montaggio, quindi modifica il contenuto nello stesso modo in cui lo ha creato. La tabella seguente mostra dove trovare le operazioni per tutto il resto.

Per farlo See

Leggi o modifica il contenuto del volume dall'esterno dell'agente

Esegui i comandi della shell nelle sessioni AgentCore di Runtime. InvokeAgentRuntimeCommandesegue un comando shell nella sessione in esecuzione, con lo stesso filesystem visualizzato dall'agente.

Trova le istanze e i volumi che supportano le tue sessioni

Istanze gestite da Amazon EC2. AgentCore le fornisce come istanze gestite, che per impostazione predefinita sono nascoste alle operazioni sugli elenchi e alle visualizzazioni della console Amazon EC2. Usalo describe-instances --include-managed-resources per elencarli o modifica l'impostazione di visibilità delle risorse gestite.

Visualizza i percorsi di montaggio e le impostazioni di archiviazione

Configurazioni del file system per AgentCore Runtime

Visualizza la configurazione del tuo fornitore di capacità

GetCapacityProvider e ListCapacityProviders. Per trovare i runtime degli agenti che ne utilizzano uno, usaListAgentRuntimeVersionsByCapacityProvider.

Modifica la configurazione del fornitore di capacità

Solo la descrizione può cambiare, tramiteUpdateCapacityProvider. Per qualsiasi altra impostazione, create un nuovo fornitore di capacità e associate ad esso i tempi di esecuzione degli agenti. Nella console, utilizza il flusso duplicato per iniziare dalla configurazione esistente.

Visualizza metriche e registri

Osservabilità o osservabilità e registri e tracciamento nella pagina dei dettagli del runtime nella console

Esporta i tuoi dati

Non è prevista alcuna operazione di esportazione per i contenuti di volume e non puoi scattare un'istantanea di Amazon EBS del volume di un fornitore di capacità. AgentCore crea e gestisce questi volumi come risorse gestite, quindi le operazioni di istantanea utilizzate sui volumi creati personalmente non sono disponibili per loro.

Per far uscire il contenuto di un volume, scrivilo in una destinazione che controlli, ad esempio un bucket Amazon S3. Hai due modi per farlo:

In entrambi i casi, la copia viene eseguita con il ruolo di esecuzione del runtime dell'agente, quindi concedi a quel ruolo l'accesso in scrittura alla destinazione. Per ulteriori informazioni sul ruolo, consulta Ruoli di AWS Identity and Access Management (IAM).

Importante

Esporta ciò che desideri conservare prima di eliminare una sessione o un fornitore di capacità. L'eliminazione di uno dei due comporta l'eliminazione dei volumi.

Per esportare la configurazione del fornitore di capacità, chiama GetCapacityProvider e salva la risposta.

Elimina i tuoi dati

L'eliminazione del contenuto del volume è una proprietà della sessione, non del singolo agente. L'interruzione del runtime di un agente in una sessione non elimina i dati e non termina l'istanza.

Solo i volumi persistenti conservano i dati per tutta la durata di una sessione. Il volume principale e tutti i volumi temporanei scompaiono quando l'istanza termina, quindi tutto ciò che l'agente scrive al di fuori di un percorso di montaggio persistente è temporaneo. Per informazioni sui tipi di volume, consulta Encryption at rest for Runtime Instances.

I volumi persistenti sopravvivono a tutti gli eventi tranne un'eliminazione esplicita. La tabella seguente mostra l'effetto di ciascun evento su di essi.

Event Cosa interrompe Cosa succede ai tuoi volumi persistenti

StopRuntimeSession

Il runtime di un agente all'interno di una sessione. I tempi di esecuzione degli altri agenti nella sessione non sono influenzati.

Conservato. AgentCore mantiene il volume collegato alla sessione.

Tempo di inattività

L'istanza, dopo che tutti i suoi agenti sono rimasti inattivi per idleInstanceTimeout secondi.

Conservato. AgentCore ricollega il volume quando si richiama nuovamente la sessione.

Durata massima raggiunta

L'istanza, indipendentemente dall'attività, inmaxLifetime.

Conservato. AgentCore ricollega il volume quando si richiama nuovamente la sessione.

DeleteCapacityProviderSession

L'intera sessione, incluse l'istanza Amazon EC2 e l'interfaccia di rete.

Eliminata. AgentCore elimina i volumi permanenti della sessione.

DeleteCapacityProvider

Il fornitore di capacità e tutte le relative sessioni.

Eliminato. AgentCore elimina i volumi di ogni sessione che appartiene al fornitore di capacità.

Per informazioni sulle impostazioni di inattività e durata, consulta Configurare le impostazioni del ciclo di vita di Amazon Bedrock AgentCore .

Per eliminare una sessione, hai bisogno di quello runtimeSessionId che hai fornito quando l'hai richiamata. Tieni traccia degli ID di sessione che utilizzi. Se non li hai più, elimina il fornitore di capacità per eliminare tutte le sue sessioni e i relativi volumi.

Prima di poter eliminare un fornitore di capacità, rimuovi i runtime dell'agente che vi fanno riferimento eliminando i runtime, le versioni o gli endpoint associati. In caso contrario, la richiesta ha esito negativo con un. ValidationException

Per informazioni sulle operazioni e sugli esempi, consulta Guida introduttiva alle istanze utilizzando la AWS CLI o l'SDK. Per informazioni sui passaggi della console, consulta Guida introduttiva alle istanze utilizzando la console.