# 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:`) 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: 1. Configura un topic e una sottoscrizione GCP Pub/Sub 2. Configura il filtro delle etichette Gmail 3. Punta la consegna push al tuo URL webhook 4. 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 |