Nodo Scheduled Trigger - Automazione Agentic Flow Basata sul Tempo in ConvyAI
Overview
Il nodo Scheduled Trigger avvia un Agentic Flow automaticamente secondo una pianificazione temporale configurata. Supporta due modalità: una modalità guidata con controlli visivi per la selezione dell'unità di ricorrenza, e una modalità Custom (cron) per pianificazioni avanzate con sintassi cron standard. Un hint in linguaggio naturale mostra in tempo reale l'interpretazione della schedulazione.
Posizionamento
Il nodo Scheduled Trigger non ha connessioni in ingresso e deve essere posizionato come primo nodo del flusso. Più nodi Scheduled Trigger possono coesistere nello stesso flusso - ciascuno genera una pianificazione indipendente e può avviare run distinti dello stesso flusso.
Configurazione
Modalità guidata
Seleziona l'unità temporale principale e compila i controlli corrispondenti:
| Unità temporale | Controlli disponibili |
|---|---|
| Minuti | Ogni N minuti (0–59) |
| Ore | Ogni N ore, al minuto MM (0–23, 0–59) |
| Giorni | Ogni N giorni, alle HH:MM |
| Settimane | Giorno/i della settimana + orario |
| Mesi | Giorno del mese (1–31) + orario |
La configurazione guidata genera internamente una cron expression a 5 campi.
Modalità Custom (cron)
Inserisci manualmente una cron expression a 5 campi:
minuto ora giorno-del-mese mese giorno-della-settimana
| Campo | Valori accettati |
|---|---|
| minuto | 0–59 |
| ora | 0–23 |
| giorno del mese | 1–31 |
| mese | 1–12 |
| giorno della settimana | 0–7 (0 e 7 rappresentano entrambi domenica) |
Caratteri supportati: *, -, ,, /
Esempio: */5 * * * * - ogni 5 minuti.
Hint in linguaggio naturale
Sotto l'area di configurazione è sempre visibile la descrizione testuale della schedulazione (es. */5 * * * * → "Every 5 minutes"). L'hint si aggiorna in tempo reale a ogni modifica valida, senza necessità di salvare. In caso di espressione non valida, l'hint mostra un messaggio di errore e il salvataggio del nodo è bloccato.
Comportamento in esecuzione
- Ogni occorrenza della cron expression avvia un nuovo run del flusso.
- I run vengono avviati entro 59 secondi dall'orario previsto, calcolato sul fuso orario del tenant.
- Nessun backfill: le esecuzioni mancate per downtime o flusso disabilitato non vengono recuperate. Lo scheduler riprende dalle prossime occorrenze future.
- Se il flusso viene disabilitato, tutte le pianificazioni associate vengono sospese automaticamente.
- Più istanze dello stesso flusso possono essere in esecuzione contemporaneamente se le pianificazioni si sovrappongono.
- I run avviati da Scheduled Trigger sono identificabili nella pagina Monitoring.
Output
Il nodo Scheduled Trigger non espone un payload di richiesta. I seguenti metadati di esecuzione sono disponibili ai nodi successivi:
Concetti chiave
| Termine | Definizione |
|---|---|
| Cron expression | Stringa a 5 campi che definisce la pianificazione: minuto ora giorno-del-mese mese giorno-della-settimana. |
| Modalità guidata | Interfaccia visuale per la configurazione della schedulazione senza conoscenza della sintassi cron. |
| Backfill | Recupero di esecuzioni mancate. Il sistema non implementa backfill - le esecuzioni saltate non vengono mai recuperate. |