Automatizzare l'IA con n8n: costruire un agente che lavora per te

Automatizzare significa smettere di fare a mano cio' che un software puo' fare al posto tuo. Se all'automazione aggiungi un modello di intelligenza artificiale, ottieni qualcosa di piu': un sistema che non solo sposta dati da A a B, ma li capisce, li riassume, li classifica e decide come rispondere. Lo strumento piu' potente e flessibile per costruire queste automazioni senza scrivere un'applicazione da zero e' n8n, una piattaforma open source di workflow che si controlla con un'interfaccia visuale a nodi.

In questa guida installeremo n8n sul nostro computer, costruiremo un primo workflow che usa un modello IA e poi un vero agente che legge le email in arrivo, ne capisce il contenuto e prepara una risposta. E' un tutorial di livello intermedio-avanzato: non serve saper programmare, ma occorre dimestichezza con il terminale.

A chi serve e cosa otterrai

Questa guida e' pensata per freelance, piccole imprese, professionisti e curiosi che vogliono togliersi di dosso compiti ripetitivi: smistare richieste, riassumere documenti, generare bozze di risposta, alimentare fogli di calcolo. Al termine avrai: n8n funzionante in locale, un workflow che invia un testo a un modello IA e ne riceve la risposta, e un agente collegato alla posta elettronica. Tutto girera' sul tuo computer, con i dati sotto il tuo controllo.

Prerequisiti reali

