🇮🇹 IT

🎲 Random

Genera un numero intero casuale all'interno di un intervallo, oppure seleziona un elemento casuale da un elenco. Utile per A/B testing, instradamento casuale, campionamento e distribuzione del carico.

Categoria: Controllo di Flusso · Identificatore tipo: random

Panoramica

Il nodo Random introduce un non-determinismo controllato nei tuoi workflow. Puoi usarlo in due modalità:

Modalità numero — genera un numero intero casuale tra un valore minimo e massimo (entrambi inclusi). Ottimo per generare numeri di riferimento, dati di test o soglie di probabilità.
Modalità scelta — seleziona un elemento a caso da un elenco che definisci. Ogni elemento nell'elenco ha la stessa probabilità di essere selezionato. Ideale per A/B o test multivariato, template di messaggi casuali o distribuzione del lavoro tra più destinatari.

Il risultato è disponibile come variabile e può essere passato a un nodo Switch per instradare l'esecuzione in base alla variante selezionata, oppure usato direttamente in un template.

Configurazione

Campo	Stato	Descrizione
Modalità	Obbligatorio	`number` — genera un numero intero casuale; `choice` — seleziona un elemento da un elenco definito.
Min	Condizionale	Obbligatorio quando Modalità è `number`. Il valore minimo (incluso). Supporta riferimenti `{{ variabile }}`.
Max	Condizionale	Obbligatorio quando Modalità è `number`. Il valore massimo (incluso). Deve essere maggiore o uguale a Min. Supporta riferimenti `{{ variabile }}`.
Scelte	Condizionale	Obbligatorio quando Modalità è `choice`. Un array di valori tra cui selezionare. Ogni voce può essere una stringa statica, un numero o un riferimento `{{ variabile }}`. Tutti gli elementi hanno uguale probabilità.
Seed	Opzionale	Un seed intero fisso per il generatore di numeri casuali. Quando impostato, lo stesso seed produce sempre lo stesso risultato. Utile per testare i workflow in modo riproducibile senza cambiare la configurazione del nodo.

Dati di Output

Variabile	Tipo	Descrizione
`value`	integer o string	Il numero generato (in modalità numero) o l'elemento selezionato (in modalità scelta).
`mode`	string	La modalità utilizzata: `"number"` o `"choice"`.
`index`	integer	In modalità scelta: la posizione a base zero dell'elemento selezionato nell'elenco Scelte. Sempre `null` in modalità numero.

// Accedi agli output random (sostituisci "random_step" con la tua chiave step) {{ random_step.output.value }} {{ random_step.output.mode }} {{ random_step.output.index }}

Esempio di Utilizzo

A/B test — instrada gli utenti verso una delle due varianti

Aggiungi un nodo Random (chiave step: ab_picker). Imposta Modalità su choice e aggiungi due scelte: variant_a e variant_b.
Aggiungi un nodo Switch dopo di esso. Imposta l'Espressione su:
{{ ab_picker.output.value }}
Aggiungi i casi variant_a e variant_b.
Collega ogni ramo dello Switch al template email o nodo azione appropriato. Ogni esecuzione utente riceverà casualmente una variante.

Generare un codice di verifica casuale

Mode: number Min: 100000 Max: 999999 // Usa il risultato in un nodo Send Email Il tuo codice di verifica è: {{ verify_code.output.value }}

Suggerimenti e Note

Solo probabilità uguale. Tutte le scelte hanno la stessa probabilità di essere selezionate. Se hai bisogno di casualità ponderata (es. 70% variante A, 30% variante B), usa una modalità Numero con un intervallo 1–10 e un Logic Gate — instrada i numeri 1–7 alla variante A e 8–10 alla variante B.
Seed per test riproducibili. Imposta un valore Seed durante lo sviluppo per ottenere risultati consistenti tra le esecuzioni di test. Rimuovi o cambia il seed in produzione per ripristinare la vera casualità.
Combina con Switch. Il nodo Random da solo seleziona solo un valore. Per instradare effettivamente l'esecuzione in base a quel valore, invia l'output a un nodo Switch — questo è il pattern standard per la ramificazione casuale.

Nodi Correlati

Switch — instrada l'esecuzione in base al valore casuale prodotto.
Logic Gate — applica controlli di soglia a un numero casuale (es. valore < 5 per probabilità ponderata).