> 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/paas/pannello-di-amministrazione/gestione-utenti-della-paas.md).

# Gestione Utenti della PaaS

La sezione **Gestione Utenti** del pannello di amministrazione ti permette di amministrare tutti gli account utente della tua piattaforma PaaS. Questa funzionalità ti offre un controllo completo su accessi, permessi e monitoraggio dell'utilizzo delle risorse.

### Panoramica della sezione

La gestione utenti è organizzata in due schede principali:

* **Gestione utenti**: amministrazione diretta degli account utente;
* **Andamento iscrizioni**: analytics e statistiche sulle registrazioni.

***

### Scheda Gestione Utenti

#### Strumenti di gestione

La scheda principale offre diversi strumenti per amministrare gli utenti:

* **Filtro per periodo di iscrizione**: visualizza utenti registrati in un intervallo temporale specifico;
* **Ricerca per nome e email**: trova rapidamente utenti specifici;
* **Filtro per codice promozionale**: identifica utenti che hanno utilizzato specifici codici promo;
* **Creazione nuovo utente**: aggiungi manualmente nuovi account tramite invito;
* **Aggiornamento pagina**: ricarica i dati più recenti;
* **Esportazione dati**: esporta la lista utenti in formato CSV.

#### Colonne della tabella utenti

La tabella mostra le seguenti informazioni per ogni utente:

* **Email**: indirizzo email dell'utente;
* **Username**: nome utente per l'accesso;
* **Creato il**: data e ora di registrazione;
* **Agenti**: numero di Agenti creati dall'utente;
* **Chat**: numero di chat effettuate dall'utente;
* **IA**: numero di risposte IA generate dagli Agenti dell'utente;
* **Import**: numero di pagine importate;
* **Pagante**: stato dell'account (indicato con ✓ se pagante). Se l'utente è pagante, consumerà i messaggi di AI generativa e le pagine di importazione;
* **Referral**: link di riferimento dell'utente (icona link);
* **Azioni**: operazioni disponibili (modifica ed elimina).

***

### Come invitare un utente nella tua PaaS

Per aggiungere un nuovo utente alla tua piattaforma:

1. Nella scheda **Gestione utenti**, clicca sul pulsante **"Creazione nuovo utente"**;
2. Compila i seguenti campi obbligatori:

**Informazioni base**

* **Username**: nome utente per l'accesso;
* **Email**: indirizzo email dell'utente (riceverà l'invito a questo indirizzo);
* **Data di nascita**: informazione demografica (utente deve essere maggiorenne).

**Permessi**

Seleziona i permessi che vuoi assegnare all'utente:

* **Amministratore**: accesso completo al pannello di amministrazione;
* **Può creare Agenti**: permesso di creazione di nuovi Agenti;
* **Abilita Pensiero Profondo**: accesso alla possibilità di attivare Pensiero Profondo sul proprio agente ( [Pensiero Profondo](/estensioni/pensiero-profondo.md));
* **Abilita spazi virtuali**:  accesso alla possibilità di attivare gli ambienti virtuali ( [Spazi Virtuali (VR e MR)](/estensioni/spazi-virtuali-vr-e-mr.md));
* **Può modificare la concatenazione di Agenti e Gruppi di Esperti**: accesso alla possibilità di creare i Gruppi di Esperti (vedi [Gruppo di esperti](/estensioni/gruppo-di-esperti.md));
* **Può modificare integrazioni DCM**: accesso alla possibilità di modificare l'integrazione DCM (vedi [Open Badge](/estensioni/open-badge.md));
* **Abilita badge**: accesso alla possibilità di modificare l'integrazione DCM (vedi [Open Badge](/estensioni/open-badge.md)).

🔑 **Importante**: Se impostati, questi permessi oltrepasseranno i limiti globali.

3. Conferma l'operazione;
4. **L'utente riceverà una email di invito** con un **magic link** per accedere direttamente alla piattaforma.

#### Differenza tra Utente e Amministratore

* **Utente standard**: ha accesso solo alle funzionalità di creazione e gestione degli Agenti in cui è autore, senza possibilità di vedere o accedere al pannello di amministrazione;
* **Amministratore**: può accedere alla tab **Admin** e gestire tutti gli aspetti della piattaforma, inclusa la gestione degli altri utenti.

***

### Altre azioni disponibili

#### Modifica Utente

L'opzione **Modifica** permette di personalizzare l'account utente. Le informazioni che un admin può modificare per ogni utente sono le stesse in fase di creazione

#### Eliminazione Utente

L'opzione **Elimina** rimuove definitivamente un utente:

1. Clicca su **Elimina** nelle azioni utente;
2. Conferma l'operazione nella finestra di dialogo;
3. L'utente e tutti i contenuti associati verranno cancellati.

🔴 **Attenzione**: l'eliminazione è irreversibile e comporta la perdita di tutti i dati dell'utente.

***

### Scheda Andamento Iscrizioni

#### Analytics delle registrazioni

La seconda scheda offre grafici e statistiche sulle iscrizioni:

**Filtro disponibile**

* **Seleziona periodo**: visualizza dati per intervalli temporali (30 giorni, 90 giorni, personalizzato).

**Metriche visualizzate**

* **Nuovi utenti**: grafico temporale delle registrazioni (es. 183 utenti nel periodo selezionato);
* **Utenti per referral**: analisi delle fonti di registrazione con URL di provenienza.

***

### Best practices

* Monitora regolarmente i consumi per identificare utenti che potrebbero necessitare di limiti personalizzati;
* Assegna i permessi con criterio per mantenere la sicurezza della piattaforma;
* Utilizza i filtri per analizzare trend di crescita e pattern di utilizzo;
* Esporta i dati periodicamente per analisi avanzate e backup;
* Controlla i referral per identificare canali di acquisizione più efficaci;
* Distingui chiaramente tra utenti standard e amministratori per mantenere una corretta governance della piattaforma.

La sezione Gestione Utenti ti offre il controllo completo sulla community della tua piattaforma, permettendoti di scalare in modo efficiente e sicuro mantenendo un'esperienza utente ottimale.
