> 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.

# Formare le persone

La formazione su Userbot non è un corso. È **un'ora sola**, fatta sul lavoro vero
delle persone che ci sono in stanza, e ripetuta uguale ogni volta che entra un
reparto nuovo.

Tutto quello che va oltre quell'ora, cioè il manuale interno, il video registrato
e il percorso a moduli, non se lo guarda nessuno. Le persone imparano uno
strumento nuovo mentre lo usano su una cosa che devono consegnare, e in genere non
in altri momenti.

## L'ora che funziona

L'ora si divide in blocchi con i minuti indicati. C'è una regola che li tiene
insieme tutti: ognuno ha il proprio computer aperto e fa le cose mentre vengono
raccontate. Un'ora in cui qualcuno proietta e gli altri guardano non serve a
niente.

#### 0-5 · Perché siamo qui, e chi parla

Chi tiene l'ora è un collega del loro reparto, non chi ha configurato lo
strumento. Bastano due frasi: cosa cambia da domani per loro, e che dopo
quest'ora non serve altro per cominciare. Niente panoramica del prodotto e
niente elenco delle funzionalità.

#### 5-15 · La prima domanda, ognuno sul proprio computer

Tutti insieme, una domanda sui documenti veri che avete caricato in
[settimana zero](/settimana-zero). Deve essere una domanda di cui loro sanno
già la risposta, così vedono che è giusta e vedono anche da dove viene. È il
punto in cui l'ora riesce o fallisce.

#### 15-30 · Il caso d'uso del reparto, fatto insieme

Il compito che avete messo a «Ora» nella [griglia](/casi-uso), svolto dal vivo su
un caso reale di questa settimana. Non un esempio inventato, ma un'offerta che
devono davvero mandare o una risposta che devono davvero scrivere. Chi tiene
l'ora si fa dettare i dettagli dalla stanza.

#### 30-40 · Le fonti, e come si verifica una risposta

Sotto la risposta ci sono i riferimenti: passandoci sopra si vede il punto
esatto, cliccandoci si apre l'originale. Fai aprire una fonte a tutti, almeno
una volta. È l'abitudine che distingue chi si fida troppo da chi lavora bene.
→ [Fonti e citazioni](/fonti)

#### 40-50 · La chiocciola e il prompt salvato

Si scrive **@** e si richiama un agente, un prompt, un documento. Poi si salva
la richiesta che ha funzionato poco prima. Sono due gesti soli, ma sono
quelli che fanno sopravvivere l'ora alla settimana.
→ [Richiamare con @](/menzioni)

#### 50-60 · Cosa non chiedere, a chi si chiede, e la prossima data

Le cose che richiedono un'approvazione, dette con le parole della vostra regola.
Il nome e cognome della persona a cui si chiede aiuto. E la data del prossimo
appuntamento, fissata prima di uscire dalla stanza.

> **Note**
>
> Il blocco che salta sempre è il 15-30, perché nessuno arriva con un caso reale
> pronto. Conviene chiederlo per iscritto il giorno prima: «portate una cosa che
> dovete consegnare questa settimana». Senza, l'ora diventa una dimostrazione, e
> dopo una dimostrazione il lunedì successivo non cambia niente.

## Perché la fa il collega e non il fornitore

Chi vende lo strumento sa cosa fa lo strumento. Non sa cosa succede in azienda
quando il cliente chiede lo sconto, e le persone in stanza lo sentono al primo
esempio.

Ci sono tre effetti concreti, e contano più della competenza tecnica.

* **Gli esempi sono i loro.** Un collega dice «il capitolato della gara di
  novembre» e tutti sanno di cosa parla. Un esterno dice «un documento tecnico», e
  la stanza smette di ascoltare.
* **Le obiezioni escono.** Davanti a un fornitore nessuno dice «a me questa cosa
  sembra una perdita di tempo». Davanti a un collega sì, e quella frase è
  l'informazione più utile dell'ora.
* **Resta qualcuno in azienda.** Dopo l'ora le domande arrivano a chi l'ha tenuta.
  Se l'ha tenuta un esterno, continuano ad arrivare a te.

Chi tiene l'ora non deve essere il più esperto, deve aver usato Userbot sul
proprio lavoro per almeno tre settimane. È il profilo che viene fuori dal [gruppo pilota](/pilota), ed è anche il motivo per cui il pilota viene prima.

## Il kit di partenza dentro il prodotto

L'ora funziona se chi entra trova già qualcosa. Sono cinque pezzi da preparare
prima, tutti dentro Userbot, senza allegati e senza cartelle condivise fuori.

![La pagina Prompt con le cartelle e i prompt salvati pronti da richiamare in chat](/_fern-img/02a103804aeed380ca0d92ed422d5a0916352d53ee5759085364384f68bd59f5.webp)

