Assistenti workflow
Gli assistenti workflow sono una forma avanzata di assistenti AI. Invece di una conversazione completamente aperta, l’utente segue una serie definita di passaggi guidati dall’AI. Questo rende possibile accompagnare processi complessi e multi-step — dall’inizio alla fine, passo dopo passo.
Che cos’è un assistente workflow?
Un assistente workflow funziona sulla base di un diagramma di flusso visivo composto da nodi collegati da frecce. Ogni nodo svolge un compito specifico:
| Tipo di nodo | Descrizione |
|---|---|
| Inizio / Fine | Punto di inizio e punto finale del workflow |
| Valuta | Analizza il contesto e salva le informazioni nella memoria del workflow |
| Condizione | Valuta un’espressione e instrada il flusso nella direzione corretta |
| LLM | Invoca un modello linguistico per un compito specifico (opzionale: attende input) |
| Approvazione | Pone una domanda sì/no e instrada il flusso in base alla risposta |
| Collega | Collega i percorsi senza un compito AI o un output visibile |
| Subagent | Esegue lo stesso compito in parallelo per più elementi |
Il workflow salva automaticamente il proprio stato dopo ogni passaggio. Quando l’utente fornisce input, il workflow riprende esattamente da dove era rimasto — anche dopo la chiusura del browser.
Come uso un assistente workflow?
Avvia una nuova conversazione e scegli un assistente workflow dall’elenco. L’assistente ti guiderà automaticamente attraverso tutti i passaggi. In alcuni passaggi l’assistente attende la tua risposta, in altri procede autonomamente senza input.
Sul lato destro dell’input della chat vedrai il pulsante Workflow. Cliccalo per aprire un pannello con tutti i passaggi e il loro stato attuale (in attesa, attivo, completato, in attesa di input, saltato, errore).
Puoi chiudere la chat in qualsiasi momento e riprendere più tardi. Il workflow continuerà dal punto in cui eri rimasto.
Esempio: Ricerca approfondita
Il preset Ricerca approfondita è un esempio di assistente workflow disponibile in tutti gli ambienti. Guida l’utente attraverso un processo di ricerca accurato:
- Definire l’argomento — l’AI chiede il tema della ricerca e il livello di approfondimento desiderato
- Formulare domande di ricerca — l’AI elabora domande di ricerca mirate
- Eseguire la ricerca — l’AI svolge la ricerca e raccoglie informazioni
- Generare il report — l’AI scrive un report di ricerca strutturato
- Concludere — l’utente valuta il report e può porre ulteriori domande
Creare un assistente workflow
Apri Assistenti e seleziona la scheda Assistenti workflow. Nella scheda in alto clicca su Nuovo workflow e scegli Crea o modifica workflow con AI, Workflow vuoto, Workflow n8n oppure un preset. In Avvio rapido puoi avviare direttamente un preset o scegliere Usa come modello.
Puoi anche convertire un assistente esistente: nel menu della scheda dell’assistente scegli Apri come workflow. Otterrai una nuova bozza non condivisa; l’assistente originale rimane esistente. Controlla e testa i passaggi proposti prima di pubblicare.
Gli assistenti workflow possono essere condivisi, come i normali assistenti, con gruppi di utenti e colleghi, anche dall’editor tramite il pulsante Condividi nella barra degli strumenti. Con la condivisione ai colleghi, AI-Public può inviare automaticamente una notifica via e-mail così che i destinatari sappiano che l’assistente workflow è disponibile.
Avviare un workflow n8n
Oltre agli assistenti workflow gestiti dall’AI, AI-Public può anche avviare un workflow n8n tramite webhook. Un workflow n8n non apre una chat: senza campi il webhook viene chiamato direttamente, con campi si apre prima un modulo. Gli amministratori lo creano tramite Assistenti → Assistenti workflow → Nuovo workflow → Workflow n8n.
Leggi la spiegazione completa nella pagina workflow n8n.
Impostazioni generali
Quando crei o modifichi un workflow, nel pannello delle impostazioni configuri quanto segue per l’intero workflow:
- Modello: Il modello AI utilizzato da tutti i passaggi.
- Tool: Quali strumenti sono disponibili (ad es. Registrazione, Ricerca internet). I passaggi possono disattivare gli strumenti abilitati globalmente per quel passaggio.
- Server MCP: Collegamenti esterni.
- Documenti e immagini: File che i passaggi LLM possono consultare.
Creare un nodo di triage
Un nodo valuta analizza l’input dell’utente e salva valori strutturati nella memoria (ad es. route, argomento). Configura:
- Un prompt di sistema che descrive cosa deve essere analizzato.
- Lo schema di output: campi con nome e tipo (
string,number,boolean,enum).
I valori salvati sono disponibili come state.nomeCampo nei nodi condizione.
Configurare un nodo condizione
Un nodo condizione legge la memoria del workflow e indirizza il flusso al passaggio successivo corretto tramite espressioni CEL:
| Comportamento desiderato | Espressione |
|---|---|
Il campo è true | state.voldoende_info == true |
| Il campo ha un valore | state.route == "rapport" |
| Soglia numerica | state.score > 7 |
Ogni branch ha una propria connessione al nodo successivo.
Usare un nodo di collegamento
Un nodo collega non esegue alcun compito AI. Il nodo semplicemente inoltra il workflow al passaggio successivo. Usa questo nodo per riunire in modo ordinato i percorsi, ad esempio quando un ramo salta un passaggio e deve poi ricollegarsi al percorso principale.
Un nodo collega deve avere almeno una connessione in ingresso e una in uscita. Il nodo non viene mostrato come passaggio contenutistico separato nell’avanzamento del workflow.
Registrazione nei workflow
Attiva il tool Registrazione tramite le impostazioni generali e aggiungi nelle istruzioni di sistema di un passaggio un’indicazione per registrare i risultati. L’utente vede i documenti registrati tramite il pulsante Registrazione (📄) nella barra degli strumenti.
Ripristinare una conversazione
Non sei soddisfatto della direzione della conversazione? Tramite il pulsante di ripristino su un messaggio precedente puoi riportare il workflow a quel punto. Tutti i messaggi successivi vengono eliminati e il workflow riprende esattamente da quel momento.
Il ripristino è definitivo — i messaggi eliminati non possono più essere recuperati.
File e subagent nei workflow
Un workflow può chiedere all’utente di caricare file, ad esempio un documento sorgente, un modello di valutazione, un contratto, un documento di policy o un modulo compilato. L’utente può caricare un nuovo file oppure scegliere un file esistente da Gestione file. I file aggiunti tramite un modulo del workflow diventano disponibili per l’assistente in quella chat, ma non vengono selezionati automaticamente per le normali domande in chat.
I nuovi file vengono prima elaborati prima che il workflow possa proseguire in modo affidabile. Se un file obbligatorio è ancora in elaborazione o è fallito, l’utente deve attendere o selezionare/caricare di nuovo il file.
Il nodo Subagent esegue lo stesso compito in parallelo per più elementi. Usalo quando un workflow deve elaborare un elenco, ad esempio un documento, partecipante, dipendente, cliente, pratica o modulo per ogni esecuzione. Il subagent riceve ogni volta l’elemento corrente in un contesto isolato. Fai quindi riferimento esplicitamente all’elemento corrente nei prompt ed evita istruzioni che elaborino più elementi contemporaneamente.
Creare o modificare un workflow con l’AI
Discuti il tuo workflow con l’AI. Le modifiche valide compaiono nell’editor. Controlla e testa il risultato prima di salvarlo o pubblicarlo.