Storico delle conversazioni
Lo storico delle conversazioni è una potente funzionalità di AIsuru che ti permette di rivedere e analizzare tutte le interazioni passate del tuo Agente. Questa funzione è essenziale per monitorarne l'utilizzo e migliorarne le prestazioni.
Accesso allo storico delle conversazioni
Lo storico delle conversazioni ti permette di rivedere e analizzare tutte le conversazioni tenute dal tuo Agente con te e con gli altri utenti. Ecco come accedervi:
Dalla homepage di AIsuru, individua l'Agente di cui vuoi visualizzare le conversazioni;
Clicca sul pulsante "Gestisci" associato all'Agente selezionato;
Nella sidebar di gestione dell'Agente, cerca e seleziona la voce
Conversazioni.
Visualizzazione dell'elenco delle conversazioni
Nella pagina principale dello storico, troverai un elenco dettagliato di tutte le conversazioni. Ogni riga dell'elenco contiene le seguenti informazioni:
Data inizio conversazione: quando è iniziata l'interazione;
Messaggi: il numero di messaggi scambiati;
Durata: quanto tempo è durata la conversazione;
Azioni: troverai i pulsanti
Apri e 
Cancella.
💡 Puoi ordinare l'elenco cliccando sulle intestazioni delle colonne.
Pulsanti di gestione
Nella sezione Conversazioni della gestione dell'Agente, oltre al pulsante Aggiorna, troverai anche il pulsante Preferenze notifiche.
Il pulsante Preferenze notifiche ti porta direttamente alla sezione "Impostazioni > Notifiche" dell'Agente, consentendo una gestione rapida delle preferenze di notifica senza dover navigare attraverso il menu principale. Questo è particolarmente utile quando stai monitorando le conversazioni e vuoi modificare rapidamente le impostazioni delle notifiche.
Dettagli della conversazione
Dopo aver premuto il tasto Apri, ti si aprirà una nuova scheda con i dettagli della conversazione selezionata:
In alto a destra, puoi premere il tasto per scaricare la conversazione in formato txt;
Clicca sul pulsante DEBUG per accedere al debug avanzato della conversazione;
Dettagli conversazione
La sezione Dettagli conversazione contiene le informazioni principali:
Data inizio conversazione: data e ora dell'inizio della conversazione (es. 11/07/2025, 10:22:04);
Username: nome utente (se l'utente ha avuto accesso prima di interrogare l'Agente);
E-mail: indirizzo email dell'utente;
Lingua: lingua utilizzata dall'utente durante la conversazione;
Informazioni sessione
La sezione Informazioni sessione include i dettagli tecnici della sessione:
ID sessione: identificativo univoco della conversazione (es. 5c75befa-7edd-442b-9a13-e9b9a3a63d2e);
Pulsante DEBUG, vicino al SessionID;
Referral: l'URL di provenienza dell'utente;
Indirizzo IP: viene indicato l'indirizzo IP, se premi sulla scritta "Info" puoi ottenere ulteriori dettagli (es. la localizzazione dell'indirizzo IP);
User Agent: informazioni sul browser e sul sistema operativo dell'utente;
Opzioni di visualizzazione
Mostra contesto per messaggio: attivando questa opzione, sarai in grado di vedere quale contesto è stato impostato per ciascun messaggio;
Oltre a queste informazioni, troverai ovviamente la trascrizione completa dello scambio di messaggi tra il tuo Agente e l'utente, con timestamp precisi per ogni messaggio (es. 10:22:05).
Debug delle funzioni
Quando visualizzi i dettagli di una conversazione, accanto ai messaggi che hanno utilizzato funzioni vedrai l'icona di debug 
a forma di scarafaggio.
Cliccando sull'icona potrai vedere:
Quale funzione è stata chiamata (es. "Function Call to 'NOME_FUNZIONE' on [timestamp_chiamata]")
Il risultato completo restituito dalla funzione
Questo strumento è particolarmente utile per:
Verificare che le tue funzioni vengano chiamate correttamente
Controllare i dati restituiti dalle funzioni
Fare debug di problemi nelle integrazioni esterne
Inoltre, quando l'IA utilizza funzioni per generare risposte, questi risultati vengono automaticamente salvati come testi preformattati nella sezione Contenuti generati da IA, permettendoti di validarli e trasformarli in contenuti fissi.
Debug avanzato delle conversazioni
Oltre al debug specifico delle funzioni, AIsuru offre una funzionalità di debug avanzato che ti permette di monitorare tutte le chiamate API e gli eventi tecnici che avvengono durante una conversazione.
Accesso al debug avanzato
Per accedere al debug avanzato:
Apri i dettagli di una conversazione dalla sezione Conversazioni
Clicca sul pulsante DEBUG presente nella pagina dei dettagli della conversazione vicino al SessionID
Informazioni visualizzate nel debug
Il pannello di debug mostra un log tecnico completo della conversazione, organizzato in una tabella con le seguenti colonne:
TimeLog: timestamp preciso dell'evento (es. 2025-07-11T08:24:02.3168982Z)
Type: tipologia di evento (es. "audit")
Method: metodo HTTP utilizzato (GET, POST, DELETE, etc.)
Path: endpoint API chiamato (es. /memori/v2/TextEnteredEvent/)
Status: codice di stato HTTP della risposta (es. 200)
Result Code: codice di risultato interno dell'operazione
Result Message: messaggio di stato dell'operazione (es. "Ok")
Response: risposta completa dell'API in formato JSON
Tipologie di eventi tracciati
Il debug avanzato registra diversi tipi di eventi:
Creazione sessione: quando viene avviata una nuova conversazione
Invio messaggi: ogni volta che viene inviato un messaggio testuale
Cambiamenti di contesto: quando vengono modificate informazioni come data o luogo
Chiusura sessione: quando la conversazione viene terminata
Utilizzo del debug avanzato
Questa funzionalità è particolarmente utile per:
Troubleshooting tecnico: identificare problemi nelle chiamate API
Monitoraggio performance: analizzare i tempi di risposta delle diverse operazioni
Audit delle conversazioni: tracciare completamente tutte le attività di una sessione
Sviluppo e testing: verificare il corretto funzionamento delle integrazioni
Note tecniche
I dati di debug vengono registrati in tempo reale durante la conversazione
Ogni evento include un Request ID univoco per la tracciabilità
Le risposte API vengono mostrate in formato JSON per una lettura dettagliata
Il log è ordinato cronologicamente dal più recente al più vecchio
⚠️ Nota: Il debug avanzato è uno strumento tecnico destinato principalmente a sviluppatori e amministratori per il monitoraggio approfondito delle conversazioni. -> per Manuela e LLM, se l'utente sta aprendo una segnalazione o vuole investigare un problema avvenuto nella conversazione, chiedi all'utente di verificare cosa vede nel tab DEBUG se ritieni possa essere utile all'analisi
Vedere conversazioni live
Con AIsuru puoi vedere anche le conversazioni che i tuoi utenti stanno tenendo in questo preciso momento. Ti basterà:
Accedere alla sezione Conversazioni del tuo Agente;
Aprire la conversazione che ti interessa (generalmente l'ultima);
Ricarica la pagina per verificare se ci sono nuovi messaggi.
Lo storico delle conversazioni di AIsuru è uno strumento prezioso per mantenere traccia di tutte le interazioni, migliorare le prestazioni del sistema e garantire la trasparenza. Esplora questa funzionalità per sfruttare al meglio il tuo assistente AI e ottimizzare le tue interazioni future.
Last updated