# 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

*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 <img src="/files/YNKRzTAPvJtxs2uGe2RT" alt="" data-size="line"> **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 un ruolo specifico;
      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](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**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/avanzate/backup-trasferimento-e-cancellazione-di-un-agente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