| Pezzo                                                            | Dove sta                                     | Cosa risolve                                                                                                                       |
| ---------------------------------------------------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Tre prompt salvati**, uno per ciascun caso d'uso a «Ora»       | **Prompt**, in una cartella                  | Dà tre cose da provare senza doverle inventare. È il pezzo che viene usato di più → [Salvare e riusare un prompt](/prompt)         |
| **La base di conoscenza dei documenti**, condivisa con il gruppo | **Libreria**                                 | La prima ricerca che trova la risposta giusta, nei primi dieci minuti → [Basi di conoscenza](/basi-conoscenza)                     |
| **Un agente del reparto**, anche imperfetto                      | **Agenti**                                   | Fa vedere la differenza fra chiedere all'AI e chiedere a qualcuno che sa già il contesto → [Creare il primo agente](/primo-agente) |
| **La descrizione azienda** compilata                             | **Impostazioni › Area di lavoro › Generale** | Non si vede da nessuna parte e cambia ogni risposta della stanza → [Impostare l'area di lavoro](/workspace)                        |
| **Il disclaimer chat**, una riga                                 | **Impostazioni › Area di lavoro › Generale** | Ricorda la policy senza che qualcuno debba ripeterla ogni volta                                                                    |

> **Info**
>
> La condivisione per gruppo dei prompt e delle skill non è ancora disponibile:
> una cartella di prompt si tiene per sé o si condivide con tutta l'area di
> lavoro. Per il kit di partenza va bene la seconda: tre prompt scritti bene non
> fanno danno a nessuno, e chi entra il mese prossimo li trova già lì.

## Cosa devono saper fare tutti

Questo è il livello minimo, e chi esce dall'ora senza una di queste cose tornerà a
lavorare come prima. Ripassale negli ultimi dieci minuti, chiedendo a persone
diverse di spiegarle a voce alta.

1. **Allegare un documento a una domanda.** Trascinarlo nella conversazione e
   chiedere qualcosa su quello. È il gesto che risolve metà dei casi d'uso, ed è
   quello che nessuno scopre da solo. → [Allegare documenti](/allegati)
2. **Leggere le fonti sotto una risposta.** Passarci sopra, aprire l'originale,
   controllare che il numero venga da dove sembra. Da fare sempre quando la
   risposta contiene cifre, date o riferimenti a una procedura.
3. **Richiamare con @.** Un agente, un prompt, un documento, senza doverli cercare
   in un'altra pagina.
4. **Correggere il tiro invece di rifare a mano.** Quando la risposta non va, si
   dice cosa non va e si chiede di rifarla. Chi non impara questo passa a
   correggere il testo a mano e conclude che non serve. → [Riprendere, modificare, rigenerare](/riprendere)
5. **Salvare una richiesta che ha funzionato.** Anche una soltanto. Chi esce
   dall'ora con un prompt salvato di solito torna, chi esce con la generica
   impressione che sia utile di solito no.

Il giorno dopo, e non prima, manda a tutti [Chiedere bene](/chiedere-bene) e
[Fonti e citazioni](/fonti). Hanno appena visto una risposta buona e una mediocre,
e per un giorno hanno voglia di capire da cosa dipendeva la differenza. Il resto
del materiale, e in che momento si manda, sta in [Il kit da consegnare](/kit).

## Chi entra dopo

Le assunzioni e i trasferimenti non aspettano il calendario delle sessioni, quindi
serve un modo che costi poco e non richieda di riunire una stanza.

#### Il giorno dell'invito, non dopo

Invita, aggiungi al gruppo del reparto e manda il messaggio con il collegamento
a [Cosa puoi fare con Userbot](/cosa-puoi-fare) e il nome del referente del
suo reparto. Tre righe, non un manuale.

#### Mezz'ora con il referente entro la prima settimana

Non l'ora intera, ma i blocchi 5-15 e 15-30, sul lavoro che quella persona sta
prendendo in carico. Li tiene il referente del reparto, non tu.

#### Una sessione collettiva quando arrivi a quattro

Sotto le quattro persone conviene il faccia a faccia. Da quattro in su rifai
l'ora intera, che costa meno tempo e fa uscire meglio le obiezioni.

## Quando serve una seconda ora

Di norma non serve. Ci sono però tre situazioni in cui ha senso, e in tutte e tre
sono le persone a chiederla, non tu a metterla in calendario.

**Quando un reparto comincia a costruire.** Chi passa dall'usare gli agenti allo
scriverne uno ha bisogno di un'ora diversa: come si scrivono le istruzioni, quali
documenti collegare, come si prova una cosa prima di condividerla. Riguarda i due
o tre referenti per reparto, non tutti. → [Scrivere istruzioni efficaci](/istruzioni-agente)

**Quando cambia qualcosa che si vede.** Una nuova integrazione collegata, un
agente che sostituisce un modo di lavorare, una regola di approvazione nuova.
Bastano 20 minuti, ma vanno fatti, perché una cosa che cambia senza spiegazione
viene letta come un guasto.

**Quando il reparto ha smesso.** Se gli indicatori dicono che un reparto è
scivolato a zero, la seconda ora non è un ripasso: è la conversazione su cosa non
ha funzionato. Si tiene con quattro o cinque persone, non con il reparto intero, e
si comincia chiedendo a loro. → [Gli errori che fermano l'adozione](/errori-adozione)