Automazione e Pianificazione
Cron Job
Pianifica i risvegli degli agenti con una tempistica precisa. I cron job persistono tra i riavvii del Gateway e supportano schemi di pianificazione flessibili.
Tipi di Pianificazione
| Tipo | Descrizione | Esempio |
|---|---|---|
| Espressione cron | Sintassi cron standard con fuso orario | 0 7 * * * (ogni giorno alle 7:00) |
| Intervallo | Ripeti a intervalli fissi | 30m, 2h, 1d |
| Singola esecuzione | Esegui una volta a un'ora specifica | 2026-03-15T16:00:00Z |
Target della Sessione
- Sessione principale, Inserisce come evento di sistema nella conversazione principale dell'agente
- Sessione isolata, Esegui in una sessione dedicata (
cron:<jobId>) per evitare di contaminare le conversazioni principali
Modalità di Consegna
| Modalità | Descrizione |
|---|---|
| Nessuna | Esecuzione silenziosa (nessun output pubblicato) |
| Annuncio | Pubblica il risultato in un canale specifico |
| Webhook | HTTP POST del risultato a un URL esterno |
Promemoria a Singola Esecuzione
Imposta un promemoria per un'ora specifica. L'agente si sveglia, elabora il promemoria e facoltativamente elimina il lavoro dopo l'esecuzione.
Lavori Ricorrenti
Pianifica attività ripetitive con espressioni cron e supporto del fuso orario. I lavori tengono traccia della loro cronologia di esecuzione (successo, errore, tempistica).
Webhook
Ricevi eventi da servizi esterni e instradali agli agenti.
Gmail Pub/Sub
Integra con il sistema di notifiche push di Gmail per attivare azioni degli agenti quando arrivano le email:
- Configura un topic e una sottoscrizione GCP Pub/Sub
- Configura il filtro delle etichette Gmail
- Punta la consegna push al tuo URL webhook
- Neotask riceve i messaggi e inserisce eventi degli agenti
Webhook Personalizzati
Registra endpoint HTTP che attivano turni degli agenti quando vengono chiamati. Utile per l'integrazione con pipeline CI/CD, sistemi di monitoraggio o qualsiasi servizio in grado di inviare richieste HTTP.
Eventi di Sistema
Gli eventi di sistema sono segnali che svegliano un agente per l'elaborazione:
- Immediato, Elabora al prossimo heartbeat
- Prossimo heartbeat, Metti in coda per il prossimo check-in pianificato
Usa gli eventi di sistema per workflow reattivi, gli agenti si svegliano quando succede qualcosa invece che su una pianificazione fissa.
Heartbeat
L'heartbeat è un segnale periodico (predefinito ~15 secondi) che dà agli agenti l'opportunità di elaborare il lavoro in sospeso:
- Controlla i nuovi eventi di sistema
- Elabora i messaggi in coda
- Esegui le automazioni in sospeso
L'heartbeat può essere abilitato, disabilitato o configurato per agente.
Hook
Automazione guidata dagli eventi che attiva comandi shell o script in risposta agli eventi del Gateway:
- Al messaggio, Esegui quando viene ricevuto un messaggio
- Al turno dell'agente, Esegui prima o dopo che un agente elabora un messaggio
- All'evento del canale, Esegui su eventi specifici del canale (entrata, uscita, reazione)
Gli hook vengono eseguiti sull'host del Gateway e hanno accesso ai dati del contesto dell'evento.
Casi d'Uso
| Scenario | Soluzione |
|---|---|
| Briefing mattutino quotidiano | Cron job alle 7:00 → l'agente riassume gli aggiornamenti notturni |
| Generazione di report settimanale | Cron job ogni lunedì → l'agente genera e invia per email il report |
| Monitoraggio email | Webhook Gmail → l'agente elabora le email in arrivo |
| Notifiche di build | Webhook CI/CD → l'agente annuncia i risultati della build su Discord |
| Controllo dati orario | Cron basato su intervalli → l'agente controlla il dashboard e avvisa sulle anomalie |
| Post social pianificati | Cron job → l'agente redige e pubblica contenuti agli orari ottimali |