> 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. # Creare il primo agente Un agente è un assistente configurato una volta per un compito che si ripete: sa chi è, su quali documenti si basa, cosa può fare e come deve rispondere. Chi lo usa non deve sapere com'è fatto: lo richiama con **@** e comincia a chiedere. La differenza con la chat normale è che l'agente **non dimentica il suo mestiere**. Non gli devi rispiegare ogni volta il contesto, le fonti da citare e il tono da tenere. ## Da dove si parte Apri **Agenti** dalla barra laterale. Qui trovi quelli già disponibili per te, filtrabili per ambito, e i comandi per crearne uno nuovo. ![La pagina Agenti: in alto Sfoglia i template e il pulsante Crea agente con la freccia accanto, sotto i filtri per ambito, il riquadro Parti da un template e le schede degli agenti](/_fern-img/f939049998ddf582d230cf6570655eb31b1e19cca62a6a4f2dc39635a9d70d53.webp) Prima di aprire l'editor, mettiti d'accordo con te stesso su una frase: *«Questo agente serve a \_\_\_ , per \_\_\_ .»* Se non riesci a completarla, il problema non è la configurazione: vedi [Quando serve un agente](/quando-agente). Le vie per crearlo sono tre e arrivano tutte allo stesso editor. Parti **con l'AI** se hai in mente il compito ma non sai ancora come scrivere le istruzioni, **a mano** se sai già cosa mettere in ogni campo, **da un template** se il tuo caso somiglia a uno degli esempi pronti. ### Con l'AI #### Premi Crea agente Si apre la schermata **Crea il tuo agente con l'AI**. Ci porta anche la scheda **Nuovo agente**, in fondo all'elenco degli agenti. ![La schermata Crea il tuo agente con l'AI: il campo in cui descrivere l'agente con il modello che fa il lavoro, e sotto Prova con un esempio con quattro descrizioni pronte](/_fern-img/18e034f8def7e5126d4b6604e2907a7c53473c0f688f0377fe4e843a0289a7f9.webp) #### Descrivi cosa deve fare Scrivi il compito in due o tre frasi e invia, oppure clicca uno degli esempi sotto **Prova con un esempio**. Si apre l'editor, e i campi a sinistra si compilano sotto i tuoi occhi. ![L'editor mentre l'AI lavora: a sinistra il nome già scritto e il cursore che sta compilando la descrizione, in basso L'AI sta lavorando, a destra la richiesta e i passaggi del ragionamento](/_fern-img/24935b4e065300542a6221b138df719abd254794dd1b48086c2014386e09a243.webp) #### Rileggi quello che ha scritto Controlla soprattutto le istruzioni: la parte su cosa l'agente **non** deve fare la conosci solo tu. Poi completa i campi come spiegato più sotto, in **Costruirlo**. ![L'editor a lavoro finito: nome, descrizione e istruzioni compilati a sinistra, a destra il messaggio dell'AI che invita a rifinire un campo o ad aprire l'Anteprima, e in alto il pulsante Crea](/_fern-img/f320cd4c57d1e00061b7ce649caa93e896d6df138251d1e11b417c6767f0b5c3.webp) ### A mano #### Apri la freccia accanto a Crea agente Si apre un menu con due voci: **Crea con l'AI** e **Crea manualmente**. ![Il menu della freccia accanto a Crea agente, con Crea manualmente evidenziato sotto Crea con l'AI](/_fern-img/b1329a61c09d6a6be3cd153695549294e97db73f3b2f61994800c75cc2460196.webp) #### Scegli Crea manualmente Si apre l'editor vuoto e compili tu ogni campo, come spiegato più sotto, in **Costruirlo**. Se sei già nella schermata dell'AI, **Vai all'editor** in alto a destra porta allo stesso punto. ![L'editor di un agente nuovo con i campi vuoti a sinistra e a destra la scheda Crea con l'AI, pronta se vuoi farti aiutare su un campo](/_fern-img/194f73acee55d593e45a632138fecb76a835f607a39eaa28a11160666b268603.webp) ### Da un template #### Premi Sfoglia i template Si apre la galleria **Template di agenti**: otto agenti di esempio, divisi per categoria (Supporto, Vendite, Marketing, HR, Dati, Ingegneria, Produttività, Ricerca), con la ricerca **Cerca template**. Ci arrivi anche da **Vedi tutti →** nel riquadro **Parti da un template**. ![La galleria Template di agenti: la ricerca Cerca template, le categorie in fila e le schede dei template con nome, categoria e descrizione](/_fern-img/cb6f34432b0e55f38fb3091182eb69a271fd8601c68c6e61653c3a0efee9433e.webp) #### Clicca un template Si apre l'**Anteprima template**, con le **Istruzioni** e i **Messaggi di partenza** che l'agente avrà. ![L'Anteprima template di un agente di esempio: descrizione, istruzioni e messaggi di partenza, e in basso il pulsante Usa questo template evidenziato](/_fern-img/c070c6b788764486e512a2e5ea2def51fae80bee5a762b3067a2412a3153e508.webp) #### Premi Usa questo template Si apre l'editor con i campi già compilati. L'agente però non esiste ancora: lo diventa quando premi **Crea**, e fino a quel momento puoi cambiare tutto. I nomi dei template nel riquadro **Parti da un template** portano qui direttamente, senza passare dalla galleria. ![Dalla pagina Agenti si apre la galleria dei template, si sceglie un template, se ne legge l'anteprima e Usa questo template apre l'editor con nome, descrizione e istruzioni già scritti](/_fern-files/userbot-035249.docs.buildwithfern.com/fdae497731c57557d0380855702ac1970808c52be9ffb3c4005efacfcd7aa6d6/docs/assets/animazioni/agenti-da-template.gif) #### Adattalo al tuo caso Un template è un punto di partenza generico: riscrivi almeno le istruzioni con le regole del tuo caso, poi prosegui da **Costruirlo**, qui sotto. ## Costruirlo #### Dagli un nome, un'icona e una descrizione Il nome lo vedranno i colleghi in un elenco: *Assistente gare d'appalto* è più utile di *Agente Marco*. L'icona serve a riconoscerlo a colpo d'occhio, la **Descrizione** compare nella chat e spiega in una riga a cosa serve. ![La parte alta dell'editor: l'icona dell'agente, che si cambia cliccandola, e sotto i campi Nome e Descrizione già compilati](/_fern-img/b1fccface187566b52adb41a2cc5f18cf48670f75876e9729c2a54747af804e2.webp) #### Scrivi le istruzioni È il campo che determina la qualità di tutto il resto: chi è l'agente, cosa fa, cosa non deve fare, come risponde. ![Il campo Istruzioni con il testo dell'agente, e sotto Ottimizza e il pulsante per ingrandire il campo](/_fern-img/551c8f53912d14c3c5a9911ccdadf32371cce61e503984ba168c967b2b3b9821.webp) → [Scrivere istruzioni efficaci](/istruzioni-agente) #### Aggiungi le frasi di avvio Sono gli esempi che compaiono a chi apre una chat con l'agente, come pulsanti da cliccare. Scrivine una per riga: finita una, sotto ne compare un'altra, fino a 12. Due o tre bastano, e servono più di quanto sembri: sono il modo più rapido per far capire cosa si può chiedere e cosa no. ![Le frasi di avvio scritte una per riga, il contatore in alto a destra e il campo vuoto pronto per la successiva: sono richieste complete, non parole chiave](/_fern-img/731e37200934972c3bca0269fff1068bf4f2f7887d12a50d18cd3419232e633e.webp) #### Dagli la conoscenza Nel riquadro **Knowledge** premi **Allega**: puoi caricare file dal computer oppure collegare una base di conoscenza della **Libreria**. Da quel momento l'agente cerca lì dentro quando la domanda lo richiede e cita da dove ha preso l'informazione. ![Il riquadro Knowledge ancora vuoto, con il pulsante Allega evidenziato](/_fern-img/462d476a7696fc42f671b167e6853e2ce828898e6fb0815a15038ca6e5407e03.webp) → [Dare conoscenza a un agente](/conoscenza-agente) #### Collega le azioni Se deve fare qualcosa oltre che rispondere, come aprire un ticket, mandare un'email o cercare in un gestionale, usa **Aggiungi azione**. ![Il riquadro Azioni con la Ricerca web già collegata e il pulsante Aggiungi azione evidenziato](/_fern-img/e5c65d15dae1368c614820848b8ff908797842d185d2a09a8374cecca5a4f15d.webp) → [Collegare azioni](/azioni-agente) #### Scegli modello e creatività **Auto** va bene per quasi tutto. La **Creatività** conviene tenerla intorno a 0.3 quando l'agente ha documenti allegati e deve attenersi a quelli, e più alta quando il suo lavoro è scrivere. ![Il Modello su Auto e il cursore della Creatività portato su 0.3, verso l'estremo Deterministico](/_fern-img/055f66562824de6d549b9b8e7f5b3be0cce079e2ed76678e8a371246de9408cd.webp) #### Premi Crea Il pulsante sta in alto a destra. Compare «Modifiche salvate.», resti nell'editor e da qui in poi il pulsante diventa **Salva**. L'agente esiste, ma resta privato: nessun collega lo vede finché non lo condividi. Anche il primo messaggio che mandi nell'**Anteprima** crea l'agente, se non l'avevi ancora fatto. ![La barra in alto nell'editor di un agente nuovo: il pulsante Crea evidenziato a destra, accanto a Schedula e Condividi ancora spenti](/_fern-img/5a600ba35147a2e245b43b613e539834d8e5402e7cb27a6dfa080a55874a806b.webp) #### Provalo prima di condividerlo Usa l'**Anteprima** e fagli le domande che gli farebbero i colleghi, comprese quelle a cui non dovrebbe saper rispondere. ![La scheda Anteprima nella colonna di destra dell'editor: il saluto dell'agente, le frasi di avvio come pulsanti e il campo di scrittura in basso](/_fern-img/75c23a2fc8f5c7af1ff1c690955429622498a0b286cc69e737786730eb092b94.webp) → [Provare e mettere a punto](/provare-agente) #### Condividilo Con una persona, con un gruppo o con tutta l'area di lavoro, scegliendo chi può solo usarlo e chi può modificarlo. → [Condividere un agente](/condividere-agente) ## L'editor, in due colonne A sinistra c'è la configurazione, a destra due schede che lavorano sulla stessa cosa da due angoli diversi. ![L'editor di un agente nuovo: in alto le schede Configurazione, Statistiche e Test e il pulsante Crea; a sinistra nome, descrizione, tipo di agente e istruzioni; a destra l'Anteprima, dove le frasi di avvio compaiono già come pulsanti](/_fern-img/976ff6ca5c0630a833e637cc3665a39739161cba456061132e39e985084c8522.webp) | Scheda | A cosa serve | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Crea con l'AI** | Descrivi a parole cosa deve fare l'agente e i campi a sinistra si compilano sotto i tuoi occhi. Puoi anche chiedere una correzione mirata: *«tono più formale»*, *«aggiungi la ricerca web»*. Puoi scegliere il modello che fa il lavoro | | **Anteprima** | Una chat di prova con l'agente. I messaggi non vengono salvati. **Usa agente** apre una chat vera in una nuova scheda del browser | In alto trovi le tre schede dell'agente: **Configurazione**, **Statistiche** e **Test**. Le ultime due diventano disponibili dopo il primo salvataggio, come i pulsanti **Schedula** e **Condividi**. > **Note** > > Partire da **Crea con l'AI** è il modo più rapido per avere una bozza > ragionevole in un minuto. Rileggi però sempre le istruzioni che ha scritto: la > parte su cosa l'agente **non** deve fare la conosci solo tu. ## Le impostazioni che si dimenticano | Campo | Perché guardarlo | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Al superamento dei limiti** | Decide cosa succede quando l'agente esaurisce il budget d'uso: passare a un modello di base o mettersi in pausa | | **Etichette** | Servono a ritrovarlo e a filtrarlo quando gli agenti diventano venti. Al massimo tre | | **Modalità agente** | **Uso interno** per i colleghi dentro Userbot, **Customer Service** se deve parlare con i clienti sui canali esterni. Compare solo se il Customer Service è attivo nell'area di lavoro e hai il permesso di creare agenti di quel tipo | | **Tipo di agente** | **Semplice** copre quasi tutti i casi. **Multi-Agente** non ha istruzioni proprie: orchestra un workflow | | **Tipo di input** | **Prompt** è la chat normale. **Form** fa compilare dei campi prima di partire | | **Schedula** | Fa lavorare l'agente da solo a orari fissi, con un'[attività schedulata](/schedulate) | L'elenco completo, con i limiti di ciascun campo e cosa succede quando li superi, sta in [Tutti i campi di un agente](/campi-agente). ## Come lo useranno i colleghi Chi ha accesso all'agente lo trova in tre punti: nella pagina **Agenti**, dove un clic sulla scheda apre subito una chat, scrivendo **@** nel campo della chat, e nell'elenco delle conversazioni recenti una volta che ci ha parlato. Ogni conversazione con l'agente resta privata di chi l'ha aperta: si vedono le [statistiche d'uso](/statistiche-agente), non i messaggi. > **Info** > > Se non vedi **Crea agente**, e con lui **Sfoglia i template**, il riquadro dei > template e la scheda **Nuovo agente**, chi amministra l'area di lavoro ha > riservato la creazione degli agenti a certi ruoli. Puoi comunque usare quelli > che ti hanno condiviso.