Cosa fa un workflow
Un workflow è una sequenza controllata di passaggi che l’assistente segue: verifica condizioni, richiama agenti, cerca nella conoscenza, invia email e costruisce la risposta finale.
Usa un workflow quando una risposta richiede più di una semplice ricerca: ad esempio verificare lo stato di un ordine solo dopo aver ottenuto numero d’ordine ed email, oppure aprire un ticket e confermarlo via email.
Passo 1: crea il workflow
Apri la sezione Workflow del tuo assistente e fai clic su Aggiungi.
Inserisci un Nome e una Descrizione chiari, ad esempio “Verifica stato ordine”.
Aggiungi le Domande di attivazione – richieste reali che un utente potrebbe scrivere, una per riga, come “Voglio sapere a che punto è il mio ordine”.
Scegli la Modalità di attivazione: Semantica (attivata dalle domande di attivazione), Default (usata quando nient’altro corrisponde) o Manuale (richiamata solo da un altro workflow).
Scegli la Fase di esecuzione: la pre-elaborazione avviene prima della ricerca nei contenuti; la post-elaborazione dopo.
Come scrivere buone domande di attivazione
- Scrivi frasi naturali con un’azione, di almeno 20 caratteri e quattro parole significative.
- Evita parole chiave isolate o termini tecnici come “reso”, “JSON” o “workflow”.
Passo 2: costruiscilo nell’editor visuale
Trascina i nodi dalla palette elementi nell’area grafica e collega le loro porte. Ogni workflow inizia con un nodo Avvio e termina con almeno un nodo Fine.
| Tipo di nodo | Esempi | A cosa serve |
|---|---|---|
| Controllo del flusso | If, Switch, Loop, Unisci, Stop / Errore | Creare diramazioni, ripetere passaggi o interrompere in sicurezza. |
| Trasformazione dati | Modifica campi, Filtra, Ordina, Aggrega | Preparare e ordinare i dati tra un passaggio e l’altro. |
| Core | Richiesta HTTP, Data / Ora, Richiesta IA | Chiamare un servizio, gestire date o chiedere all’IA di classificare o riassumere. |
| Echo7 | Agente, Conoscenza / RAG, Set Response, Invia email, Aggiungi Q&A | Usare integrazioni e conoscenza e inviare la risposta finale. |
I passaggi si scambiano informazioni tramite variabili come {{variables.orderId}}. Usa sempre lo stesso nome per lo stesso dato in tutto il workflow.
Fatti aiutare dall’IA
Fai clic su Genera workflow, seleziona le integrazioni utilizzabili e descrivi ciò che ti serve. Ad esempio: “Crea un workflow per verificare lo stato di un ordine. L’utente fornisce numero d’ordine ed email. Se uno dei due manca, chiedilo. Usa l’agente e-commerce, gestisci il caso di ordine non trovato e rispondi con lo stato e un pulsante per i dettagli della spedizione.”
La bozza viene caricata nell’editor. Controllala, poi fai clic su Salva.
Passo 3: testalo con il debugger
Salva il workflow, poi fai clic su Avvia debug e scrivi una richiesta realistica.
Segui il log di esecuzione per vedere ogni nodo, le variabili prodotte ed eventuali errori.
Aggiungi breakpoint per fermarti su nodi specifici e usa F8 per procedere passo passo.
Prova almeno tre casi: una richiesta valida, una con informazioni mancanti e un errore di un servizio esterno.
Passo 4: abilitalo sul tuo assistente
Modifica l’assistente e vai a Configurazione dei workflow. Fai clic su Abilita workflow, selezionalo e controlla lo Stato. Se risulta “attivo ma non eseguibile”, manca o è disattivata un’integrazione o un agente necessario – lo stato ti indica quale.
Buone pratiche
- Prevedi un ramo di errore per ogni chiamata esterna, così l’utente riceve sempre una risposta utile.
- Aggiungi un fallback a ogni nodo Switch.
- Usa Export workflow per salvare le versioni approvate o copiarle tra assistenti.
Preferisci una guida passo passo? Prenota una sessione di formazione e uno specialista Echo7 aiuterà il tuo team nella configurazione.
Prenota una sessione di formazioneVuoi approfondire?
Questa guida copre gli aspetti essenziali. Per la documentazione dettagliata su ogni impostazione e funzionalità, consulta la Wiki completa di Echo7.
Echo7 Wiki