Questa pagina è stata spostata. Vai al Riferimento Nodi →

4.3 Riferimento Nodi

Ogni azione all'interno di un workflow Flusso viene eseguita da un nodo. Questo riferimento documenta ogni tipo di nodo disponibile: cosa fa, come configurarlo e quale output produce. I nodi sono raggruppati per categoria, in corrispondenza con l'organizzazione della barra laterale nell'editor.

---

1. Trigger

I trigger sono il punto di partenza di ogni workflow. È consentito un solo trigger per workflow. Il trigger si attiva in base a un evento esterno e passa il suo payload nel contesto del workflow come {{ trigger.output.* }}.

Trigger Manuale

Si attiva quando clicchi il pulsante Esegui nell'editor o invochi il workflow tramite API. Usalo per attività su richiesta e per test durante lo sviluppo.

Output: Qualsiasi dato passato come payload dell'esecuzione (tramite API o modulo di test).

Trigger Webhook

Si attiva quando viene ricevuta una richiesta HTTP POST all'URL webhook univoco del workflow (/api/webhooks/{workflow-id}). Il corpo della richiesta, gli header e il metodo sono disponibili nell'output.

Output: payload (corpo della richiesta), headers, method.

Trigger Pianificato

Si attiva secondo una pianificazione ripetitiva definita da un'espressione cron. Il workflow viene eseguito automaticamente ad ogni orario pianificato finché è in stato Attivo.

Output: scheduled_at — il timestamp ISO di quando l'esecuzione è stata attivata.

Trigger Evento

Si attiva quando un altro workflow emette un evento denominato tramite il nodo Emetti Evento. Usalo per concatenare workflow: uno emette, un altro ascolta.

Output: event_name, payload (dati dal workflow emittente).

Trigger Errore

Si attiva automaticamente quando qualsiasi altro workflow nel tuo account incontra un errore fatale durante l'esecuzione. Usalo per costruire workflow centralizzati di gestione errori o allerta.

Output: workflow_id, run_id, step_key, error_message.

Trigger Specifici per Piattaforma

I seguenti trigger funzionano come il Trigger Webhook ma validano firme specifiche della piattaforma:

• Trigger Stripe — valida le firme webhook di Stripe.
• Trigger GitHub — valida le firme HMAC dei webhook GitHub.
• Trigger Shopify — valida le firme HMAC-SHA256 dei webhook Shopify.

Output: Come il Trigger Webhook — il corpo della richiesta è disponibile come payload.

Trigger File Watch

Questi trigger si attivano quando viene rilevato un nuovo file in una posizione monitorata:

• Google Drive Watch — monitora una cartella Google Drive.
• Dropbox Watch — monitora una cartella Dropbox.
• Local File Watch — monitora una directory locale sul server.

Output: file_name, file_path, file_size, mime_type.

---

2. AI & Agenti

Agent

Il nodo più potente di Flusso. Il nodo Agent invia un prompt a un modello linguistico di grandi dimensioni e restituisce la sua risposta. Gli agenti possono opzionalmente eseguire RAG (recuperare contesto rilevante da una knowledge base), invocare strumenti esterni e mantenere memoria tra le esecuzioni.

Output: text (risposta grezza del modello), json (JSON parsato se la Modalità JSON è attiva), usage (conteggio token).

Model Config Solo Grafo

Un nodo di configurazione (non eseguito) che specifica il modello AI utilizzato da un nodo Agent in modalità grafo. Collega il suo output alla porta model_in di un nodo Agent.

Memory Solo Grafo

Un nodo di configurazione che specifica un backend di memoria per un nodo Agent in modalità grafo. Collegalo alla porta memory_in.

MCP Tool Solo Grafo

Un nodo di configurazione che definisce uno strumento esterno accessibile a un nodo Agent tramite il Model Context Protocol (MCP). Collegalo alla porta tool_in. Più nodi MCP Tool possono collegarsi allo stesso Agent.

---

3. Recupero & Elaborazione Dati

RAG (Ricerca Knowledge Base)

Esegue una ricerca semantica vettoriale su una delle tue Knowledge Base. Restituisce gli estratti di documenti più rilevanti, che puoi poi passare a un nodo Agent tramite l'impostazione Fonti di Contesto.

Output: items — array di oggetti { text, score, metadata }.

Reranker

Riordina una lista di risultati di ricerca usando un modello cross-encoder che valuta la rilevanza di ogni risultato rispetto alla query in modo più preciso della sola similarità vettoriale.

Output: items — array riordinato di oggetti { text, score, metadata }.

Ricerca Web

Esegue una ricerca web in tempo reale e restituisce una lista di risultati (titolo, URL, estratto). Utile per agenti che necessitano di informazioni aggiornate.

Output: results — array di { title, url, snippet }.

Richiesta HTTP

Effettua una richiesta HTTP in uscita verso qualsiasi URL. Usa questo nodo per interagire con API REST esterne, recuperare dati remoti o inviare dati a servizi di terze parti.

Output: status (codice stato HTTP), body (corpo della risposta), headers.

Trasformazione

Mappa e rimodella i dati da uno step precedente in una nuova struttura. Definisci un set di campi di output, ognuno con un nome e un'espressione di valore (supporta riferimenti alle variabili e valori statici).

