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:

  1. Accedi alle impostazioni > Gestisci del tuo Agente

  2. Nella sezione "Esporta questo Agente", clicca sul pulsante ESPORTA

  3. 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:

  1. Accedi al pannello di gestione dell'Agente

  2. Vai alla sezione Import / Export

  3. 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:

  1. Individua il pulsante "Esporta" nella parte inferiore della pagina

  2. 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:

  1. Vai all'homepage della piattaforma dove trovi la lista dei tuoi Agenti

  2. Premi sul tasto Importa situato in alto a destra sopra la sezione dei tuoi Agenti

  3. Si aprirà un popup per caricare il file zip

  4. Dopo il caricamento, riceverai un messaggio "Caricamento completato con successo"

  5. Apparirà un popup dove potrai dare un nome al nuovo Agente

  6. 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:

  1. Accedere al pannello di gestione del tuo Agente;

  2. Se necessario, cancellare i contenuti attualmente presenti nell'Agente;

  3. Premere su Import / Export nella barra laterale;

  4. Seleziona la scheda Importa CSV;

  5. Clicca su "Choose file" o trascina il tuo file CSV nell'area designata;

  6. Configura le impostazioni presenti ->

    1. Avanzate ->

      1. Separatore colonne CSV: specifica il carattere usato per separare le colonne (es. virgola);

      2. Separatore varianti della domanda: indica il carattere per separare le varianti;

      3. Spunta "il CSV contiene i nomi di colonna" se la prima riga contiene le intestazioni;

      4. Assegnato a: scegli se i contenuti saranno "Pubblico" o assegnati a una persona specifica;

      5. Link: puoi indicare un URL da allegare a tutte le domande importate.

    2. Assegnazione delle colonne per la domanda (obbligatorio), per la risposta (obbligatorio) e per gli argomenti necessari e quelli da impostare (opzionali).

    3. 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;

  7. Verifica l'anteprima dei contenuti nella tabella sottostante -> assicurati che tutto sia configurato correttamente;

  8. Lancia l'importazione premendo su "Importa il CSV e i dati selezionati".

Trasferimento di proprietà

Per trasferire un Agente ad un altro utente:

  1. Clicca sul pulsante "TRASFERISCI";

  2. Nel popup che appare, seleziona la piattaforma. Di default, viene mostrata la piattaforma attuale (www.aisuru.com o l'indirizzo della tua PaaS);

  3. Inserisci il nome utente o l'email del destinatario;

  4. Conferma l'operazione scrivendo il nome esatto dell'Agente (rispettando maiuscole e minuscole);

  5. Clicca su "Trasferisci" per completare l'operazione.

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:

  1. Clicca sul pulsante "ELIMINA";

  2. Nel popup di conferma, scrivi il nome esatto dell'Agente (rispettando maiuscole e minuscole);

  3. Clicca su "Elimina" per confermare.

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