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:
Titolo: titolo distintivo per identificare la conversazione;
Mail: La mail del utente che ha interagito con l'agente;
Data inizio conversazione: quando è iniziata l'interazione;
Messaggi: il numero di messaggi scambiati;
Durata: quanto tempo è durata la conversazione;
Media: questa colonna indica se nella conversazione sono state presenti immagini o sono state eseguite funzioni;
Azioni: troverai i pulsanti
Apri e 
Cancella.
Puoi ordinare l'elenco cliccando sulle intestazioni delle colonne.
Strumenti di filtro e ricerca
Nella parte superiore dell'elenco sono disponibili tre strumenti per filtrare le conversazioni:
Barra di ricerca
La barra di ricerca permette di cercare conversazioni utilizzando i seguenti criteri:
Keyword: cerca parole chiave all'interno del contenuto delle conversazioni;
Nome utente: filtra per visualizzare solo le conversazioni di un utente specifico che ha effettuato l’accesso alla piattaforma (Se un utente non ha fatto l’accesso tramite mail in piattaforma verrà visualizzato come anonimo);
Email: filtra le conversazioni per indirizzo email specifico dell'utente che ha conversato con l’agente;
Session ID: filtra per identificativo univoco della sessione.
Esempio di utilizzo: digita "rimborso" nella barra per trovare tutte le conversazioni che menzionano questa parola chiave.
Selettore intervallo date
Cliccando sul selettore intervallo date, posizionato accanto alla barra di ricerca, si aprirà un calendario a tendina che permette di selezionare un intervallo temporale personalizzato con una data di inizio e una data finale, così da filtrare le conversazioni avvenute nel periodo scelto.
Esempio di utilizzo: seleziona "01/12/2024 - 14/12/2024" per vedere solo le conversazioni delle prime due settimane di dicembre.
Filtro per numero minimo di messaggi
Il filtro per numero minimo di messaggi è un menù a tendina che permette di filtrare le conversazioni in base alla loro lunghezza. Le opzioni disponibili sono:
Qualsiasi messaggio: mostra tutte le conversazioni (nessun filtro applicato);
Almeno 2/3/5/10/15/20 messaggi: mostra solo conversazioni con almeno quel numero di messaggi;
Cambia numero minimo: permette di specificare il numero minimo di messaggi per mostrare solo le chat che rispettano questo filtro.
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.
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);
Email: 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: permette di accedere al debug avanzato della conversazione;
Referral: l'URL da cui l'utente ha interrogato l'Agente;
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.
Infine, troverai anche una checkbox "mostra contesto per messaggio": attivando questa opzione, sarai in grado di vedere quale contesto è stato impostato per ciascun messaggio.
Nel resto della finestra, troverai 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 gli eventi tecnici che avvengono durante una conversazione, in particolare gli eventuali errori riscontrati dai provider AI (es. chiave API errata, rate limits raggiunti, contesto superato, ecc.).
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 pulsante "Copy ALL Responses" per copiare negli appunti il log;
Un log tecnico completo della conversazione, organizzato in una tabella con le seguenti colonne:
Time: timestamp preciso dell'evento (es. 2025-07-11T08:24:02.3168982Z);
LogType: tipologia di evento (es. "audit");
Method: metodo HTTP utilizzato;
Path: endpoint API chiamato;
Status: codice di stato HTTP della risposta;
Result Code: codice di risultato interno dell'operazione;
Result Message: messaggio di stato dell'operazione (es. "Ok");
Details: risposta dell'API in formato JSON.
Il debug avanzato è uno strumento tecnico destinato principalmente a sviluppatori e amministratori per il monitoraggio approfondito delle conversazioni e di eventuali errori tecnici.
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