> 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/avanzate/backup-trasferimento-e-cancellazione-di-un-agente.md).

# 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** <img src="/files/amu3T8RmvmSvw48RQTc6" alt="" data-size="line"> **impostazioni >** ![](/files/4sshSgqS8U48WRbrV0op) **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.

| Dati mantenuti nel file zip | Dati non mantenuti nel file zip                    |
| --------------------------- | -------------------------------------------------- |
| Ruoli                       | Layout (viene mantenuto solo il layout di default) |
| Contenuti                   | Followers                                          |
| Dizionario                  | Conversazioni                                      |
| Funzioni                    | MCP                                                |
| Storico Import              | Statistiche                                        |

#### 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:

### 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](http://www.aisuru.com) o l'indirizzo della tua [PaaS](/paas.md));
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.

{% hint style="danger" %}
Una volta trasferito, l'Agente non sarà più accessibile dal tuo account. **Se vuoi continuare a gestirlo, dovrai farti** [**invitare come autore**](/avanzate/gestione-utenti-persone/invito-e-gestione-degli-autori.md) dall'utente a cui hai trasferito l'Agente.
{% endhint %}

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.

{% hint style="danger" %}
Una volta eliminato, l'Agente **non potrà essere recuperato in alcun modo**.
{% endhint %}

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**.
