# Creazione e gestione dei Ruoli

I Ruoli in AIsuru sono la chiave per creare esperienze personalizzate con i tuoi Agenti. Questo potente strumento ti permette di adattare le risposte dell'Agente in base a ruoli o categorie specifiche di utenti, rendendo le interazioni più rilevanti ed efficaci.

### Creazione di un nuovo Ruolo

Per aggiungere un nuovo Ruolo al tuo Agente:

1. Dalla barra laterale, seleziona la voce "Ruoli;
2. Clicca sul pulsante <img src="/files/DvAnTQ6IXRT35xwLXw2t" alt="" data-size="line"> **Nuovo ruolo**;
3. Definisci le informazioni richieste:

   1. Nome: assegna un nome descrittivo (es. "Direttore", "Cliente VIP");
   2. Informazioni: assegna una descrizione a questo ruolo;
   3. Seleziona un'emoji come Tag;
   4. (Opzionale) Personalizza il Pin (dovrà rimanere un codice numerico di 6 cifre).

   *Tag e Pin della persona possono essere utilizzati per accedere con quel ruolo specifico all'Agente tramite API.*
4. Premi "Conferma" per confermare.

### Assegnare gli utenti a ruoli specifici

Puoi assegnare gli utenti che sono già registrati in piattaforma a ruoli specifici:

1. Vai alla sezione Ruoli del tuo Agente;
2. Identifica il Ruolo di tuo interesse nella tabella;
3. Premi sul tasto **Invita** a destra nella stessa riga del Ruolo e poi fai clic su <img src="/files/DvAnTQ6IXRT35xwLXw2t" alt="" data-size="line"> **Aggiungi**;
4. Aggiungi l'indirizzo mail e, se vuoi, personalizza il messaggio;
5. Premi il tasto ![](/files/iPm1UOJGQBXh0tsmVX0F) **Invia** per confermare l'assegnazione.

✅ Fine! D'ora in avanti, gli utenti invitati che conversano con l'Agente accederanno con il Ruolo a cui li hai assegnati.

#### E gli utenti non registrati?

Puoi far sì che gli utenti non registrati accedano automaticamente con un certo ruolo. Per farlo:

* **Crea un Ruolo "Utenti non registrati"** e non invitare nessuno;
* Vai alla sezione Condividimi dalla barra laterale e premi su **Aggiungi Layout**;
* Nei [parametri avanzati](/condivisione/crea-e-gestisci-i-layout-di-condivisione.md#configurazione-avanzata-del-layout), **imposta "Utenti non registrati" come ruolo**;
* **Imposta il layout come default**.

D'ora in poi, tutti gli utenti non registrati avranno un Ruolo ad hoc a cui puoi [attribuire contenuti](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/come-attribuire-contenuti-a-ruoli-specifici.md).

{% hint style="warning" %} <mark style="color:orange;">**L'eliminazione di un Ruolo non influisce sui contenuti o sui layout**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">ad essa associati, ma rimuove la personalizzazione basata su quel ruolo.</mark>
{% endhint %}

I ruoli in AIsuru ti permettono di creare un'esperienza di interazione altamente personalizzata. Sperimenta con diversi ruoli e personalizzazioni per massimizzare l'efficacia del tuo Agente e offrire a ogni utente esattamente ciò di cui ha bisogno.


---

# 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/gestione-utenti-persone/creazione-e-gestione-dei-ruoli.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.