Backup, trasferimento e cancellazione di un Agente
AIsuru ti permette di scaricare un backup di un Agente, trasferirne la proprietà ad un altro utente o di eliminarlo definitivamente. Queste operazioni sono irreversibili, quindi è importante procedere con cautela.
Come accedere alle opzioni di gestione
Per trasferire o eliminare un Agente, accedi alle 
impostazioni > 
Gestisci del tuo Agente. Qui potrai scegliere se cancellare o trasferire il tuo Agente.
Backup di un Agente
AIsuru offre due metodi complementari per eseguire il backup dei tuoi Agenti:
1. Export completo dell'Agente
La funzione di export completo ti permette di esportare l'intero Agente in un file zip, includendo tutte le impostazioni e i media associati:
Accedi alle impostazioni > Gestisci del tuo Agente
Nella sezione "Esporta questo Agente", clicca sul pulsante ESPORTA
Attendi il completamento del download del file zip
Il file zip esportato contiene:
Un file JSONL con tutte le impostazioni e configurazioni dell'Agente
Una cartella "media" con tutti i file multimediali allegati ai contenuti
Questa modalità di backup è ideale per:
Creare copie di backup complete del tuo Agente
Trasferire un Agente identico su un'altra istanza di AIsuru
Effettuare test A/B creando copie modificate dello stesso Agente
Nota: attualmente, il file ZIP non contiene i layout di condivisione creati.
2. Export CSV dei contenuti
Per un backup più leggero focalizzato solo sui contenuti testuali:
Accedi al pannello di gestione dell'Agente
Vai alla sezione Import / Export
Seleziona la scheda "Esporta CSV"
Configurazione dell'esportazione
Prima di procedere con l'esportazione, puoi personalizzare vari aspetti del file CSV risultante:
Apri la sezione "Avanzate" nella pagina di esportazione
Configura le seguenti opzioni secondo le tue preferenze:
Separatore colonne CSV
Separatore varianti della domanda
Nomi delle colonne per Domanda, Risposta, Argomenti necessari e Argomenti da impostare
Esecuzione del backup
Una volta configurate le opzioni:
Individua il pulsante "Esporta" nella parte inferiore della pagina
Clicca su "Esporta" per avviare il download del file CSV
Il tuo browser salverà automaticamente il file nella cartella download predefinita.
Utilizzo del file di backup
Il file CSV esportato è uno strumento versatile che puoi utilizzare per:
Creare una copia di sicurezza dei contenuti testuali del tuo Agente
Trasferire facilmente i contenuti tra diversi Agenti o piattaforme esterne
Analizzare e modificare i contenuti usando fogli di calcolo
Condividere la base di conoscenza con il tuo team o altri stakeholder
Limiti del backup CSV
Il backup del tuo Agente in formato CSV presenta alcuni limiti:
Non include media, link e altre personalizzazioni dei contenuti
Contiene solo domanda, varianti di domanda, risposta, altre risposte, argomenti impostati, argomenti necessari, tag
Non salva le istruzioni e le impostazioni funzionali ed estetiche del tuo Agente
Import di un Agente completo
Per importare un Agente precedentemente esportato:
Vai all'homepage della piattaforma dove trovi la lista dei tuoi Agenti
Premi sul tasto Importa situato in alto a destra sopra la sezione dei tuoi Agenti
Si aprirà un popup per caricare il file zip
Dopo il caricamento, riceverai un messaggio "Caricamento completato con successo"
Apparirà un popup dove potrai dare un nome al nuovo Agente
Clicca su "Importa" per avviare il processo
Durante l'importazione:
Una finestra in alto a destra ti informerà sull'andamento del processo
Vedrai prima un messaggio "In corso" seguito dal numero di elementi processati sul totale
Al completamento, la finestra mostrerà "Importazione completata"
Potrai gestire il tuo nuovo Agente premendo sul tasto "Gestisci" nella finestra
In caso di errore nell'import (es. file zip corrotto o nome Agente già presente), la finestra in alto a destra mostrerà il messaggio "Importazione fallita".
Come importare il file CSV
Per importare il file CSV all'interno di un Agente dovrai:
Accedere al pannello di gestione del tuo Agente;
Se necessario, cancellare i contenuti attualmente presenti nell'Agente;
Premere su
Import / Export nella barra laterale;Seleziona la scheda Importa CSV;
Clicca su "Choose file" o trascina il tuo file CSV nell'area designata;
Configura le impostazioni presenti ->
Avanzate ->
Separatore colonne CSV: specifica il carattere usato per separare le colonne (es. virgola);
Separatore varianti della domanda: indica il carattere per separare le varianti;
Spunta "il CSV contiene i nomi di colonna" se la prima riga contiene le intestazioni;
Assegnato a: scegli se i contenuti saranno "Pubblico" o assegnati a una persona specifica;
Link: puoi indicare un URL da allegare a tutte le domande importate.
Assegnazione delle colonne per la domanda (obbligatorio), per la risposta (obbligatorio) e per gli argomenti necessari e quelli da impostare (opzionali).
Opzioni di importazione:
Forza importazione: importa tutti i contenuti, anche se la domanda è già presente tra i contenuti (di default, queste domande non sono importate);
Importa tutti i contenuti come conclusivi;
Importa tutti i contenuti come non casuali;
Aggiungi "argomenti impostati" a tutti i contenuti: di default, viene aggiunto un argomento con il nome del file che stai importando e con la data dell'import;
Verifica l'anteprima dei contenuti nella tabella sottostante -> assicurati che tutto sia configurato correttamente;
Lancia l'importazione premendo su "Importa il CSV e i dati selezionati".
Trasferimento di proprietà
Per trasferire un Agente ad un altro utente:
Clicca sul pulsante "TRASFERISCI";
Nel popup che appare, seleziona la piattaforma. Di default, viene mostrata la piattaforma attuale (www.aisuru.com o l'indirizzo della tua PaaS);
Inserisci il nome utente o l'email del destinatario;
Conferma l'operazione scrivendo il nome esatto dell'Agente (rispettando maiuscole e minuscole);
Clicca su "Trasferisci" per completare l'operazione.
Una volta trasferito, l'Agente non sarà più accessibile dal tuo account. Se vuoi continuare a gestirlo, dovrai farti invitare come autore dall'utente a cui hai trasferito l'Agente.
Note importanti sul trasferimento:
Se inserisci un nome utente inesistente o un'email non associata ad alcun account, il trasferimento fallirà e manterrai la proprietà dell'Agente;
Il trasferimento è irreversibile: una volta completato, solo il nuovo proprietario potrà gestire l'Agente.
Eliminazione dell'Agente
Per eliminare permanentemente un Agente:
Clicca sul pulsante "ELIMINA";
Nel popup di conferma, scrivi il nome esatto dell'Agente (rispettando maiuscole e minuscole);
Clicca su "Elimina" per confermare.
Una volta eliminato, l'Agente non potrà essere recuperato in alcun modo.
Prima di procedere con l'eliminazione, considera di:
Effettuare un backup dei contenuti se desideri conservarli;
Verificare che nessun altro utente o servizio dipenda da questo Agente.
Last updated