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

# Quando serve un agente

Un agente è una configurazione salvata (istruzioni, documenti e azioni messi
insieme per un compito preciso) che chiunque nel team può usare senza sapere
com'è fatta. Costruirlo richiede mezz'ora. Prima di spenderla, vale la pena
capire se il tuo caso ne ha davvero bisogno.

Il criterio è uno solo: **crea un agente quando il compito si ripete uguale e lo
faranno più persone.** Se manca una delle due condizioni, Userbot ha uno
strumento più leggero che risolve la stessa esigenza.

## Tre modi per non ripetere le stesse istruzioni

|                    | Cosa conserva                                                           | Quando è la scelta giusta                                            |
| ------------------ | ----------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Prompt salvato** | Una richiesta scritta bene, che riusi in qualsiasi chat                 | Il compito è tuo, torna spesso, ma il contenuto cambia ogni volta    |
| **Progetto**       | Un contesto che cresce: conversazioni, file e istruzioni di quel lavoro | Il lavoro dura settimane, ha una sua storia e non si ripete identico |
| **Agente**         | Un mestiere completo: istruzioni, conoscenza, azioni, tono              | Lo stesso compito torna uguale e lo fanno anche i colleghi           |

## Due domande e hai deciso

1. **Il compito si ripete uguale?** Se ogni volta l'obiettivo è diverso e quello
   che serve sapere si accumula strada facendo, ti serve un
   [progetto](/progetti).
2. **Lo faranno anche altri?** Se il compito resta tuo e ti basta non riscrivere
   ogni volta la stessa richiesta, ti basta un [prompt salvato](/prompt).

Due sì: costruisci un agente. È il caso in cui la configurazione la fai una volta
e la usano in dieci, ognuno con la garanzia di ottenere lo stesso comportamento.

## Qualche esempio concreto

| Situazione                                                             | Cosa usare                          | Perché                                              |
| ---------------------------------------------------------------------- | ----------------------------------- | --------------------------------------------------- |
| «Rispondi alle domande dei commerciali sui capitolati di gara»         | Agente                              | Domanda ricorrente, molte persone, stessi documenti |
| «Prepara la relazione trimestrale, che quest'anno cambia impostazione» | Progetto                            | Un lavoro solo, lungo, con contesto che cresce      |
| «Riscrivi le mie email in tono formale»                                | Prompt salvato                      | Serve a te, il contenuto cambia sempre              |
| «Ogni lunedì manda il riepilogo dei ticket aperti»                     | Automazione                         | Nessuno deve chiedere niente: parte da sola         |
| «Rispondi ai clienti sul sito, anche di notte»                         | Agente in modalità Customer Service | Stesso mestiere ripetuto, ma verso l'esterno        |

Le [automazioni](/automazioni) sono il caso limite: quando il compito non ha
nemmeno bisogno di qualcuno che lo chieda, non ti serve un agente ma un workflow
che parte da solo.

## Cosa cambia davvero per chi lo usa

Chi usa un agente non deve conoscere il contesto. Lo richiama scrivendo **@**
nella chat, oppure lo apre dalla pagina **Agenti** e comincia a chiedere. Non
deve sapere quali documenti guardare, come impostare la domanda, quali regole
rispettare: quelle cose stanno già dentro l'agente.

È qui che sta il guadagno vero. Un prompt salvato aiuta chi sa già cosa chiedere;
un agente aiuta anche chi non lo sa.

> **Note**
>
> Il segnale più affidabile arriva dalla chat. Se ti accorgi di aver incollato
> tre volte le stesse istruzioni in tre conversazioni diverse, o se un collega ti
> chiede «come hai fatto a farti dare questa risposta», quel compito è pronto per
> diventare un agente.

## Quando un agente non è la risposta

* **Serve una volta sola.** Fai la richiesta in chat e chiudila lì.
* **Il compito lo definisci mentre lo fai.** Un agente ha bisogno di un mandato
  stabile: se non sai ancora dirlo in cinque righe, lavora in un progetto e crea
  l'agente dopo, quando il mestiere si è chiarito.
* **Il compito è una sequenza fissa di passaggi.** Un'estrazione dal gestionale,
  un controllo e un'email non sono una conversazione: sono un
  [workflow](/costruire-workflow).
* **Il problema è l'accesso ai documenti, non le istruzioni.** Se basta che l'AI
  cerchi nei file aziendali, lo fa già la chat normale: carica i file nella
  [Libreria](/documenti) e usa la ricerca.

## Meglio stretti che tuttofare

La tentazione, all'inizio, è costruire l'agente che sa tutto. Funziona male:
troppe istruzioni si contraddicono, troppi documenti diluiscono le risposte,
troppe azioni lo rendono imprevedibile.

Meglio agenti stretti, con un nome che dice esattamente cosa fanno, come *Assistente
gare d'appalto* o *Supporto policy HR*, e un perimetro che si legge in una riga.
Sono più facili da provare, più facili da correggere, e i colleghi capiscono al
volo quale scegliere.

#### [Creare il primo agente](/primo-agente)

Il percorso completo, dal nome alla condivisione, in un pomeriggio.

#### [Lavorare per progetti](/progetti)

L'alternativa quando il lavoro è lungo e il contesto cambia strada facendo.