# Guida di Userbot

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server

## Docs

- [Benvenuto in Userbot](https://docs.userbot.ai/benvenuto.md): L'AI del tuo team, con i documenti e gli strumenti che usate già.
- [Cosa puoi fare con Userbot](https://docs.userbot.ai/cosa-puoi-fare.md): Esempi concreti divisi per mestiere. Parti da quello più vicino al tuo lavoro.
- [Accedi a Userbot](https://docs.userbot.ai/accesso.md): Un solo campo per cominciare, poi scegli tu come entrare: password, passkey o link via email.
- [Il primo giro](https://docs.userbot.ai/primo-giro.md): La Home e la barra laterale: dove sta cosa, e quando serve.
- [Cercare in Userbot](https://docs.userbot.ai/cercare.md): Una scorciatoia da tastiera per arrivare ovunque senza navigare.
- [Glossario](https://docs.userbot.ai/glossario.md): Come si chiamano le cose in Userbot, e in cosa si assomigliano solo in apparenza.
- [La tua prima chat](https://docs.userbot.ai/prima-chat.md): Fai una domanda, allega un documento, controlla da dove arriva la risposta.
- [Il menu +](https://docs.userbot.ai/menu-piu.md): Ricerca web, documenti, conoscenza aziendale, integrazioni e file: cosa aggiungi a una richiesta e quando
- [Chiedere bene](https://docs.userbot.ai/chiedere-bene.md): I quattro pezzi di una richiesta che funziona, e i tre modi in cui si sbaglia
- [Leggere bene una risposta](https://docs.userbot.ai/leggere-risposta.md): Tabelle da riusare, formule, diagrammi: cosa puoi chiedere che una risposta contenga.
- [Dettare invece di scrivere](https://docs.userbot.ai/dettatura.md): Il microfono nel campo di scrittura: quando conviene, cosa succede al testo, dove si inceppa.
- [Allegare documenti](https://docs.userbot.ai/allegati.md): Come si porta un file dentro la conversazione, cosa viene letto e cosa resta dov'è.
- [Fonti e citazioni](https://docs.userbot.ai/fonti.md): Come si verifica da dove arriva una risposta, in 10 secondi.
- [Richiamare con @](https://docs.userbot.ai/menzioni.md): Riusare quello che il team ha già preparato, senza riscrivere le istruzioni ogni volta.
- [Scegliere il modello](https://docs.userbot.ai/modelli.md): Quando lasciar fare a Userbot e quando conviene decidere tu.
- [Modelli disponibili](https://docs.userbot.ai/modelli-disponibili.md): L'elenco completo, quanto consuma ciascuno e quali modelli lavorano dietro le quinte.
- [Riprendere, modificare, rigenerare](https://docs.userbot.ai/riprendere.md): Tornare su una conversazione, correggere una richiesta, rifare una risposta.
- [Condividere una chat](https://docs.userbot.ai/condividere-chat.md): Far leggere una conversazione a un collega, e riprendersi l'accesso quando serve.
- [Memoria](https://docs.userbot.ai/memoria.md): Cosa Userbot ricorda di te fra una conversazione e l'altra, e come lo controlli.
- [Contesto e conversazioni lunghe](https://docs.userbot.ai/contesto-conversazione.md): Quanto spazio resta in una chat, cosa succede quando si riempie, quando conviene aprirne una nuova
- [Cercare nei documenti](https://docs.userbot.ai/ricerca-documenti.md): Interrogare le basi di conoscenza caricate nella Libreria
- [Conoscenza aziendale](https://docs.userbot.ai/conoscenza-aziendale.md): Cercare direttamente negli strumenti collegati, con i permessi di chi chiede
- [Ricerca web](https://docs.userbot.ai/ricerca-web.md): Fonti esterne con citazioni verificabili
- [Analizzare dati e creare grafici](https://docs.userbot.ai/analisi-dati.md): Carichi un foglio, chiedi in italiano, ottieni numeri calcolati davvero.
- [Creare documenti](https://docs.userbot.ai/creare-documenti.md): Word, PDF, Excel e PowerPoint veri, anche partendo da un vostro modello.
- [Lavorare nel canvas](https://docs.userbot.ai/canvas.md): Il documento accanto alla chat, mentre continui a chiedere modifiche.
- [Generare immagini](https://docs.userbot.ai/immagini.md): Immagini da una descrizione, e i grafici che nascono dall'analisi dei dati.
- [Convertire file](https://docs.userbot.ai/convertire.md): Passare da un formato all'altro senza uscire dalla conversazione.
- [Eseguire azioni sugli strumenti](https://docs.userbot.ai/azioni.md): Aprire un ticket, mandare una email: cosa succede e cosa ti viene chiesto prima.
- [Scrivere e inviare email](https://docs.userbot.ai/email-da-chat.md): Preparare una email in chat e mandarla dalla tua casella, dopo averla riletta
- [Avviare un workflow dalla chat](https://docs.userbot.ai/workflow-da-chat.md): Richiamare un'automazione già pronta senza uscire dalla conversazione.
- [Quando l'AI chiede a te](https://docs.userbot.ai/conferme.md): Chiarimenti, conferme e approvazioni: perché arrivano, quando invece non arrivano, cosa fare.
- [Passare a un operatore](https://docs.userbot.ai/escalation.md): Quando la conversazione lascia l'assistente e arriva a una persona.
- [Fin dove arrivano le capacità](https://docs.userbot.ai/capacita-limiti.md): I numeri che spiegano perché una risposta è venuta così, e cosa fare quando non basta.
- [Come sono organizzati](https://docs.userbot.ai/documenti.md): Cartelle, basi di conoscenza e file recenti: cosa cambia e dove mettere cosa.
- [Caricare file](https://docs.userbot.ai/caricare-file.md): Il gesto base, dove finisce il file e cosa succede mentre lo elaboriamo.
- [Il ciclo di vita di un documento](https://docs.userbot.ai/ciclo-documento.md): Dal caricamento alla citazione in una risposta, con quello che vedi in ogni fase.
- [Basi di conoscenza](https://docs.userbot.ai/basi-conoscenza.md): Rendere un insieme di documenti ricercabile dall'AI, una volta per tutte.
- [Scrivere documenti che l'AI ritrova](https://docs.userbot.ai/documenti-ricercabili.md): Le scelte di chi prepara un documento contano più di qualsiasi impostazione.
- [Condivisione e permessi](https://docs.userbot.ai/permessi-documenti.md): Chi vede una cartella o un file, cosa può farci e chi può scaricare gli originali.
- [Formati e limiti](https://docs.userbot.ai/formati.md): Cosa puoi caricare, cosa diventa ricercabile e cosa non è supportato.
- [Riferimento dei formati](https://docs.userbot.ai/riferimento-formati.md): Una riga per estensione: cosa succede quando la carichi, dove puoi usarla e cosa fare se non funziona.
- [Lavorare per progetti](https://docs.userbot.ai/progetti.md): Un contenitore per le chat, i file e le istruzioni di uno stesso lavoro.
- [Istruzioni e contesto](https://docs.userbot.ai/istruzioni-progetto.md): Due campi diversi: le regole di comportamento e i fatti da sapere.
- [Condividere un progetto](https://docs.userbot.ai/condividere-progetto.md): Chi entra, cosa vede delle conversazioni e cosa resta tuo.
- [Quando serve un agente](https://docs.userbot.ai/quando-agente.md): Il bivio fra agente, progetto e prompt salvato
- [Creare il primo agente](https://docs.userbot.ai/primo-agente.md): Il percorso completo, dalla creazione alla condivisione
- [Scrivere istruzioni efficaci](https://docs.userbot.ai/istruzioni-agente.md): Chi è, cosa fa, cosa non deve fare, come risponde
- [Dare conoscenza a un agente](https://docs.userbot.ai/conoscenza-agente.md): File caricati e basi di conoscenza collegate, con le citazioni
- [Collegare azioni](https://docs.userbot.ai/azioni-agente.md): Cosa l'agente può fare oltre che rispondere
- [Provare e mettere a punto](https://docs.userbot.ai/provare-agente.md): I casi di prova che contano prima di condividerlo
- [Le statistiche di un agente](https://docs.userbot.ai/statistiche-agente.md): Chi lo usa, quanto, quanto costa e quali azioni esegue
- [Condividere un agente](https://docs.userbot.ai/condividere-agente.md): Chi può usarlo, chi può modificarlo, e come si lavora senza versioni
- [Tutti i campi di un agente](https://docs.userbot.ai/campi-agente.md): Ogni campo dell'editor, con i suoi limiti e cosa succede quando li superi
- [Panoramica](https://docs.userbot.ai/automazioni.md): Attività schedulata o workflow: quale serve
- [Attività schedulate](https://docs.userbot.ai/schedulate.md): Un lavoro salvato che parte da solo, a un orario o a intervalli regolari
- [Costruire un workflow](https://docs.userbot.ai/costruire-workflow.md): Dalla tela vuota al flusso provato
- [Come si avvia un workflow](https://docs.userbot.ai/avvio-workflow.md): I tipi di trigger, e come far partire un flusso a orario
- [Webhook](https://docs.userbot.ai/webhook-workflow.md): Far partire un workflow da un altro sistema, con un indirizzo di prova e uno di produzione
- [Avvio da eventi delle app](https://docs.userbot.ai/trigger-integrazione.md): Un'email ricevuta, un evento in calendario, un file aggiunto: il workflow parte da solo
- [I blocchi disponibili](https://docs.userbot.ai/blocchi.md): Cosa fa ciascun blocco e quando conviene usarlo
- [Riferimento dei blocchi](https://docs.userbot.ai/riferimento-blocchi.md): Parametri, valori ammessi e cosa ogni blocco espone a valle
- [La sintassi dei riferimenti](https://docs.userbot.ai/riferimenti-dati.md): Come si richiama in un campo un dato prodotto prima
- [Come gira un'esecuzione](https://docs.userbot.ai/esecuzione-workflow.md): Coda, tempi massimi, cosa succede quando qualcosa si blocca
- [Le esecuzioni](https://docs.userbot.ai/esecuzioni-automazioni.md): Seguire in un posto solo cosa è partito, cosa aspetta e cosa è fallito
- [Pubblicare e monitorare](https://docs.userbot.ai/pubblicare-workflow.md): Versioni, storico delle esecuzioni, cosa guardare quando fallisce
- [Costi e limiti](https://docs.userbot.ai/costi-workflow.md): Cosa consuma e come tenerlo sotto controllo
- [Cos'è una Mini App](https://docs.userbot.ai/miniapp.md): Uno strumento con la sua interfaccia, costruito descrivendolo a parole
- [Com'è fatta una Mini App](https://docs.userbot.ai/anatomia-miniapp.md): Cosa c'è dentro, per sapere cosa puoi chiederle e perché a volte sbaglia
- [Crearne una](https://docs.userbot.ai/creare-miniapp.md): Dalla descrizione all'app funzionante
- [Pubblicare una Mini App](https://docs.userbot.ai/pubblicare-miniapp.md): Bozza e versione pubblicata, le versioni, come tornare indietro
- [Funzioni server e dati](https://docs.userbot.ai/miniapp-server.md): Chiamare servizi esterni e conservare dati, con i limiti
- [Come l'AI usa una Mini App](https://docs.userbot.ai/miniapp-come-tool.md): Il momento in cui il modello smette di calcolare e chiede alla tua formula
- [Usarla e condividerla](https://docs.userbot.ai/condividere-miniapp.md): Chi la vede, chi la modifica, chi ha cambiato cosa
- [Cosa sono le skill](https://docs.userbot.ai/skill.md): Istruzioni che l'AI richiama da sola quando servono
- [Le skill di sistema](https://docs.userbot.ai/skill-sistema.md): Quelle già disponibili senza configurare nulla
- [Creare una skill](https://docs.userbot.ai/creare-skill.md): Scriverla, caricarla, renderla disponibile al team
- [Salvare e riusare un prompt](https://docs.userbot.ai/prompt.md): Le richieste che tornano, scritte bene una volta sola
- [Segnaposto nei prompt](https://docs.userbot.ai/variabili-prompt.md): Spazi da compilare al momento dell'uso
- [Collegare uno strumento](https://docs.userbot.ai/integrazioni.md): Come si autorizza un'app, cosa stai concedendo e come si controlla il collegamento nel tempo.
- [App con collegamento nativo](https://docs.userbot.ai/integrazioni-native.md): Le app che Userbot collega direttamente, e cosa cambia per chi le usa
- [Connessioni personali e condivise](https://docs.userbot.ai/connessioni.md): Con quali permessi agisce l'AI quando usa uno strumento collegato, e quando conviene cambiarli.
- [Conferme prima di agire](https://docs.userbot.ai/conferme-azioni.md): Quando l'AI si ferma a chiederti il via libera, cosa ti mostra e come si corregge prima di approvare.
- [Integrazioni personalizzate e MCP](https://docs.userbot.ai/integrazioni-custom.md): Collegare un sistema che non è nel catalogo: le tre vie disponibili e quando usarle.
- [Panoramica](https://docs.userbot.ai/customer-service.md): L'assistente risponde ai clienti, e quando serve interviene una persona: come funziona e cosa configurare prima.
- [Installare la chat sul sito](https://docs.userbot.ai/chat-sito.md): Il widget per il tuo sito: codice da incollare, domini ammessi, benvenuto, aspetto e cosa vede il visitatore
- [Presidiare le conversazioni](https://docs.userbot.ai/inbox-cs.md): La coda del team: filtrare, prendere in carico, rispondere al cliente e parlare con i colleghi senza farsi sentire.
- [Dal bot all'operatore](https://docs.userbot.ai/handoff.md): Quando scatta il passaggio a una persona, cosa vedono cliente e operatore, e come si riconsegna la conversazione.
- [Orari e assegnazione](https://docs.userbot.ai/orari-cs.md): Quando c'è qualcuno a rispondere, cosa succede fuori orario e come le conversazioni si distribuiscono nel team.
- [Profilo e preferenze](https://docs.userbot.ai/profilo.md): Dati personali, lingua, tema, il menu del tuo nome e le chat condivise
- [Istruzioni personalizzate](https://docs.userbot.ai/istruzioni-personali.md): Come farti rispondere sempre nel modo che preferisci
- [Sicurezza](https://docs.userbot.ai/sicurezza-account.md): Account collegati, passkey, password e sessioni attive
- [Inbox e notifiche](https://docs.userbot.ai/inbox.md): Approvazioni da dare, assegnazioni, esiti delle automazioni
- [Quanto sto consumando](https://docs.userbot.ai/consumi.md): Utilizzo della sessione e della settimana
- [Come l'AI trova le risposte](https://docs.userbot.ai/come-trova.md): Il modello mentale giusto su ricerca e citazioni
- [Come decide un agente](https://docs.userbot.ai/come-decide.md): Perché sceglie uno strumento invece di un altro
- [Cosa succede ai tuoi dati](https://docs.userbot.ai/dati.md): Dove stanno, chi li vede, per quanto restano
- [Problemi frequenti](https://docs.userbot.ai/problemi.md): Le cose che capitano più spesso, con il rimedio
- [Formati, limiti e quote](https://docs.userbot.ai/limiti.md): I numeri da conoscere prima di incontrarli
- [Scorciatoie da tastiera](https://docs.userbot.ai/scorciatoie.md): Le combinazioni che fanno risparmiare tempo
- [Contattare il supporto](https://docs.userbot.ai/supporto.md): Come chiedere aiuto in modo che sia veloce risolverlo
- [Segnalare un problema o un'idea](https://docs.userbot.ai/segnalazioni.md): La linguetta Feedback: cosa scrivere, cosa allegare, cosa parte insieme alla segnalazione
- [Partire dal problema, non dallo strumento](https://docs.userbot.ai/adozione.md): Perché i lanci si arenano dopo poche settimane, e da quale domanda si riparte
- [Chi guida l'iniziativa](https://docs.userbot.ai/chi-guida.md): Le figure che servono, quanto tempo costano davvero, e come si traducono in ruoli e gruppi
- [Scegliere i primi casi d'uso](https://docs.userbot.ai/casi-uso.md): Come si raccolgono, come si danno un punteggio, e quali sembrano buoni ma non lo sono
- [La settimana zero](https://docs.userbot.ai/settimana-zero.md): Cosa mettere a posto prima di mandare il primo invito
- [Il gruppo pilota](https://docs.userbot.ai/pilota.md): Da 5 a 10 persone scelte, sei settimane, e i segnali che dicono quando allargare
- [Formare le persone](https://docs.userbot.ai/formazione.md): Un'ora fatta bene, con i loro documenti veri, e chi la deve tenere
- [Il kit da consegnare](https://docs.userbot.ai/kit.md): Quali pagine mandare alle persone, in che momento, e cosa non serve mandare
- [Allargare a tutta l'azienda](https://docs.userbot.ai/allargare.md): Le condizioni da verificare prima, l'ordine dei reparti, e il modello dell'annuncio
- [Tenere viva l'iniziativa](https://docs.userbot.ai/tenere-viva.md): Gli appuntamenti che restano in calendario dopo il pilota, e cosa si fa perché l'iniziativa non si spenga
- [Misurare l'adozione](https://docs.userbot.ai/misurare.md): Il numero che conta più di tutti, la tabella degli indicatori, e 20 minuti al mese
- [Gli errori che fermano l'adozione](https://docs.userbot.ai/errori-adozione.md): I modi in cui si spegne, quando si sbaglia, e come si riparte senza rifare tutto
- [Impostare l'area di lavoro](https://docs.userbot.ai/workspace.md): I dati di base che tutto il team vede, e la descrizione che l'AI legge in ogni chat
- [Invitare e gestire i membri](https://docs.userbot.ai/membri.md): Inviti, stato dell'invito, ruolo e piano di ogni persona, e cosa succede quando i posti finiscono
- [Gruppi](https://docs.userbot.ai/gruppi.md): Condividere con un reparto invece che con dodici nomi, e non doverlo rifare a ogni assunzione
- [Ruoli e permessi](https://docs.userbot.ai/ruoli.md): Tre ruoli, una matrice modificabile: cosa può fare ciascuno e come si cambia
- [Condividere: proprietario, editor, visualizzatore](https://docs.userbot.ai/ruoli-condivisione.md): Il secondo sistema di ruoli, quello che vale sul singolo elemento e non sull'area di lavoro
- [Regole per l'AI](https://docs.userbot.ai/regole.md): Linee guida che orientano e approvazioni che fermano l'AI, per una persona, un gruppo o tutta l'area di lavoro
- [Gestire i modelli](https://docs.userbot.ai/modelli-admin.md): Cosa trova il team nel selettore, come funziona Auto e cosa succede quando i crediti finiscono
- [Attivare e limitare le funzionalità](https://docs.userbot.ai/prodotti.md): Accendere, spegnere o restringere a un gruppo le singole parti di Userbot
- [Chiavi API dell'area di lavoro](https://docs.userbot.ai/chiavi-api-admin.md): Chi può usare l'API, con quali chiavi e modelli, entro quale budget
- [Libreria e permessi aziendali](https://docs.userbot.ai/documenti-admin.md): Chi carica, chi condivide con tutta l'azienda, chi può portare fuori gli originali
- [Piani, posti e fatturazione](https://docs.userbot.ai/fatturazione.md): Come funzionano i posti, come si cambia fascia a una persona, dove stanno le fatture
- [Come si contano i crediti](https://docs.userbot.ai/crediti.md): Cos'è un credito, quanto pesa ciascun modello e come nasce il conto di una risposta
- [Limiti di spesa e credito](https://docs.userbot.ai/spesa.md): Cosa succede quando il team esaurisce l'incluso, e come decidere quanto può costare
- [Registro di audit](https://docs.userbot.ai/audit.md): Chi ha fatto cosa nell'area di lavoro, con i filtri per trovarlo in un minuto
- [Sicurezza dell'area di lavoro](https://docs.userbot.ai/sicurezza-workspace.md): Chi può entrare, da dove, e per quanto restano valide le chiavi API
- [Metodi di accesso](https://docs.userbot.ai/metodi-accesso.md): I modi per entrare in Userbot, quanto dura una sessione e cosa non è ancora supportato
- [Riferimento dell'area di lavoro](https://docs.userbot.ai/riferimento-workspace.md): Le tabelle complete: chi vede quali impostazioni, permessi, funzionalità, eventi del registro, notifiche
- [Introduzione](https://docs.userbot.ai/api.md): A cosa serve l'API e quando conviene usarla
- [Autenticazione e chiavi](https://docs.userbot.ai/api-auth.md): Quale chiave usare, come crearla, come proteggerla e revocarla
- [Completamenti chat](https://docs.userbot.ai/api-chat.md): L'endpoint compatibile con OpenAI Chat Completions: richiesta, risposta, streaming, strumenti, errori
- [Responses](https://docs.userbot.ai/api-responses.md): L'endpoint nel formato Responses di OpenAI, per chi ha già codice scritto così
- [Embeddings](https://docs.userbot.ai/api-embeddings.md): Trasformare un testo in un vettore, per la ricerca semantica e i confronti
- [Modelli disponibili](https://docs.userbot.ai/api-modelli.md): Quali modelli si possono richiedere, dove si legge il prezzo, come si sceglie
- [Costi, budget e analytics](https://docs.userbot.ai/api-costi.md): Quanto costa una chiamata, chi la paga, come si mette un tetto e dove si controlla la spesa
- [Limiti e quote](https://docs.userbot.ai/api-limiti.md): Quante richieste e quanti token al minuto, quanto può essere grande una chiamata, cosa riprovare