Agenti
Memoria e cronologia chat
Come controllare ciò che ricorda un agente AI: la cronologia chat all’interno di una conversazione e la memoria tra conversazioni.
Un agente può ricordare in due modi diversi. La cronologia chat è ciò che vede della conversazione in corso. La memoria è un archivio di note in cui può scrivere e da cui può leggere tra conversazioni diverse. Sono impostazioni separate e puoi usarne una, entrambe o nessuna.
Cronologia chat#
La cronologia chat decide quanti dei messaggi precedenti di una conversazione l’agente riceve insieme a ogni nuova domanda. Senza di essa l’agente risponderebbe a ogni messaggio come se fosse il primo.
La trovi nella scheda Advanced, nella sezione Chat history. L’interruttore nell’intestazione della sezione la attiva o la disattiva. È attivo per un nuovo agente. L’intestazione della sezione riassume l’impostazione, per esempio “Ultimi 10 messaggi · 8000 token”.
Con l’interruttore attivo, puoi impostare:
- History Message Count. Quanti messaggi recenti includere. Il valore predefinito è 10 e puoi scegliere da 1 a 50.
- History Max Tokens. La quantità massima di testo della cronologia da inviare. Il valore predefinito è 8000 e puoi scegliere da 100 a 8000 con incrementi di 100.
- Message Types. Quali tipi di messaggi contare: User Messages, AI Messages e Tool Calls. Per impostazione predefinita l’agente vede i messaggi dell’utente e dell’AI.
Una cronologia più lunga dà all’agente più contesto e comporta anche l’invio di più testo al modello con ogni messaggio.
Memoria#
La memoria permette all’agente di conservare informazioni oltre una singola conversazione, come le preferenze di un cliente o i fatti che ha appreso. È disattivata per un nuovo agente.
La trovi nella sezione Memory della scheda Preferences. Attiva l’interruttore nell’intestazione della sezione, poi imposta:
- Memory Category. Il gruppo di voci di memoria da cui l’agente legge e in cui scrive. Devi sceglierne una. Finché la memoria è attiva e non è stata scelta alcuna categoria, il builder avvisa: “Scegli una categoria o disattiva la memoria. L’agente si rifiuta di eseguire quando la memoria è attiva e non ne è stata scelta alcuna.” Crea e gestisci le categorie in memory.
- Access Mode. Read Only permette all’agente di cercare nella memoria. Read/Write gli permette anche di aggiungere e aggiornare le voci.
- Read Memory Prompt. Istruzioni che indicano all’agente come e quando usare gli strumenti di lettura.
- Write Memory Prompt. Istruzioni su come e quando usare gli strumenti di scrittura. È importante in modalità Read/Write.
- Offload Flow Input. Quando è attivo, l’input dell’esecuzione viene memorizzato e l’agente può recuperarlo in seguito con uno strumento chiamato
get_offloaded_memory. È disattivato per impostazione predefinita.
I due prompt iniziano con valori predefiniti che funzionano per la maggior parte degli agenti. Modificali quando l’agente scrive troppo, troppo poco o le cose sbagliate.
La memoria appartiene a una categoria
L’agente memorizza e recupera le voci tramite la categoria che scegli. Gli agenti che usano la stessa categoria lavorano sulla stessa memoria, quindi usa una categoria separata quando due agenti non devono condividere le note.
Quale usare#
| Vuoi che | Usa |
|---|---|
| L’agente segua una conversazione a botta e risposta | La cronologia chat |
| L’agente sappia qualcosa dalla conversazione di ieri | La memoria |
| Le risposte si basino sui tuoi documenti | Uno strumento di recupero, vedi strumenti dell’agente |
Se qualcosa va storto#
- Se l’agente smette di rispondere dopo che hai attivato la memoria, verifica che sia stata scelta una categoria.
- Se dimentica ciò che hai detto due messaggi fa, verifica che l’interruttore Chat history sia attivo e che User Messages sia selezionato.
- Se non scrive nulla nella memoria, verifica che Access Mode sia Read/Write.