Cronologia delle conversazioni
Lo storico delle conversazioni è una potente funzionalità di AIsuru che ti consente di rivedere e analizzare tutte le interazioni passate del tuo Agente. È essenziale per monitorarne l'utilizzo e migliorarne le prestazioni.
Nota: Solo gli utenti che hanno creato l'Agente o che sono stati invitati come "autori" possono accedere alle conversazioni dell'Agente.
Accesso allo storico delle conversazioni
Lo storico delle conversazioni ti consente di rivedere e analizzare tutte le conversazioni che il tuo Agente ha avuto — con te e con altri utenti. Ecco come accedervi:
Dalla homepage di AIsuru, trova l'Agente di cui vuoi visualizzare le conversazioni;
Fai clic sul pulsante "Gestisci" dell'Agente selezionato;
Nella barra laterale di gestione dell'Agente, trova e seleziona Conversazioni.
Visualizzazione dell'elenco delle conversazioni
Nella pagina principale dello storico troverai un elenco dettagliato di tutte le conversazioni. Ogni riga contiene le seguenti informazioni:
Titolo: un titolo distintivo per identificare la conversazione;
Email: l'indirizzo email dell'utente che ha interagito con l'Agente;
Data di inizio della conversazione: quando è iniziata l'interazione;
Messaggi: il numero di messaggi scambiati;
Durata: quanto è durata la conversazione.
Media: questa colonna indica se durante la conversazione erano presenti immagini o sono state eseguite funzioni;
Azioni: troverai i pulsanti Apri ed Elimina.
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 ti consente di trovare le conversazioni utilizzando i seguenti criteri:
Parola chiave: cerca parole chiave nel contenuto delle conversazioni;
Nome utente: filtra per mostrare solo le conversazioni di un utente specifico che ha effettuato l'accesso alla piattaforma (se un utente non ha effettuato l'accesso tramite email, apparirà come anonimo);
Email: filtra le conversazioni in base all'indirizzo email specifico dell'utente che ha chattato con l'Agente;
ID sessione: filtra in base all'identificatore univoco della sessione.
Esempio di utilizzo: digita "refund" nella barra di ricerca per trovare tutte le conversazioni che menzionano quella parola chiave.
Selettore dell'intervallo di date
Facendo clic sul selettore dell'intervallo di date, situato accanto alla barra di ricerca, si apre un calendario a discesa che ti consente di scegliere un intervallo di tempo personalizzato con una data di inizio e una data di fine, così puoi filtrare le conversazioni per un periodo specifico.
Esempio di utilizzo: seleziona "01/12/2024 - 14/12/2024" per vedere solo le conversazioni delle prime due settimane di dicembre.
Filtro per il numero minimo di messaggi
Il filtro per il numero minimo di messaggi è un menu a discesa che ti consente di filtrare le conversazioni in base alla lunghezza. Le opzioni disponibili sono:
Qualsiasi messaggio: mostra tutte le conversazioni (senza filtri applicati);
Almeno 2/3/5/10/15/20 messaggi: mostra solo le conversazioni con almeno quel numero di messaggi;
Imposta minimo: consente di specificare un numero minimo personalizzato di messaggi per mostrare solo le chat che soddisfano il filtro.
Pulsante di download aggiuntivo
Subito sotto il nome utente dell'utente, puoi premere un pulsante con 3 linee per accedere a 2 funzionalità distinte:
Scarica conversazioni: scarica lo storico completo delle conversazioni in formato HTML;
Notifiche: premi questa opzione per accedere direttamente alla sezione preferenze delle notifiche.
Pulsanti di gestione
Nella sezione Conversazioni del pannello di gestione dell'Agente, oltre al pulsante Aggiorna, troverai anche un pulsante Preferenze delle notifiche.
Il pulsante Preferenze delle notifiche ti porta direttamente alla sezione "Impostazioni > Notifiche" dell'Agente, consentendoti di gestire rapidamente le preferenze delle notifiche senza navigare nel menu principale. È particolarmente utile quando monitori le conversazioni e vuoi modificare rapidamente le impostazioni delle notifiche.
Dettagli della conversazione
Dopo aver premuto il pulsante Apri, si aprirà una nuova scheda con i dettagli della conversazione selezionata. In alto a destra, puoi premere il pulsante per scaricare la conversazione come file.txt e fare clic su "Mostra info" per aprire alcune impostazioni avanzate.
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 (ad es. 10:22:05).
Mostra info
Il pannello Dettagli della conversazione si apre facendo clic su "Mostra info" e contiene le informazioni principali:
Data di inizio della conversazione: la data e l'ora di inizio della conversazione (ad es. 11/07/2025, 10:22:04);
Username: il nome utente (se l'utente aveva effettuato l'accesso prima di interagire con l'Agente);
Email: l'indirizzo email dell'utente;
Lingua: la lingua utilizzata dall'utente durante la conversazione.
Informazioni sulla sessione
La sezione Informazioni sulla sessione include dettagli tecnici sulla sessione:
ID sessione: l'identificativo univoco della conversazione (ad es. 5c75befa-7edd-442b-9a13-e9b9a3a63d2e);
Pulsante DEBUG: consente di accedere al debug avanzato della conversazione;
Referral: l'URL dal quale l'utente ha interagito con l'Agente;
Indirizzo IP: viene mostrato l'indirizzo IP — premendo "Info" puoi ottenere ulteriori dettagli (ad es. la posizione associata all'indirizzo IP);
User agent: informazioni sul browser e sul sistema operativo dell'utente.
Infine, nella parte inferiore della schermata troverai anche:
Una casella di controllo "mostra contesto per messaggio": attivando questa opzione puoi vedere quale contesto è stato impostato per ciascun messaggio;
Una casella di controllo "mostra consumi per messaggio": se abilitata, puoi visualizzare varie statistiche, come il numero di token, le metriche di impatto ambientale e il consumo d'acqua di ciascun messaggio.
Due pulsanti di navigazione per avanzare e tornare indietro tra le conversazioni dell'Agente.
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 insetto.
Facendo clic sull'icona puoi vedere:
Quale funzione è stata chiamata (ad es. "Chiamata di funzione a 'FUNCTION_NAME' in data [call_timestamp]");
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;
Eseguire il debug dei problemi con le integrazioni esterne.
Inoltre, quando l'IA utilizza funzioni per generare risposte, tali risultati vengono salvati automaticamente come testi preformattati nella sezione dei contenuti generati dall'IA, dove puoi convalidarli e trasformarli in contenuti fissi.
Debug avanzato delle conversazioni
Oltre al debug specifico delle funzioni, AIsuru offre una funzionalità di debug avanzato che ti consente di monitorare gli eventi tecnici che si verificano durante una conversazione, in particolare gli eventuali errori riscontrati dai provider IA (ad es. chiave API errata, limiti di frequenza raggiunti, contesto superato, ecc.).
Accesso al debug avanzato
Per accedere al debug avanzato:
Apri i dettagli di una conversazione dalla sezione Conversazioni;
Fai clic su "Mostra info" e poi su "Informazioni sulla sessione";
Fai clic sul pulsante DEBUG nella pagina dei dettagli della conversazione, accanto all'ID sessione.
Informazioni visualizzate nel pannello di debug
Il pannello di debug mostra:
Un pulsante "Copy ALL Responses" per copiare il log negli appunti;
Un log tecnico completo della conversazione, organizzato in una tabella con le seguenti colonne:
Time: timestamp preciso dell'evento (ad esempio 2025-07-11T08:24:02.3168982Z);
LogType: tipo di evento (ad esempio "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 (ad esempio "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.
Visualizzare le conversazioni in tempo reale
Con AIsuru puoi anche vedere le conversazioni che i tuoi utenti stanno avendo in questo momento. Ti basterà:
Vai alla sezione Conversazioni del tuo Agente;
Apri la conversazione che ti interessa (di solito l'ultima);
Aggiorna la pagina per verificare la presenza di 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.
Ultimo aggiornamento