SviluppoAvanzato90 minuti · 6 passi

Costruire il primo agente AI con n8n, dall'installazione al flusso in produzione

Il percorso completo: server, installazione, nodo agente, strumenti collegati e messa in sicurezza.

Tra un'automazione e un agente c'è una differenza precisa: l'automazione esegue i passi che hai scritto, l'agente decide quali strumenti usare per raggiungere un obiettivo. n8n è la strada più praticabile per costruirne uno senza affidare i dati a un servizio esterno.

Cosa ottieni

Un agente che riceve una richiesta, sceglie gli strumenti da usare e restituisce un risultato tracciato.

Cosa serve prima di iniziare

  • Un server o un Mac sempre acceso con Docker
  • Una chiave API di un modello
  • Un dominio per esporre i webhook in sicurezza

I passi

  1. 1

    Installa n8n con Docker e un volume persistente

    Un solo comando e il servizio è in piedi. Il volume persistente è obbligatorio: senza, a ogni riavvio del contenitore perdi flussi e credenziali. È l'errore che tutti fanno la prima volta.

  2. 2

    Esponi solo i webhook, mai l'interfaccia

    L'amministrazione resta accessibile solo dalla rete locale o dietro un tunnel autenticato. Un'istanza n8n con l'editor esposto su internet è un accesso completo a tutte le credenziali che ci hai messo dentro.

  3. 3

    Definisci gli strumenti prima dell'agente

    Costruisci e collauda separatamente ogni sotto-flusso che l'agente potrà chiamare: cerca cliente, crea attività, invia email. Un agente con strumenti non collaudati produce errori impossibili da diagnosticare.

  4. 4

    Scrivi istruzioni con i limiti, non solo con l'obiettivo

    Cosa non deve fare mai, quando deve fermarsi e chiedere, cosa restituire se non ce la fa. Le istruzioni negative valgono più di quelle positive: sono il perimetro dentro cui l'autonomia è accettabile.

  5. 5

    Aggiungi memoria e tracciatura

    Un archivio Postgres per la memoria conversazionale e un log di ogni chiamata a strumento. Senza tracciatura, quando l'agente sbaglia non hai modo di capire quale passaggio ha deciso male.

  6. 6

    Metti in produzione con un tetto di spesa

    Un limite di chiamate per esecuzione e un tetto mensile sulla chiave API. Un agente in ciclo può bruciare il budget di un mese in una notte, e succede più spesso di quanto si creda.

Domande frequenti

n8n self-hosted è davvero gratuito?

La licenza fair-code consente l'uso interno gratuito senza limiti di esecuzioni. I costi sono il server, dai cinque ai venti euro al mese, e i token del modello. Le funzioni aziendali come SSO e ambienti separati sono a pagamento.

Meglio n8n o Make per iniziare?

Make se non hai un server e vuoi risultati in un'ora. n8n se i dati non devono uscire, se i volumi sono alti, o se prevedi di collegare cose che non hanno un connettore pronto.

Guide collegate

Tutte le guide →
Ogni giovedì

Tre notizie, un caso d'uso, un tool. Niente altro.

La versione scritta di quello che qui esce durante la settimana, tagliata per chi deve decidere.

Un'email a settimana, disiscrizione con un clic. Informativa privacy.

ELEVIACOM

Preferisci che questo flusso lo costruisca qualcun altro?

Lo progettiamo, lo colladiamo e lo manteniamo noi. La prima valutazione è gratuita e finisce con un documento, non con un preventivo.