> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.userbot.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server.

# Condividere un agente

Un agente appena creato è **privato**: esiste, lo puoi usare e provare, ma
nessun altro lo vede. Condividerlo è il momento in cui il suo comportamento
diventa un fatto aziendale, non più una tua configurazione.

Non c'è un pulsante «pubblica»: c'è **Condividi**, in alto nell'editor. Prima di
premerlo, fai i controlli di [Provare e mettere a punto](/provare-agente).

## Chi può fare cosa

| Ruolo              | Cosa può fare                                                                                |
| ------------------ | -------------------------------------------------------------------------------------------- |
| **Visualizzatore** | Usare l'agente in chat, aprirne la configurazione in sola lettura e vederne le statistiche   |
| **Editor**         | Anche modificare istruzioni, conoscenza, azioni e impostazioni, eseguire i test e duplicarlo |
| **Proprietario**   | Anche condividere, cambiare i ruoli degli altri ed eliminare l'agente                        |

Nella pratica quasi tutti sono **Visualizzatore**: è il ruolo di chi l'agente lo
usa e basta, ed è quello giusto per la maggior parte del team. **Editor** si dà a
chi conosce il mestiere che l'agente svolge, cioè chi lo correggerà quando una
procedura cambia, e conviene che siano almeno due persone, altrimenti l'agente
si ferma alla prima assenza.

## Condividerlo

#### Apri Condividi

Si apre il pannello con chi ha già accesso.

