> 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. # Tutti i campi di un agente L'elenco completo dei campi dell'editor, da consultare mentre configuri. Se stai costruendo il tuo primo agente, il percorso guidato è [Creare il primo agente](/primo-agente). ![L'editor di un agente: a sinistra i campi della configurazione, dall'icona e dal nome in giù, a destra l'Anteprima](/_fern-img/976ff6ca5c0630a833e637cc3665a39739161cba456061132e39e985084c8522.webp) ## Identità | Campo | Limite | Cosa succede al limite | | --------------- | ----------------------------- | ----------------------------------------------- | | **Nome** | 80 caratteri | Il campo smette di accettare testo | | **Descrizione** | 500 caratteri | Il campo smette di accettare testo | | Icona o avatar | 2 MB, in JPG, PNG, WebP o GIF | Il caricamento viene rifiutato con un messaggio | | **Etichette** | 3 | Il campo per aggiungerne sparisce | Il **Nome** compare nell'elenco degli agenti e nel richiamo con **@**: scrivi il mestiere, non la persona. Senza nome l'agente non si salva. La **Descrizione** compare nella chat sotto il nome, e serve a chi deve capire in una riga se è l'agente giusto. Le **Etichette** sono tre e non di più, quindi vanno scelte: usale per l'ambito (*gare*, *HR*, *IT*), non per aggettivi. ## Tipo di agente Prima scelta, e cambia quali campi vedi dopo. ![La scelta del Tipo di agente: Semplice, selezionato, con istruzioni, modello e azioni, e Multi-Agente, che orchestra un workflow](/_fern-img/7cd2c9b49eb667257fd7a72ad9fc4d68911d2caa93e314ac31f9cb6fb3964516.webp) | Tipo | Cosa fa | Cosa sparisce dall'editor | | ---------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | **Semplice** | Istruzioni, modello e azioni. Copre quasi tutti i casi | Niente | | **Multi-Agente** | Orchestra un workflow: colleghi il workflow e il lavoro lo fa quello | Istruzioni, tipo di input, frasi di avvio, conoscenza, azioni, modello, **Al superamento dei limiti** e **Creatività** | **Multi-Agente** non è «un agente più potente»: è un agente che non ragiona per conto proprio e delega tutto a un'automazione. Non si salva finché non colleghi un workflow («Collega un workflow prima di salvare un Multi-Agente.»). Scegli **Semplice** se non hai già il workflow. ## Istruzioni Il campo che determina la qualità di tutto il resto: chi è l'agente, cosa fa, cosa non deve fare, come risponde. **Non ha un limite di lunghezza**, ma non è un invito: istruzioni lunghe si contraddicono, e l'agente segue la riga sbagliata. **Ottimizza** riscrive quello che hai scritto in una forma più ordinata. Rileggilo prima di salvare: la parte su cosa l'agente *non* deve fare la conosci solo tu. → [Scrivere istruzioni efficaci](/istruzioni-agente) ## Tipo di input Come chi lo usa fa partire la conversazione. | Tipo | Cosa vede chi lo usa | | ------------------------ | ------------------------------------------------------------------- | | **Prompt (predefinito)** | Il campo della chat, come in una conversazione normale | | **Form** | Un modulo con i campi che definisci tu, compilato prima di iniziare | **Form** conviene quando la richiesta ha sempre gli stessi dati obbligatori e lasciarla a testo libero produce risposte a metà. ### Costruire il form Con **Form** selezionato compare **Aggiungi campo di input**, che apre la finestra del campo. ![La finestra Aggiungi campo di input: Nome, Tipo, Descrizione, la casella Obbligatorio e in basso il pulsante Avanzate](/_fern-img/969c825c0c2250388c0302053e3f38717b73bbf4ebb2622282f1add359b2fa69.webp) | Voce | Cosa decide | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | L'etichetta che vede chi compila | | **Tipo** | Testo, **Testo multi-riga**, Numero, Email, Data, **Elenco**, **Elenco a selezione multipla**, **Casella di spunta**, File | | **Descrizione** | Un suggerimento facoltativo mostrato sotto il campo | | **Obbligatorio** | Se il campo va compilato per forza. Nell'elenco dei campi lo riconosci dall'asterisco | | **Avanzate** | Le regole del tipo scelto: placeholder, lunghezza massima, minimo e massimo, date ammesse, tipi e dimensione dei file, più file insieme | Per **Elenco** ed **Elenco a selezione multipla** scrivi le **Opzioni**, una per riga: senza almeno un'opzione il campo non si salva. I campi si riordinano trascinandoli, e ognuno ha il menu **⋯** con **Modifica** ed **Elimina**. Un agente **Form** senza campi non si salva: compare «Aggiungi almeno un campo di input prima di salvare un agente form.» ## Frasi di avvio Gli esempi che compaiono come pulsanti a chi apre una chat con l'agente, finché non scrive il primo messaggio. Ci sono solo con il tipo di input **Prompt**. Se ne scrivono **fino a 12**, una per riga: quando ne completi una, sotto compare una riga vuota per la successiva, e **Invio** ti porta lì. Le righe lasciate vuote non vengono salvate. In chat compaiono tutte, quindi tienine poche e mettile nell'ordine in cui vuoi che si leggano. ## Conoscenza Il materiale su cui l'agente si basa: file caricati sull'agente, oppure basi di conoscenza della **Libreria** collegate. Da **Ricerca avanzata** decidi come cerca in quel materiale. → [Dare conoscenza a un agente](/conoscenza-agente) ## Azioni Cosa l'agente può fare oltre che rispondere: funzionalità di Userbot, integrazioni, Mini App, workflow, sotto-agenti, skill, cartelle e template di file. Un'integrazione aggiunta senza spuntare nessuna azione ammette **tutte** le sue azioni. → [Collegare azioni](/azioni-agente) ## Modello e creatività | Campo | Valori | Predefinito | | -------------- | ------------------------------------------------------------------------- | ----------- | | **Modello** | **Auto**, oppure un modello preciso fra quelli attivi nell'area di lavoro | Auto | | **Creatività** | Da 0 a 1, a passi di 0.1 | 0.7 | ![La parte bassa dell'editor: Modello su Auto, Al superamento dei limiti, il cursore della Creatività e la Modalità agente](/_fern-img/7642c595e72bc7b5f91d774a72758ec8c5ca01d6f5ad71a34fd12524a1a638e3.webp) Con **Auto** ogni conversazione parte dal modello scelto da chi la apre. Con un modello preciso, tutte le chat con quell'agente sono bloccate su quello: chi ci parla non può cambiarlo. La **Creatività** va da **Deterministico** a **Creativo**: tienila intorno a **0.3** quando l'agente ha documenti allegati e deve attenersi a quelli, intorno a **0.7** quando il suo lavoro è scrivere. ## Al superamento dei limiti Cosa succede quando l'agente esaurisce il budget d'uso. | Scelta | Cosa fa | | ------------------------------ | ---------------------------------------------------- | | **Passa a un modello di base** | Continua a rispondere, con un modello più economico | | **Metti in pausa** | Smette di rispondere finché il budget non si rinnova | Un agente in modalità **Customer Service** conta ogni chat come un'esecuzione, e al superamento dei limiti viene sempre messo in pausa: la scelta non si applica. ## Modalità agente | Modalità | Con chi parla | | -------------------- | ---------------------------------------- | | **Uso interno** | I colleghi, dentro Userbot | | **Customer Service** | Utenti esterni, sui canali di erogazione | Il campo compare solo se il Customer Service è attivo nell'area di lavoro e hai il permesso di creare agenti di quel tipo. La seconda modalità apre la configurazione dei canali (sito, WhatsApp, telefono, email) e cambia le regole d'uso. → [Customer Service](/customer-service) ## Schedula Il pulsante **Schedula**, in alto nell'editor, apre la finestra di una nuova [attività schedulata](/schedulate) con questo agente già scelto: decidi cosa deve fare e ogni quanto, e al salvataggio arrivi alla pagina dell'attività. È disattivato finché l'agente non è stato creato. ## Condivisione Un agente appena creato è privato. **Condividi** apre i tre livelli (persone, gruppi, tutta l'area di lavoro), che richiedono permessi diversi. → [Condividere un agente](/condividere-agente)