Tutorial Completo di Dify per Principianti (2026)
Questo tutorial passo dopo passo ti porta da zero a un chatbot IA funzionante con Dify. Nessuna esperienza pregressa richiesta. Alla fine, avrai un chatbot distribuito alimentato dall'LLM di tua scelta — pronto per essere condiviso con chiunque.
Cos'è Dify?
Dify è una piattaforma open-source per costruire applicazioni alimentate da LLM. Fornisce un'interfaccia visuale per creare chatbot, agenti IA e applicazioni RAG — senza scrivere codice. Pensala come un toolkit completo per lo sviluppo di app IA: gestione dei modelli, basi di conoscenza, orchestrazione dei workflow e pubblicazione delle app tutto in un unico posto.
Dify supporta tutti i principali fornitori di IA (OpenAI, Anthropic, Google Gemini, Mistral) oltre ai modelli locali tramite Ollama. Controlli tu i prompt, i dati e dove viene ospitato tutto.
Prerequisiti
Prima di iniziare, assicurati di avere:
Di cosa avrai bisogno
Un account Dify o server
Dify Cloud (gratuito) o un VPS con Docker installato
Una chiave API LLM
OpenAI, Anthropic o Google Gemini — qualsiasi andrà bene
Un browser web
Chrome, Firefox, Safari — qualsiasi browser moderno funziona
Conoscenze base del terminale
Necessario solo se fai self-hosting. Non richiesto per Dify Cloud.
Avvia Dify
Hai due percorsi. Scegli quello adatto alla tua situazione:
Opzione A: Dify Cloud
- Vai su cloud.dify.ai
- Clicca su "Get Started" e crea un account gratuito
- Sei dentro — nessuna configurazione richiesta
Il livello gratuito include 200 crediti messaggio/mese. Ottimo per i test.
Opzione B: Self-host su Hetzner
- Prendi un server Hetzner CX22 (~€3,79/mese)
- Connettiti via SSH ed esegui:
git clone https://github.com/langgenius/dify.git && cd dify/docker && docker compose up -d - Apri la porta 80 — Dify è online
Connetti il tuo LLM
Dify deve connettersi a un LLM prima di poter costruire qualcosa. Ci vogliono meno di 2 minuti:
Clicca sul tuo avatar (in alto a destra) → Impostazioni
Vai a Fornitori di Modelli nella barra laterale sinistra
Clicca su OpenAI (o il tuo fornitore preferito)
Incolla la tua chiave API e clicca su Salva
Ottieni la tua chiave OpenAI su platform.openai.com/api-keys
Clicca su "Test" per verificare che la connessione funzioni
Crea il tuo primo chatbot
Costruiamo un semplice chatbot di supporto clienti. Ci vogliono circa 5 minuti:
Apri Studio
Clicca su "Studio" nella barra di navigazione superiore.
Crea un'app
Clicca sul pulsante "+ Crea App" in alto a destra.
Scegli Chatbot
Seleziona "Chatbot" dalle opzioni del tipo di app. Clicca su Avanti.
Nomina la tua app
Dagli un nome come "Bot Supporto Clienti". Clicca su Crea.
Seleziona il tuo modello
Nel selettore di modello (in alto a destra del canvas), scegli GPT-4o o il tuo modello preferito.
Scrivi un prompt di sistema
Nella casella di testo "Istruzioni", digita: "Sei un assistente di supporto clienti utile. Sii conciso, amichevole e preciso. Se non conosci la risposta, dillo."
Clicca su Pubblica
Premi il pulsante blu "Pubblica" in alto a destra. Il tuo chatbot è ora attivo.
Testa e condividi il tuo chatbot
Ora assicuriamoci che funzioni e condividiamolo con gli altri:
Pannello di anteprima
Sul lato destro dello Studio, vedrai un'anteprima della chat. Digita un messaggio e premi Invio per testare il tuo bot. Le modifiche al prompt di sistema hanno effetto immediato in modalità anteprima.
Link di condivisione
Dopo la pubblicazione, vai su Panoramica → clicca su "Esegui" per aprire la pagina di chat pubblica. Copia l'URL e condividilo con chiunque — possono chattare con il tuo bot senza effettuare l'accesso a Dify.
Incorpora in un sito web
Vai su Panoramica → Incorpora → copia il tag iframe o script. Incollalo in qualsiasi sito web per aggiungere un widget di chat. Colori e posizione completamente personalizzabili.
Accesso API
Ogni app Dify ottiene automaticamente una API REST. Vai a Riferimento API per ottenere la tua chiave e chiamarla da qualsiasi applicazione, inclusi n8n, Zapier o il tuo codice.
Costruisci una Base di Conoscenza (RAG)
Il RAG (Generazione Aumentata dal Recupero) permette al tuo chatbot di rispondere a domande dai tuoi documenti. Questa è una delle funzionalità killer di Dify:
Clicca su "Conoscenza" nella navigazione superiore
Clicca su "+ Crea Conoscenza"
Carica i tuoi documenti (PDF, Word, TXT, Markdown, pagine web)
Scegli le impostazioni di suddivisione (quelle predefinite funzionano bene nella maggior parte dei casi)
Clicca su "Salva ed Elabora" — Dify suddivide e incorpora automaticamente i tuoi documenti
Torna al tuo chatbot in Studio → sezione Contesto → clicca su "+ Aggiungi" → seleziona la tua base di conoscenza
Pubblica di nuovo. Il tuo bot ora può rispondere dai tuoi documenti.
Crea un Workflow
I workflow di Dify ti permettono di costruire pipeline IA multi-step usando un editor visuale basato su nodi. È più potente di un semplice chatbot — puoi concatenare chiamate LLM, fare richieste HTTP, eseguire codice e ramificare in base alle condizioni.
Inizio
Il punto di ingresso. Definisce le variabili di input (es., query_utente).
Nodo LLM
Chiama il tuo modello IA con un prompt. Può usare variabili dai nodi precedenti.
Richiesta HTTP
Effettua una chiamata API a qualsiasi servizio esterno. Utile per recuperare dati.
Nodo Codice
Esegue Python o JavaScript per trasformare i dati tra i passaggi.
SE/ALTRIMENTI
Ramifica il workflow in base alle condizioni. Instrada verso percorsi diversi.
Fine
Il nodo di output. Definisce cosa restituire all'utente.
Esempio: workflow di riepilogo articoli
Prossimi passi
Hai creato il tuo primo chatbot Dify. Ecco cosa esplorare dopo:
Passa da Cloud a Self-Hosted
Spostati su un VPS per crediti illimitati e piena proprietà dei dati. A partire da €3,79/mese.
Guida al self-hosting →Confronta i costi di hosting
Comprendi il quadro completo dei costi — VPS vs Dify Cloud vs livello gratuito.
Guida ai prezzi →Esplora i migliori provider
Confronta Hetzner, Hostinger, DigitalOcean e altri per fare self-hosting di Dify.
Confronta provider →Dify vs alternative
Scopri come Dify si confronta con Flowise, n8n, LangFlow e OpenWebUI.
Vedi alternative →Ospita Dify sul tuo server
Dify Cloud è ottimo per imparare, ma il vero potere viene dal self-hosting: crediti illimitati, piena privacy dei dati e nessun abbonamento SaaS mensile. Inizia da soli €3,79/mese su Hetzner.