> ## Documentation Index > Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Flussi > Progetta alberi conversazionali con riquadri e connessioni. Crea flussi di interazione visivi per guidare le conversazioni del tuo agente IA. Il modulo **Flussi** ti permette di costruire **flussi conversazionali** in modo visuale — immaginalo come una tela dove disegni il percorso esatto che il tuo agente IA deve seguire durante una conversazione. Invece di affidarti esclusivamente alle risposte libere dell'IA, i Flussi ti danno un controllo granulare su come si sviluppano le interazioni passo dopo passo. Usa i Flussi quando hai bisogno di: * **Conversazioni strutturate:** Guidare l'utente attraverso una sequenza specifica (es. onboarding, risoluzione problemi, raccolta dati). * **Percorsi di escalation umana:** Definire regole chiare su quando e come una conversazione deve essere trasferita a un agente umano. * **Integrazioni API:** Chiamare servizi esterni in punti specifici della conversazione per recuperare o inviare dati. * **Strumenti Lovi:** Sfruttare le capacità integrate di Lovi all'interno del flusso per azioni avanzate. *** ## Primi Passi Quando apri la sezione Flussi per la prima volta, vedrai uno stato vuoto che ti invita a creare il tuo primo flusso. Clicca sul pulsante **+ Nuovo flusso** nell'angolo in alto a destra (o sul pulsante **+ Crea il mio primo flusso** al centro) per iniziare. *** ## Creare un Nuovo Flusso Apparirà un dialogo che ti chiede di configurare i dati di base del tuo flusso: | Campo | Descrizione | | :----------------------------------- | :--------------------------------------------------------------------------------------- | | **Nome del flusso** *(obbligatorio)* | Un nome descrittivo per il tuo flusso (es. `Saluto e politiche`, `Tracciamento ordini`). | | **Descrizione** *(opzionale)* | Una breve spiegazione di cosa fa questo flusso. Utile per mantenere il team allineato. | | **Agente IA** *(obbligatorio)* | L'agente IA a cui questo flusso sarà collegato. Selezionane uno dal menu a tendina. | | **Tipo di flusso** | Scegli come vuoi iniziare a costruire. | ### Tipi di Flusso | Tipo | Descrizione | | :------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- | | **Personalizzato (vuoto)** | Parti da zero con solo un nodo di attivazione. Totale libertà creativa per costruire il tuo flusso. | | **Escalation umana** | Un modello preconfigurato progettato per trasferire le conversazioni dall'agente IA a un agente umano. Ideale per i flussi di supporto. | Una volta compilati i dettagli, clicca su **Crea flusso** per entrare nell'editor dei flussi. *** ## L'Editor dei Flussi (Tela) Dopo aver creato un flusso, verrai indirizzato all'**editor dei flussi** — una tela interattiva dove progetti il tuo albero conversazionale usando nodi e connessioni con trascinamento. In cima all'editor vedrai: * Il **nome del flusso** e l'**agente IA collegato**. * Una barra degli strumenti con i tipi di nodi disponibili. * Un pulsante **Salva** per salvare le modifiche. In basso a sinistra troverai i controlli della tela: **zoom avanti**, **zoom indietro**, **adatta allo schermo** e **blocca/sblocca** la tela. *** ## Tipi di Nodi I nodi sono i mattoni del tuo flusso. Ogni nodo rappresenta un passaggio nella conversazione. Li aggiungi dalla barra degli strumenti in cima all'editor e li colleghi per definire il percorso della conversazione. ### 1. Nodo Agente Il **nodo Agente** rappresenta un punto in cui l'agente IA parla o esegue un'azione. Usalo per: * Inviare un messaggio all'utente. * Elaborare informazioni usando il motore IA. * Prendere decisioni basate sul contesto della conversazione. Questo è il nodo più comune — è l'IA che svolge il suo lavoro all'interno del flusso. ### 2. Nodo Utente Il **nodo Utente** rappresenta un punto in cui il sistema attende un input dall'utente. Usalo per: * Catturare una risposta specifica dall'utente. * Ramificare il flusso in base a ciò che l'utente dice o seleziona. * Raccogliere dati (nomi, email, preferenze, ecc.). Pensalo come un passaggio "pausa e ascolta" nella conversazione. ### 3. Nodo API Il **nodo API** ti permette di integrare servizi esterni direttamente nel flusso. Usalo per: * Recuperare dati da un sistema di terze parti (es. stato dell'ordine, informazioni account). * Inviare dati a un servizio esterno (es. creare un ticket, aggiornare un CRM). * Attivare webhook in punti specifici della conversazione. È così che il tuo flusso si connette al mondo esterno. ### 4. Nodo Strumenti Lovi Il **nodo Strumenti Lovi** ti dà accesso alle capacità integrate di Lovi all'interno del flusso. Usalo per: * Eseguire azioni specifiche della piattaforma (es. taggare una conversazione, assegnare a un dipartimento). * Utilizzare funzionalità avanzate di Lovi che vanno oltre le semplici risposte testuali. * Automatizzare operazioni interne come parte del flusso conversazionale. *** ## Costruire un Flusso Ecco il flusso di lavoro generale per costruire un flusso conversazionale: 1. **Inizia con il trigger:** Ogni flusso inizia con un nodo di attivazione che definisce quando il flusso si avvia. 2. **Aggiungi nodi:** Trascina i nodi dalla barra degli strumenti sulla tela. 3. **Collega i nodi:** Disegna connessioni tra i nodi per definire il percorso della conversazione. Clicca semplicemente sulla porta di uscita di un nodo e trascina fino alla porta di ingresso di un altro. 4. **Configura ogni nodo:** Clicca su un nodo per aprire il suo pannello di configurazione e definire cosa fa (messaggi, condizioni, chiamate API, ecc.). 5. **Salva:** Clicca sul pulsante **Salva** per salvare il tuo flusso. ### Consigli per Flussi Efficaci * **Mantieni la semplicità:** Inizia con un flusso minimale e espandilo secondo necessità. Gli alberi troppo complessi sono difficili da mantenere. * **Testa frequentemente:** Dopo aver salvato, testa il flusso attraverso il tuo agente IA collegato per assicurarti che la conversazione risulti naturale. * **Usa le ramificazioni con saggezza:** I nodi utente possono ramificarsi in percorsi multipli — usalo per gestire diverse intenzioni dell'utente senza rendere il flusso troppo profondo. * **Combina con l'IA:** I Flussi non sostituiscono l'IA — la guidano. L'agente IA gestisce ancora le sfumature; il flusso fornisce la struttura. *** ## Buone Pratiche * **Nomina i tuoi flussi chiaramente:** Usa nomi descrittivi affinché il tuo team sappia a colpo d'occhio cosa gestisce ogni flusso. * **Un flusso per obiettivo:** Invece di costruire un flusso enorme, crea flussi separati per obiettivi distinti (es. uno per l'onboarding, un altro per l'escalation del supporto). * **Documenta con le descrizioni:** Usa il campo descrizione quando crei un flusso — il tuo io futuro (e i tuoi colleghi) ti ringrazieranno. * **Rivedi e itera:** I flussi sono documenti viventi. Controlla le tue analisi per vedere dove gli utenti abbandonano e perfeziona i percorsi di conseguenza. *** ## Riferimento Rapido | Azione | Come | | :--------------------- | :---------------------------------------------------------------- | | Creare un nuovo flusso | Clicca su **+ Nuovo flusso** nell'angolo in alto a destra | | Aggiungere un nodo | Clicca sul pulsante del tipo di nodo nella barra degli strumenti | | Collegare i nodi | Trascina dall'uscita di un nodo all'ingresso di un altro | | Configurare un nodo | Clicca sul nodo nella tela | | Salvare le modifiche | Clicca sul pulsante **Salva** | | Zoom avanti/indietro | Usa i controlli in basso a sinistra della tela | | Adatta allo schermo | Clicca sull'icona di adattamento allo schermo in basso a sinistra |