> 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. # Collegare azioni Le **Azioni** sono ciò che permette a un agente di raggiungere i vostri sistemi: aprire un ticket, creare un evento, mandare un'email, avviare un workflow. Senza, un agente sa spiegarti come si fa una cosa; con, la fa. ## Aggiungerne una #### Apri l'agente in modifica Dalla pagina **Agenti**, menu **⋯** della scheda, **Modifica agente**. Se stai creando l'agente sei già nell'editor. ![La scheda di un agente nella pagina Agenti con il menu dei tre puntini aperto e la voce Modifica agente evidenziata](/_fern-img/6d4bdbda8428c5eca553b84b5a498311038199d81b233f66fddec3046538134a.webp) #### Premi Aggiungi azione Il pulsante sta in fondo al riquadro **Azioni**, sotto le azioni già collegate. ![Il riquadro Azioni con la Ricerca web già collegata, la fila delle integrazioni e sotto il pulsante Aggiungi azione evidenziato](/_fern-img/e5c65d15dae1368c614820848b8ff908797842d185d2a09a8374cecca5a4f15d.webp) #### Scegli la categoria e la voce Si apre la finestra delle azioni: a sinistra le categorie, a destra le voci, con la ricerca in alto. Clicca una voce per aggiungerla: compare la spunta. Un secondo clic la toglie. ![La finestra delle azioni: a sinistra le categorie in colonna, a destra le voci raggruppate per categoria, con la ricerca in alto](/_fern-img/29eea7b7f921d12ce74099a9dde1c7b649c6d9911d5799382103b3d2a0aa0205.webp) #### Chiudi la finestra Le voci scelte compaiono nel riquadro **Azioni**. Un'integrazione ha sulla sua riga il pulsante **Tutte le azioni**: per ora l'agente le riceve tutte. ![Il riquadro Azioni con Slack appena aggiunta: la riga dice Integrazione connessa e ha accanto il pulsante Tutte le azioni evidenziato](/_fern-img/9ac7685bebf463fcec992e33ef1baa03da09534ca472967b150050370e7fe7eb.webp) #### Per un'integrazione, scegli le singole azioni Premi **Tutte le azioni**: si apre l'elenco delle azioni dell'integrazione, tutte accese. Spegni quelle che questo agente non deve usare, come spiegato più sotto in **Scegliere le singole azioni**. ![L'elenco delle azioni di Slack filtrato sulla parola message: in alto il conteggio 157 di 159 azioni per questo agente, sotto le due azioni che cancellano un messaggio con l'interruttore spento](/_fern-img/22c89fa091ab5728f5982d86b89cb258ed6d104d30f24571e3e301369438631e.webp) #### Salva Le azioni valgono dal salvataggio: premi **Salva**, o **Crea** se l'agente è nuovo. ![La barra in alto nell'editor di un agente nuovo con il pulsante Crea evidenziato a destra](/_fern-img/5a600ba35147a2e245b43b613e539834d8e5402e7cb27a6dfa080a55874a806b.webp) ## Cosa sa già fare senza collegare niente Prima di aggiungere qualcosa, vale la pena sapere cosa c'è già. Un agente parte con una dozzina di strumenti nativi, che non compaiono nel riquadro **Azioni** perché non si configurano lì: dipendono da cosa è attivo nell'area di lavoro e dai pulsanti in **Strumenti**. | Sa già fare | Da cosa dipende | | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | Cercare nella sua conoscenza e citare le fonti | L'agente ha file o basi di conoscenza nel riquadro **Knowledge** → [Dare conoscenza a un agente](/conoscenza-agente) | | Eseguire codice per analizzare dati e produrre grafici | La creazione di file è attiva nell'area di lavoro | | Creare e modificare documenti, convertirli in altri formati | Come sopra | | Ricordare qualcosa fra una chat e l'altra | La memoria è attiva | | Caricare una **skill** quando serve | Ci sono skill attive nell'area di lavoro | | Fermarsi e farti una domanda quando gli manca un dato | Sempre, nelle chat interattive | | Passare la conversazione a un operatore | Il Customer Service è attivo | Se quello che ti serve è in questo elenco, non c'è niente da collegare: si tratta di scriverlo nelle istruzioni. ## Cosa si può collegare | Categoria | Cosa contiene | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------- | | **Funzionalità** | **Ricerca web**, **Generazione immagini**, **Richiedi approvazione** a una persona e **Invio email** | | **Integrazioni** | Gli strumenti aziendali: posta, calendario, CRM, ticket, gestionali | | **Mini App** | Piccoli strumenti costruiti nella tua area di lavoro → [Come l'AI usa una Mini App](/miniapp-come-tool) | | **Workflow** | Un'automazione che l'agente può avviare quando la conversazione lo richiede. Compaiono solo i workflow attivi con avvio manuale | | **Sotto-agenti** | Un altro agente, richiamato per la parte di lavoro che è il suo mestiere | | **Skill** | Procedure riutilizzabili che qualcuno ha già preparato | | **Cartelle** | Una cartella della **Libreria** in cui l'agente può cercare quando serve | | **Template file** | Un modello di documento della Libreria che l'AI compila | In **Integrazioni** trovi tutto il catalogo, non solo gli strumenti già collegati. Su un'app collegata premi **Aggiungi all'agente** (diventa **Aggiunta ✓**); su una che non lo è ancora premi **Collega**, completi l'accesso e poi la aggiungi. Se un collegamento è rimasto a metà, il pulsante dice **Continua**. Se l'app che ti serve non c'è proprio, chi amministra l'area di lavoro può averla disattivata per tutti → [Integrazioni](/integrazioni). ## Inviare email e compilare modelli Due voci del catalogo producono qualcosa di concreto invece di cercare. **Invio email** si attiva fra le **Funzionalità**. Serve una casella Gmail o Outlook collegata nelle Integrazioni: finché non c'è, la voce resta disattivata con la nota «collega Gmail o Outlook». Vale anche per chi usa l'agente: se non ha una casella collegata, sua o condivisa nell'area di lavoro, per lui l'agente non prepara email. Come funziona l'email in chat → [Scrivere e inviare email](/email-da-chat). **Template file** elenca i modelli di documento salvati nella Libreria. Ne colleghi uno e l'agente sa che, quando gli chiedi quel documento, deve partire da lì e compilarlo, invece di inventare un formato. Serve che la creazione di documenti sia attiva nell'area di lavoro. Se l'elenco è vuoto compare «Nessun template. Salvané uno dalla Libreria.» → [Creare documenti](/creare-documenti) ## Scegliere le singole azioni, e cosa succede se non lo fai Un'integrazione non è un blocco unico. Nel riquadro **Azioni**, sulla sua riga, **Tutte le azioni** apre l'elenco delle sue singole azioni (*leggi email*, *invia email*, *crea bozza*), ognuna con il suo interruttore. Il conteggio in alto dice quante ne riceve l'agente, per esempio «157 di 159 azioni per questo agente». Almeno una resta sempre accesa, e **Tutte** le riaccende in un colpo. > **Warning** > > Appena aggiunta, un'integrazione ha **tutte** le azioni accese, comprese > quelle che cancellano. È l'errore più facile da fare, perché aggiungere > l'integrazione e chiudere la finestra sembra un'operazione innocua. Quindi: aggiungi l'integrazione e **spegni subito** le azioni che non servono, prima di salvare. Un agente che deve solo leggere il calendario ha bisogno di una voce, non di venti. ## Meno azioni, agente migliore Un agente con quaranta azioni disponibili deve scegliere, a ogni richiesta, quale usare, e più l'elenco è lungo più sbaglia: usa il calendario quando bastava rispondere, cerca sul web quando la risposta era nei documenti. Diventa anche più difficile da controllare, perché non sai più cosa può toccare. Il metodo che funziona: parti da zero azioni, aggiungi quelle che servono al compito che hai scritto nelle istruzioni, e togli tutto ciò che in una settimana d'uso non è mai servito. ## La conferma prima di agire Ogni azione di un'app del catalogo ha un interruttore **Chiedi conferma**. Quando è attivo, in una chat interattiva l'agente non esegue: si ferma, mostra esattamente cosa sta per fare e con quali valori, e aspetta il tuo via libera. Il criterio per decidere quando attivarlo lo applichi tu, azione per azione: il prodotto non sa quali operazioni leggono e quali scrivono. → [Conferme prima di agire](/conferme-azioni) ## L'approvazione di una persona L'azione **Richiedi approvazione** serve alle operazioni che escono dalle policy aziendali. Fa una cosa sola, e conviene sapere quale: **prepara una richiesta**. #### L'agente prepara la richiesta Scrive un titolo e un report di contesto, e li mostra in chat come proposta. Non la invia da solo, e **non si ferma**: continua il suo giro e ti risponde. ![La risposta dell'agente che spiega perché serve un via libera e, sotto, la scheda Richiede approvazione con il report da rivedere, il campo del commento e Invia in approvazione](/_fern-img/c35e84e22e70e2d51804912b41ea294d9784934f113f17d650441d2f9428c826.webp) #### Tu la invii, o la annulli Dalla card in chat confermi l'invio, aggiungendo un commento se serve. Finché non lo fai, l'approvatore non riceve niente. ![La scheda Richiede approvazione con un commento per l'approvatore già scritto e il pulsante Invia in approvazione evidenziato accanto ad Annulla](/_fern-img/8445b7a678cfd658ec58969392edc82a24033a48a20f900d2516538fe00a5386.webp) #### L'approvatore decide dall'inbox Riceve una notifica, legge il report, approva o rifiuta con una nota. ![L'Inbox dell'approvatore: sotto Da approvare chi ha chiesto, l'oggetto preparato da un agente, il report da aprire, il commento del richiedente e i pulsanti Rifiuta e Approva](/_fern-img/007b69b62f8591aa9381d0f262d180ca06c7d8c1da13f88b857285de6c09c4d4.webp) #### La decisione ti torna in chat Arriva fra le [notifiche](/inbox) e riapre la conversazione dov'era nata. Chi sia l'approvatore si decide in tre passaggi, in quest'ordine: la persona indicata come **Approvatore** nel riquadro **Azioni**; se non c'è, quella prevista dalle [regole dell'area di lavoro](/regole) per chi ha fatto la richiesta; se non c'è nemmeno quella, il primo amministratore dell'area di lavoro. > **Warning** > > L'approvazione **non trattiene l'agente**. Se l'operazione va davvero fermata > finché qualcuno non dà il via libera, la richiesta di approvazione da sola non > basta: quell'operazione non va collegata all'agente, oppure va messa dietro > **Chiedi conferma**, che invece ferma l'esecuzione. Una richiesta di > approvazione non scade: resta in attesa finché l'approvatore non decide. ## Con quali permessi agisce Un agente non ha un account proprio. Quando esegue un'azione usa una connessione, e quale connessione usa cambia tutto. | Connessione | Chi agisce davvero | | ------------- | -------------------------------------------------------------------------------------------------------------- | | **Personale** | Ogni persona usa il proprio account collegato. L'agente non arriva dove quella persona non arriverebbe da sola | | **Condivisa** | Chi usa l'agente non agisce con i propri diritti, ma con la connessione personale di chi ha creato l'agente | La personale è la scelta giusta quasi sempre: i permessi restano quelli veri di chi sta usando l'agente, e nessuno vede attraverso l'agente cose che non potrebbe vedere. > **Warning** > > Con una connessione **condivisa**, chiunque usi l'agente agisce con i permessi > dell'account collegato da chi ha creato l'agente, anche su dati a cui non avrebbe accesso, e le operazioni > risultano fatte da quell'account, non dal suo. Usala solo per caselle o account > di servizio dedicati, mai per un account personale, e solo dopo aver verificato > che non aggiri una regola di accesso. → [Connessioni personali e condivise](/connessioni) ## Domande frequenti #### L'agente può fare un'azione che non gli ho collegato? Sugli strumenti esterni no: può usare soltanto le azioni ammesse, e comunque entro quello che l'area di lavoro consente. Ricorda però che un'integrazione aggiunta senza spegnere nessuna azione le ammette tutte. Gli strumenti nativi, come cercare nella sua conoscenza, produrre un file o farti una domanda, restano disponibili a prescindere. #### Un collega usa l'agente ma non ha collegato lo strumento. Cosa vede? Con la connessione personale, l'agente gli chiede di collegare il proprio account prima di procedere. Finché non lo fa, quell'azione non è disponibile per lui, e le altre continuano a funzionare. #### Posso far cercare l'agente in una sola cartella? Se è una base di conoscenza, il modo più diretto è metterla nella sua conoscenza: la ricerca dell'agente guarda solo lì. In alternativa aggiungi la cartella come azione, dalla categoria **Cartelle**: l'agente ci cerca quando la domanda lo richiede. ![La categoria Cartelle nella finestra delle azioni: le cartelle della Libreria a cui hai accesso, con la spunta su quella appena scelta per questo agente](/_fern-img/7877eb96ca0139fa2ad54126a3f6d0f317941cce09cb7b4543c13c57536a07fd.webp) → [Dare conoscenza a un agente](/conoscenza-agente) #### Cosa succede se un'azione fallisce? L'agente te lo dice e riporta l'errore dello strumento, invece di far finta di aver eseguito. Diverso è il caso della connessione scaduta: lì l'azione sparisce dall'elenco e l'agente risponde come se non l'avesse mai avuta, senza segnalare niente. → [Connessioni](/connessioni)