• Un computer con Windows, macOS o Linux e almeno 4 GB di RAM liberi.
• Docker Desktop installato (il modo piu' pulito per far girare n8n). In alternativa, Node.js 18+.
• Una chiave API di un provider IA: useremo OpenAI (piattaforma a consumo), ma n8n supporta anche Anthropic, Google Gemini, Mistral e modelli locali via Ollama.
• Per la parte email, un account Gmail o un server IMAP a cui accedere.

Passo 1 — Installare n8n con Docker

Il metodo consigliato dalla documentazione ufficiale e' Docker. Apri il terminale e lancia questi comandi. Il primo crea un volume per conservare i dati tra un riavvio e l'altro, il secondo avvia n8n.

docker volume create n8n_data

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Quando il terminale mostra che l'editor e' pronto, apri il browser su http://localhost:5678. Al primo avvio n8n ti chiede di creare un account locale (email e password): serve solo a proteggere la tua istanza, resta tutto sul tuo computer.

Passo 2 — Il primo workflow con un modello IA

Costruiamo il classico "ciao mondo" dell'IA: un flusso che manda una frase a un modello e ne riceve la risposta.

1. Nell'editor, clicca su Add first step e scegli Trigger manually (esecuzione manuale, utile per i test).
2. Aggiungi un nodo cliccando sul "+": cerca OpenAI (oppure "AI Agent" per l'uso avanzato) e seleziona l'azione Message a model.
3. Nelle credenziali, incolla la tua chiave API OpenAI. n8n la salva in modo cifrato nella tua istanza.
4. Scegli il modello (per esempio gpt-5.6 o un modello economico per i test) e nel campo del messaggio scrivi il prompt.

Riassumi in tre punti elenco questo testo, in italiano, con tono professionale: {{ $json.testo }}

La sintassi {{ $json.campo }} e' il modo con cui n8n inserisce dati dinamici presi dai nodi precedenti. Clicca Execute workflow e osserva la risposta comparire nel pannello di output. Hai appena collegato un modello IA a un'automazione.

Passo 3 — Costruire un agente che legge le email e risponde

Ora il pezzo forte. Vogliamo un agente che, quando arriva un'email, ne capisca il contenuto e prepari una bozza di risposta coerente. Ecco la struttura del workflow:

1. Trigger email: aggiungi il nodo Gmail Trigger (o IMAP Email) e collega il tuo account. Imposta il controllo, ad esempio, ogni 5 minuti sulle email non lette.
2. Nodo AI Agent: aggiungi il nodo AI Agent e collega come "chat model" il modello scelto (OpenAI, Anthropic o altro). L'AI Agent e' il cuore intelligente: puo' ragionare e, se serve, usare strumenti.
3. Il prompt di sistema definisce il comportamento dell'agente. Incollalo nel campo dedicato.

Sei l'assistente di posta di uno studio professionale.
Per ogni email ricevuta:
1. Classifica la richiesta (informazioni, preventivo, reclamo, altro).
2. Scrivi una bozza di risposta cortese e professionale in italiano.
3. Non promettere mai scadenze o prezzi precisi: usa formule come
   "la ricontatteremo a breve con i dettagli".
Rispondi in formato: CATEGORIA: ... | BOZZA: ...

Nel messaggio utente dell'agente passa il testo dell'email in arrivo con {{ $json.text }} (il nome esatto del campo dipende dal nodo email; usalo dal pannello dati).

4. Salvataggio o notifica: aggiungi in coda un nodo per creare una bozza in Gmail, oppure un nodo Set per rivedere il risultato, o ancora l'invio in un canale Slack/Telegram per l'approvazione. Consiglio: nella fase iniziale non far inviare le risposte in automatico, ma fai creare solo bozze da controllare a mano.

Prompt e varianti utili

Lo stesso schema si adatta a decine di casi. Alcuni esempi da incollare nell'AI Agent:

Estrai da questa email nome, azienda, richiesta e livello di urgenza (basso/medio/alto) e restituiscili in formato JSON.

Traduci questa richiesta in inglese e riassumila in una riga per il team commerciale.

Variante locale e gratuita: se non vuoi usare API a pagamento, installa Ollama sul tuo computer, scarica un modello con ollama pull llama3.1 e collega n8n al nodo Ollama. Tutto girera' in locale, senza costi per token e senza inviare dati all'esterno, a costo di prestazioni inferiori rispetto ai modelli di frontiera.

Un secondo caso d'uso: riassunti automatici ogni mattina

Una volta capito lo schema, puoi replicarlo per decine di compiti. Un esempio molto richiesto: ricevere ogni mattina, in un messaggio, il riassunto degli articoli di una o piu' fonti. La struttura del workflow e' questa:

1. Schedule Trigger: aggiungi il nodo di pianificazione e impostalo, ad esempio, ogni giorno alle 8:00. n8n eseguira' il flusso in automatico, senza che tu debba fare nulla.
2. RSS Read / HTTP Request: leggi il feed RSS di un sito di notizie o interroga un'API per recuperare i contenuti piu' recenti.
3. Nodo IA: passa i titoli e gli estratti al modello con un prompt di sintesi.
4. Invio: manda il risultato via email, Telegram o Slack.

Ricevi un elenco di notizie con titolo e sommario. Scrivi un briefing di massimo 150 parole in italiano, con i tre temi piu' importanti in grassetto e una riga di commento finale. Ignora le notizie duplicate.

Questo semplice flusso sostituisce dieci minuti di lettura sparsa ogni mattina con un briefing pronto all'apertura del computer. La stessa logica, cambiando fonte e prompt, produce report di vendite, rassegne stampa o promemoria personalizzati.

Far girare n8n sempre attivo

Finche' lo avvii dal terminale, n8n resta attivo solo mentre quella finestra e' aperta. Per le automazioni pianificate serve invece che giri di continuo. Due strade principali:

• In background sul tuo computer: avvia il container Docker in modalita' distaccata sostituendo -it --rm con -d e aggiungendo --restart unless-stopped, cosi' n8n riparte anche dopo un riavvio della macchina.
• Su un server: per un uso serio conviene un piccolo server (un VPS a pochi euro al mese) dove ospitare n8n in modo permanente e raggiungibile, seguendo la guida di self-hosting della documentazione ufficiale. In alternativa esiste n8n Cloud, la versione gestita a pagamento, che elimina la manutenzione del server.

Attenzione alla sicurezza: se esponi n8n su internet, proteggilo sempre con autenticazione e HTTPS, perche' le tue credenziali (email, API, account) sono conservate al suo interno. Non lasciare mai un'istanza raggiungibile pubblicamente senza protezione.

Errori comuni e come risolverli

• "ECONNREFUSED" o pagina che non si apre su localhost:5678: Docker non e' avviato, oppure la porta 5678 e' occupata. Verifica che Docker Desktop sia in esecuzione e, in caso, cambia porta (-p 5679:5678).
• "401 Unauthorized" dal nodo IA: la chiave API e' errata, scaduta o senza credito. Controllala nella dashboard del provider.
• L'agente non riceve il testo dell'email: il nome del campo non corrisponde. Apri il pannello dati del nodo email, individua il campo corretto (spesso text o snippet) e aggiornalo nel prompt.
• Rate limit del provider: se controlli le email troppo spesso, puoi superare i limiti di chiamate. Allunga l'intervallo del trigger.

Quando NON usare n8n (e come proseguire)

n8n e' ideale per automazioni che collegano piu' servizi con un pizzico di intelligenza. Se il tuo bisogno e' una singola chiamata a un modello dentro un'app che stai gia' sviluppando, conviene chiamare direttamente le API del provider dal tuo codice. E se il compito e' banale e occasionale, l'automazione rischia di costare piu' tempo di quanto ne faccia risparmiare.

Per andare avanti, esplora la documentazione ufficiale e i concetti di "tool" collegabili all'AI Agent: puoi dare all'agente la capacita' di cercare sul web, leggere un database o interrogare un foglio di calcolo, trasformandolo in un vero assistente operativo. Parti sempre da workflow che producono bozze da approvare, e passa all'automazione completa solo quando ti fidi dei risultati.