![Il pannello Condividi di un agente: in alto la ricerca con il ruolo da assegnare accanto, sotto chi ha già accesso (il proprietario e un gruppo con il suo numero di membri) e in fondo l'accesso generale su Privato](/_fern-img/6519ffc552f333699f710d2308e100c68a6fa89bf241886751779d1ad2b3c8d5.webp)

#### Aggiungi persone o gruppi

Scrivi un nome nel campo in alto e scegli il **Ruolo per i nuovi accessi**. I
**gruppi** sono la via da preferire: dài accesso a *Ufficio gare* invece che
a sette persone, e chi entrerà nell'ufficio domani lo troverà già
disponibile.

#### Decidi l'accesso generale

Sotto trovi due opzioni: **Privato**, dove entra solo chi hai indicato, e
**Chiunque nel workspace**, che lo rende disponibile a tutti. La seconda è la
scelta giusta per gli agenti di servizio, come policy HR o supporto IT, che è
meglio se tutti trovano da soli.

#### Fallo sapere

**Copia link** ti dà l'indirizzo dell'agente da incollare in una chat o in
un'email. Nel messaggio scrivi a cosa serve e una domanda di esempio: è
quello che fa la differenza fra un agente usato e uno ignorato.

> **Info**
>
> Il link non è un lasciapassare. Chi lo riceve senza avere accesso non apre
> l'agente: la condivisione la decidi nel pannello, non passando l'indirizzo.

## Perché il pulsante è grigio

I tre livelli di condivisione non sono la stessa cosa dal punto di vista dei
permessi, e questa è la causa più comune di un comando che non risponde.

| Livello                                                  | Cosa serve per farlo                                                                        |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Condividere con **una persona**                          | Nessun permesso particolare: lo può fare chiunque sia proprietario dell'agente              |
| Condividere con un **gruppo**                            | Il permesso di condividere agenti con i gruppi                                              |
| Mettere l'accesso generale su **Chiunque nel workspace** | Il permesso, diverso dal precedente, di rendere un agente visibile a tutta l'area di lavoro |

Il controllo scatta solo quando la condivisione **si allarga**. Rinominare un
agente già condiviso da altri, o restringere l'accesso, non richiede niente.

Se aggiungere una persona funziona e aggiungere un gruppo no, non è un guasto:
sono due permessi separati. Chiedi a chi amministra l'area di lavoro di
guardare il tuo ruolo. → [Ruoli e permessi](/ruoli)

## Cosa vede chi lo usa

Chi ha accesso trova l'agente nella pagina **Agenti**, dove un clic sulla scheda
apre subito una chat, oppure lo richiama con **@**. Ci parla come parlerebbe in
una chat normale, e la conversazione resta sua: nessuno vede i messaggi dei
colleghi.

Dal menu **⋯** della scheda, **Modifica agente** apre la configurazione. Un
Visualizzatore la vede in sola lettura, con l'etichetta **Solo visualizzazione**
e il pulsante **Avvia una chat** al posto di **Salva**: istruzioni, conoscenza e
azioni non sono nascoste a chi può usare l'agente. Tienine conto quando scrivi
le istruzioni.

Anche le [statistiche](/statistiche-agente) le vede chiunque abbia accesso
all'agente, compresi i nomi delle persone che lo usano di più.

Chi amministra l'area di lavoro può inoltre assegnare il badge **Verificato** agli
agenti approvati ufficialmente. È il segnale che distingue l'agente che l'azienda
sostiene da quello che qualcuno ha costruito per sé e ha condiviso.

## Cosa cambia subito e cosa no

Un agente non ha due copie, una in prova e una pubblicata: quello che salvi vale
per tutti da subito, anche quando salvi solo per provare una modifica
nell'**Anteprima**. Ma «subito» non vale per ogni campo allo stesso modo, e la
differenza si vede su chi sta già parlando con l'agente in quel momento.

| Campo                                                | Quando fa effetto                                                                   |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Nome**, **Istruzioni**, **Azioni**, **Creatività** | Dal messaggio successivo, anche nelle conversazioni già aperte                      |
| **Modello**, se l'agente ne ha uno specifico         | Dal messaggio successivo: le chat con quell'agente sono bloccate sul suo modello    |
| **Modello**, se l'agente è su **Auto**               | Solo dalle conversazioni nuove: quelle aperte restano sul modello con cui sono nate |

> **Warning**
>
> Non sperimentare su un agente condiviso: non c'è un annulla, e chi ci sta
> parlando vede il cambiamento. Per lavorare a una versione diversa usa
> **Duplica**.

Se la modifica è sostanziale (cambia il perimetro, il tono, le azioni che
l'agente può fare) dillo a chi lo usa. Un agente che da un giorno all'altro
risponde in modo diverso senza spiegazioni fa perdere fiducia più di un agente
che sbaglia.

## Come si lavora senza versioni

Gli agenti non hanno versioni: non c'è uno storico da consultare, non c'è un
ripristino, e non esiste una bozza separata da quella in servizio. Chi arriva dai
workflow, dove versioni e pubblicazione esistono, se lo aspetta e non lo trova.

Il sostituto è **Duplica**, dal menu in alto nell'editor. Il metodo che funziona
è questo.

#### Duplica prima di toccare

Ottieni una copia privata, con nome *(copia)*, che nessuno vede e senza il
badge **Verificato**. La copia si porta dietro la configurazione e la
conoscenza, ma non i test. Da lì in poi l'originale resta fermo e continua a
servire i colleghi.

#### Lavora sulla copia

Cambia istruzioni, conoscenza, azioni. Provala nell'**Anteprima**. I test
non vengono copiati: se ti servono, ricrea sulla copia i casi più importanti.

#### Riporta le modifiche in un colpo solo

Quando la copia funziona, riscrivi i campi sull'originale in un unico
salvataggio. Riportare metà configurazione e finire domani significa lasciare
l'agente condiviso in uno stato che non hai mai provato.

#### Tieni la copia finché non sei sicuro

È l'unica cosa che assomiglia a un ripristino: finché la copia esiste, sai
esattamente com'era la configurazione prima. Eliminala quando la nuova ha
superato una settimana d'uso.

Conviene anche annotare da qualche parte cosa hai cambiato e quando: nella
descrizione dell'agente, o in un documento del team. Senza uno storico, quella
riga è tutto ciò che avrete fra sei mesi per capire perché l'agente risponde
così.

## Tenerlo in vita

Un agente lasciato a se stesso invecchia: i documenti cambiano, le procedure
pure, e nessuno se ne accorge finché una risposta non fa danno. Tre abitudini
bastano.

* **Dopo ogni cambio ai documenti collegati, rifai le domande chiave
  nell'Anteprima.** È il momento in cui un agente comincia a sbagliare senza
  che nessuno tocchi la sua configurazione, e i test non lo vedono, perché non
  leggono i documenti.
* **Guarda le [Statistiche](/statistiche-agente) una volta al mese.**
  Conversazioni, messaggi e utenti attivi dicono se l'agente è vivo. Se non lo usa nessuno, o è inutile o dal nome
  non si capisce a cosa serva: nel secondo caso si risolve cambiando nome e
  descrizione.
* **Raccogli gli errori come casi di test.** Quando un collega segnala una
  risposta sbagliata, quella domanda diventa un caso nella scheda **Test**: così
  non tornerà.

## Quando un agente non serve più

Solo il Proprietario può eliminare un agente. Prima, controlla che non sia usato
altrove: finché un workflow lo usa come nodo o nelle sue impostazioni, il
comando per eliminarlo non compare, né nella scheda né nell'editor. La sezione
**Usato nei workflow** dell'editor ti mostra dove è usato, nella bozza e nella
versione pubblicata di ciascun workflow.

![La sezione Usato nei workflow nell'editor: il workflow che usa l'agente, con il ruolo di Operatore nella bozza e nella versione pubblicata, e sotto la riga che avverte di togliere i riferimenti prima di poterlo eliminare](/_fern-img/add6aca0a414fc474b79c5edb33132afe3b0b382332bfda069df1fe0ba62e316.webp)

Tolti i riferimenti, dall'elenco degli agenti **Elimina agente** nel menu **⋯**
della scheda chiede conferma: «Eliminare definitivamente l'agente…? L'azione
non può essere annullata.»

> **Warning**
>
> **Elimina** nel menu **⋯** dell'editor, invece, cancella l'agente subito,
> senza chiedere conferma. Se vuoi una conferma prima di perdere l'agente, usa
> l'elenco.

Se l'agente serviva e serve ancora ma tu cambi ruolo, non eliminarlo: passa il
ruolo di **Proprietario** a chi lo erediterà, prima di lasciare il team. Un agente
senza nessuno che lo manutenga continua a rispondere, ed è il modo più silenzioso
di diffondere informazioni superate.