> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/condivisione/conversations/conversation-history-and-resume.md). # Cronologia e ripresa della conversazione La cronologia delle chat consente agli utenti di accedere alle conversazioni precedenti con un Agente AIsuru, esaminarle, gestirle e riprenderle. Invece di considerare ogni interazione come uno scambio isolato, gli utenti possono tornare alle conversazioni precedenti e continuare da dove avevano interrotto. ### Apri la cronologia delle chat La cronologia delle chat è disponibile nei widget AIsuru senza richiedere configurazioni aggiuntive da parte del creatore dell'Agente. Per aprirla: 1. trova l'icona della cronologia delle chat nella barra degli strumenti del widget; 2. selezionala per aprire la pagina della cronologia; 3. sfoglia le conversazioni precedenti con l'Agente. > **Nota:** La cronologia delle chat è disponibile anche quando usi l'Agente in modalità **Prova**. ### Sfoglia e filtra le conversazioni La pagina della cronologia offre controlli per trovare ed esaminare le chat precedenti. #### Scarica la chat corrente Puoi scaricare la conversazione che stai visualizzando come file `.txt`. #### Filtra per data I filtri temporali documentati includono: * Tutti; * Oggi; * Ieri; * Ultimi 7 giorni; * Ultimi 30 giorni. #### Filtra per numero minimo di messaggi Puoi anche filtrare le conversazioni in base al numero minimo di messaggi. Le opzioni documentate includono: * Qualsiasi; * 2; * 3; * 5; * 10; * 15; * 20; * un valore personalizzato. ### Come vengono visualizzate le conversazioni Ogni conversazione nella cronologia include informazioni che ti aiutano a identificarla rapidamente. #### Titolo automatico Il titolo della conversazione viene generato automaticamente dal primo messaggio dell'utente. Se il messaggio è troppo lungo, il titolo viene troncato con `...` per mantenere leggibile l'elenco. #### Data, ora, messaggi e contenuti multimediali La cronologia mostra anche informazioni quali: * la data e l'ora di inizio della conversazione; * il numero di messaggi e contenuti multimediali scambiati. Le conversazioni sono ordinate dalla più recente alla meno recente. ### Apri una conversazione precedente Seleziona una conversazione dall'elenco per aprirne la cronologia completa. La vista dettagliata conserva: * tutti i messaggi scambiati nella conversazione; * il contesto della conversazione e i dati della sessione; * la familiare presentazione del widget originale. ### Riprendi una conversazione Dalla vista dettagliata della conversazione, usa **Riprendi** per continuare la chat. Quando una conversazione viene ripresa: * l'utente torna alla discussione precedente; * l'Agente continua con il contesto di quella conversazione; * l'ambiente della conversazione originale viene ripristinato; * la chat riprende utilizzando la configurazione del widget/layout corrispondente. Questa funzione è utile quando una conversazione si sviluppa nel tempo o quando l'utente deve tornare alle informazioni discusse in precedenza. ### Cronologia delle conversazioni e privacy Il comportamento documentato della cronologia chat include le seguenti protezioni: * ogni utente vede solo le proprie conversazioni; * le conversazioni rimangono disponibili dopo la chiusura del browser; * le conversazioni sono associate all'account utente; * la gestione della cronologia non richiede interventi manuali da parte del creatore dell'Agente. ### ID di sessione e ripresa della conversazione Ogni conversazione ha un `sessionID` univoco. Quando un utente riprende una conversazione tramite la cronologia della chat, AIsuru ripristina la sessione associata a quella conversazione. Questo rende le informazioni sulla sessione rilevanti anche per integrazioni avanzate ed esperienze basate su API. > **Per gli sviluppatori:** La cronologia della chat rivolta agli utenti e la ripresa programmatica della sessione non devono essere considerate lo stesso flusso di lavoro. L'attuale documentazione Frontend indica che, quando un `sessionID` viene fornito direttamente a un componente, AIsuru lo convalida: una sessione valida ripopola la chat, mentre una sessione non valida avvia una nuova conversazione. Tale documentazione Frontend indica inoltre che le sessioni riprese direttamente scadono dopo un'ora di inattività. Segui l'attuale documentazione Frontend quando implementi la persistenza delle sessioni a livello programmatico. Per la gestione delle sessioni controllata dallo sviluppatore, consulta la documentazione su Advanced embed and web integration e la documentazione Frontend **Ripresa della sessione**. ### Perché la cronologia della chat è utile #### Per gli utenti La cronologia della chat offre: * **continuità:** le conversazioni possono proseguire nel tempo invece di ricominciare da zero; * **riferimento storico:** gli utenti possono rivedere informazioni, suggerimenti o risposte ricevuti in precedenza; * **flessibilità:** gli utenti possono interrompere una conversazione e riprenderla in seguito; * **meno ripetizioni:** le informazioni già discusse restano disponibili nella chat precedente. #### Per i creatori di Agenti Le conversazioni persistenti possono favorire: * un maggiore coinvolgimento degli utenti di ritorno; * conversazioni più lunghe e articolate; * un'interazione meno ripetitiva; * una migliore comprensione di come gli utenti interagiscono con l'Agente nel tempo. ### Buone pratiche Per rendere più utile la ripresa delle conversazioni: 1. progetta le conversazioni in modo che gli utenti possano riprenderle naturalmente in seguito; 2. usa in modo appropriato i riferimenti temporali quando l'Agente fa riferimento a parti precedenti di una discussione; 3. struttura i flussi conversazionali in modo che possano progredire attraverso più interazioni; 4. verifica regolarmente l'esperienza di ripresa.