> 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 ed eliminazione di un Agente

AIsuru ti consente di scaricare un backup di un Agente, trasferirne la proprietà a un altro utente o eliminarlo definitivamente. Queste operazioni sono irreversibili, quindi è importante procedere con cautela.

### Come accedere alle opzioni di gestione

Per trasferire o eliminare un Agente, **vai a** **Impostazioni >** **Gestisci** per il tuo Agente. Da qui puoi scegliere se eliminare o trasferire il tuo Agente.

### Backup di un Agente

AIsuru offre due metodi complementari per eseguire il backup dei tuoi Agenti:

#### 1. Esportazione completa dell'Agente

L'esportazione completa ti consente di esportare l'intero Agente come file zip, comprese tutte le impostazioni e i contenuti multimediali associati:

1. Vai a **Impostazioni > Gestisci** per il tuo Agente;
2. Nella sezione "Esporta questo Agente", fai clic sul pulsante **EXPORT**;
3. Attendi che il file zip venga scaricato.

Il file zip esportato contiene:

* Un file JSONL con tutte le impostazioni e le configurazioni dell'Agente;
* Una cartella "media" con tutti i file multimediali allegati ai tuoi contenuti.

Questo metodo di backup è ideale per:

* Creare backup completi del tuo Agente;
* Trasferire un Agente identico a un'altra istanza di AIsuru.
* Eseguire test A/B creando copie modificate dello stesso Agente.

| Dati conservati nel file zip  | Dati non conservati nel file zip                    |
| ----------------------------- | --------------------------------------------------- |
| Ruoli                         | Layout (viene mantenuto solo il layout predefinito) |
| Contenuti                     | Follower                                            |
| Dizionario                    | Conversazioni                                       |
| Funzioni                      | MCP                                                 |
| Cronologia delle importazioni | Statistiche                                         |

#### 2. Esportazione CSV dei contenuti

Per un backup più leggero incentrato solo sui contenuti testuali:

1. Vai al pannello di gestione dell'Agente;
2. Vai alla sezione **Importa / Esporta**;
3. Seleziona la scheda **"Esporta CSV"**.

#### **Configurazione dell'esportazione**

Prima di esportare, puoi personalizzare vari aspetti del file CSV risultante:

* Apri la sezione **"Avanzate"** nella pagina di esportazione;
* Configura le seguenti opzioni secondo necessità:
  * Separatore delle colonne CSV;
  * Separatore delle varianti di domanda;
  * Nomi delle colonne per Domanda, Risposta, Argomenti richiesti e Argomenti da impostare.

#### **Esecuzione del backup**

Dopo aver configurato le opzioni:

1. Trova il pulsante "Esporta" nella parte inferiore della pagina;
2. Fai clic 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 CSV esportato è uno strumento versatile che puoi utilizzare per:

* Creare una copia di backup 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 o altre personalizzazioni dei contenuti;
* Contiene solo domanda, varianti di domanda, risposta, altre risposte, argomenti impostati, argomenti richiesti e tag;
* Non salva le istruzioni né le impostazioni funzionali ed estetiche del tuo Agente.

### Importazione di un Agente completo

Per importare un Agente precedentemente esportato:

1. Vai alla homepage della piattaforma, dove viene mostrato l'elenco dei tuoi Agenti.
2. Fai clic sul pulsante **Import** in alto a destra, sopra i tuoi Agenti;
3. Si aprirà un popup per caricare il file zip;
4. Dopo il caricamento, vedrai un messaggio "Caricamento completato con successo";
5. Apparirà un popup in cui potrai assegnare un nome al nuovo Agente;
6. Fai clic su "Importa" per avviare il processo.

Durante l'importazione:

* Una notifica in alto a destra ti terrà aggiornato sull'avanzamento;
* Vedrai prima un messaggio "In corso" seguito dal numero di elementi elaborati sul totale;
* Al completamento, la notifica mostrerà "Importazione completata";
* Puoi gestire il tuo nuovo Agente facendo clic su "Gestisci" nella notifica.

{% hint style="warning" %} <mark style="color:orange;">Se l'importazione non riesce (ad esempio, a causa di un file zip danneggiato o di un nome di Agente già esistente), la notifica in alto a destra mostrerà "Importazione fallita".</mark>
{% endhint %}

### Come importare il file CSV

Per importare il file CSV in un Agente, puoi:

### Trasferimento di proprietà

Per trasferire un Agente a un altro utente:

1. Fai clic sul pulsante **"TRASFERISCI"**;
2. Nel popup visualizzato, seleziona la piattaforma. Per impostazione predefinita, viene mostrata la piattaforma corrente ([www.aisuru.com](http://www.aisuru.com) oppure il tuo indirizzo [PaaS](/paas.md));
3. Inserisci il nome utente o l'email del destinatario;
4. Conferma l'operazione digitando il nome esatto dell'Agente (con distinzione tra maiuscole e minuscole);
5. Fai clic su "Trasferisci" per completare l'operazione.

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

Note importanti sul trasferimento:

* Se inserisci un nome utente inesistente o un'email non associata ad alcun account, il trasferimento non riuscirà e manterrai la proprietà dell'Agente;
* Il trasferimento è irreversibile: una volta completato, solo il nuovo proprietario può gestire l'Agente.

### Eliminazione dell'Agente

Per eliminare permanentemente un Agente:

1. Fai clic sul pulsante "ELIMINA";
2. Nel popup di conferma, inserisci il nome esatto dell'Agente (con distinzione tra maiuscole e minuscole);
3. Fai clic su "Elimina" per confermare.

{% hint style="danger" %} <mark style="color:red;">Una volta eliminato, l'Agente</mark> <mark style="color:red;">**non può essere recuperato in alcun modo**</mark><mark style="color:red;">.</mark>
{% endhint %}

Prima di procedere con l'eliminazione, considera:

* **Effettuare un backup** dei contenuti se desideri conservarli.
* **Verificare che nessun altro utente o servizio dipenda da questo Agente.**