Comprendere la memoria degli agenti

Nota:

Questa funzionalità è attualmente disponibile in anteprima solo per le distribuzioni su AWS e IBM Cloud.

La memoria degli agenti consente agli agenti IA di conservare, richiamare e utilizzare le informazioni che ti riguardano nel corso delle sessioni di chat, garantendo interazioni sempre più personalizzate ed efficienti nel tempo.

Quando la memoria dell'agente è attivata, l'agente IA apprende dalle tue conversazioni e memorizza dettagli chiave quali le tue preferenze, il contesto lavorativo e le informazioni utilizzate di frequente. Questa funzionalità consente all'agente di fornire risposte più pertinenti senza che tu debba ripetere le informazioni ad ogni conversazione.

Come funziona la memoria dell'agente

La memoria dell'agente funziona estraendo e memorizzando le informazioni rilevanti dalle tue conversazioni con gli agenti IA. Il sistema identifica e memorizza le informazioni utili a migliorare le interazioni future, quali:

Dati personali (nome, ruolo, sede)
Preferenze lavorative e contesto
Informazioni più richieste
Preferenze relative allo stile di comunicazione

L'agente utilizza queste informazioni memorizzate per:

Fornire risposte pertinenti al contesto
Ridurre la necessità di fornire spiegazioni ripetitive
Migliorare la precisione delle risposte nel tempo
Personalizza le interazioni in base alle tue preferenze

La memoria dell'agente richiede una configurazione sia a livello di generatore che a livello di utente:

Memoria dell'agente: I builder consentono all'agente di memorizzare e utilizzare i ricordi impostando il memory_enabled parametro su true.
Memoria utente: Gli utenti possono decidere se le loro conversazioni debbano essere salvate nella memoria attivando l'opzione " Usa i ricordi nelle conversazioni " nell'interfaccia di Orchestrate Chat.

È necessario abilitare prima la memoria dell'agente per consentire all'agente di salvare i dati in memoria
Ogni utente deve quindi abilitare la memoria utente per attivare la memorizzazione delle proprie conversazioni

Prerequisiti

Per poter utilizzare la memoria dell'agente, è necessario soddisfare i seguenti requisiti:

Il programmatore o l'amministratore deve impostare il memory_enabled parametro per l'agente in true ADK.
È necessario abilitare la funzione "memorie" nell'interfaccia della chat utilizzando l'opzione "Usa memorie nelle conversazioni ".
La memoria dell'agente è supportata solo per gli agenti nativi che utilizzano gpt-oss come modello di IA.

Configurazione della memoria in ADK

Il memory_enabled parametro deve essere configurato tramite l'Agent Development Kit (ADK), aggiungendolo al file di configurazione YAML dell'agente.

Ad esempio:

spec_version: v1
kind: native
name: travel_assistant
llm: groq/openai/gpt-oss-120b
style: default
memory_enabled: true

description: |
  A travel-planning assistant that learns stable user preferences
  and uses them in future conversations.

instructions: |
  Help the user plan travel efficiently.
  Pay attention to stable preferences like home city, airline preference,
  hotel style, budget level, and preferred response format.
  Do not treat one-time trip details as long-term preferences unless the
  user clearly says they are ongoing preferences.

collaborators: []
tools: []

Per ulteriori informazioni sulla creazione e la configurazione degli agenti con ADK, consultare la sezione Creazione di agenti tramite ADK.

Introduzione alla memoria degli agenti

Segui questi argomenti per comprendere, abilitare e utilizzare in modo efficace la memoria dell'agente:

Gestione della memoria dell'agente: Configura la memoria per la prima volta seguendo le istruzioni dettagliate. Scopri i prerequisiti, come abilitare la memoria sia a livello di agente che di utente e verifica che la memoria funzioni correttamente.
Usa la memoria nelle conversazioni: Scopri esempi pratici e buone pratiche per utilizzare in modo efficace la memoria degli agenti. Scopri come istruire l'agente affinché ricordi o dimentichi determinate informazioni e osserva alcuni scenari reali in cui la memoria viene messa in pratica.
Comportamento e limiti della memoria: Scopri quali informazioni vengono archiviate, come è strutturata la memoria e quali sono le politiche di governance che proteggono i tuoi dati. Scopri le impostazioni sulla privacy, la conservazione dei dati e gli standard di conformità.
Politica di mantenimento: Scopri per quanto tempo viene conservata la memoria, come funziona la strategia LRU (Least Recently Used) e cosa succede quando si disattiva la memoria. Comprendere l'intervallo di inattività di 30 giorni e come gli elementi in memoria vengono rimossi automaticamente.
FAQ (Frequently Asked Questions): Trova risposte rapide alle domande più frequenti relative alle funzionalità, al comportamento e alla gestione della memoria degli agenti.