Output: Un oggetto con i campi definiti come chiavi.

Estrattore Schema

Usa un modello AI per estrarre dati strutturati da testo non strutturato (email, documenti, pagine web). Definisci uno JSON Schema che descrive l'output atteso; il modello lo compila.

Output: Un oggetto conforme allo schema definito.

Generazione Immagini

Genera un'immagine da un prompt testuale usando un modello AI per immagini (es. DALL-E 3, Stable Diffusion).

Output: url (URL dell'immagine generata), revised_prompt.

---

4. Controllo del Flusso

Logic Gate

Valuta una o più condizioni e instrada il workflow verso il ramo vero o falso in base al risultato. Le condizioni vengono combinate con logica AND o OR.

Output: result (true o false). L'esecuzione continua solo lungo il ramo corrispondente.

Switch

Instrada il workflow verso uno dei diversi rami denominati in base al valore di un'espressione. Simile a un'istruzione switch/case nella programmazione.

Output: matched_case — il caso corrispondente.

Loop

Itera su un array ed esegue i sotto-step per ogni elemento. L'elemento corrente è disponibile all'interno del loop come variabile.

Output: results — array di output da ogni iterazione; count — numero di iterazioni.

Parallel

Divide l'esecuzione in più rami che vengono eseguiti simultaneamente. Tutti i rami devono completarsi prima che il workflow prosegua oltre il nodo parallelo.

Output: Un oggetto indicizzato per nome ramo, ognuno contenente l'output dell'ultimo step di quel ramo.

Stop

Termina esplicitamente l'esecuzione del workflow con un dato stato. Usalo alla fine dei rami condizionali per segnalare successo o fallimento.

Wait

Mette in pausa l'esecuzione del workflow per un numero fisso di secondi prima di continuare.

Random

Genera un numero casuale o seleziona un elemento casuale da una lista. Utile per A/B testing, instradamento casuale o simulazioni.

Output: value — il numero generato o l'elemento scelto.

---

5. Manipolazione Dati

Set Variable

Crea o aggiorna variabili del workflow che persistono tra gli step. A differenza degli output degli step, le variabili possono essere aggiornate più volte durante l'esecuzione di un workflow.

Output: Le variabili impostate come coppie chiave-valore.

Counter

Incrementa o decrementa una variabile numerica del workflow. Utile all'interno dei loop per contare elementi o tracciare il progresso.

Output: value — il nuovo valore del contatore.

Filter

Filtra un array per mantenere solo gli elementi che corrispondono a una condizione.

Output: L'array filtrato salvato nella variabile di output specificata.

---

6. Notifiche & Messaggistica

Notifica Email

Invia un'email usando il server SMTP configurato nelle Impostazioni. Richiede che SMTP sia configurato prima.

Output: sent (booleano), message_id.

Notifica Webhook

Invia una richiesta HTTP POST a un URL esterno. Più semplice del nodo Richiesta HTTP — pensato per notifiche in uscita.

Notifica In-App

Crea una notifica visibile nella campanella notifiche di Flusso per un utente specifico.

Messaggio Slack

Invia un messaggio a un canale Slack tramite l'API Slack o un URL webhook.

Messaggio Discord

Invia un messaggio a un canale Discord tramite un URL webhook Discord.

Messaggio Telegram

Invia un messaggio a una chat Telegram tramite l'API Bot Telegram.

Emetti Evento

Emette un evento denominato che può attivare qualsiasi workflow che usa un Trigger Evento in ascolto sullo stesso nome evento. Usalo per concatenare workflow insieme.

Risposta Webhook

Invia una risposta HTTP al chiamante di un workflow attivato via webhook. Applicabile solo quando il workflow è attivato tramite webhook e il chiamante è in attesa di una risposta sincrona.

---

7. Operazioni su File

Tutti i nodi operazioni file condividono un set comune di azioni: read, write e append.

File System Locale

Legge o scrive file sul filesystem locale del server.

Output: content (read), oppure path e bytes_written (write/append).

Google Drive

Legge o scrive file in Google Drive. Richiede un account Google collegato nel pannello Credenziali del workflow.

Dropbox

Legge o scrive file in Dropbox. Configura le credenziali di accesso Dropbox nelle impostazioni Integrazioni.

Amazon S3

Legge o scrive file in un bucket AWS S3. Configura le tue credenziali AWS e il nome del bucket.

Google Sheets

Legge o scrive dati in un foglio di calcolo Google Sheets. Richiede l'integrazione Google autorizzata nel pannello Credenziali del workflow.

Output: values (array 2D per read), oppure updated_cells (per write).

---

8. Interazione Umana / Utente

Approvazione

Mette in pausa il workflow e attende che un essere umano approvi o rifiuti la continuazione. Il workflow entra in stato In attesa e l'attività in sospeso appare nella pagina Attività.

Comportamento: Se approvato, l'esecuzione continua allo step successivo. Se rifiutato, l'esecuzione del workflow viene terminata con stato fallito.

Input Manuale

Mette in pausa il workflow e attende che un essere umano compili uno o più campi di un modulo. Il modulo appare nella pagina Attività. Quando viene inviato, i valori inseriti sono disponibili negli step successivi del workflow.

Output: Un oggetto con il nome di ogni campo come chiave e l'input dell'utente come valore.