# Automatizacion y Programacion ## Trabajos Cron Programe activaciones de agentes con sincronizacion precisa. Los trabajos cron persisten entre reinicios del Gateway y soportan patrones de programacion flexibles. ### Tipos de Programacion | Tipo | Descripcion | Ejemplo | |------|-------------|---------| | **Expresion cron** | Sintaxis cron estandar con zona horaria | `0 7 * * *` (diariamente a las 7 AM) | | **Intervalo** | Repetir a intervalos fijos | `30m`, `2h`, `1d` | | **Unico** | Ejecutar una vez en un momento especifico | `2026-03-15T16:00:00Z` | ### Objetivos de Sesion - **Sesion principal** -- Encolar como un evento del sistema en la conversacion principal del agente - **Sesion aislada** -- Ejecutar en una sesion dedicada (`cron:`) para evitar contaminar las conversaciones principales ### Modos de Entrega | Modo | Descripcion | |------|-------------| | **None** | Ejecucion silenciosa (sin salida publicada) | | **Announce** | Publicar el resultado de vuelta a un canal especifico | | **Webhook** | HTTP POST del resultado a una URL externa | ### Recordatorios Unicos Establezca un recordatorio para un momento especifico. El agente se activa, procesa el recordatorio y opcionalmente elimina el trabajo despues de ejecutarse. ### Trabajos Recurrentes Programe tareas repetitivas con expresiones cron y soporte de zona horaria. Los trabajos rastrean su historial de ejecucion (exito, fallo, tiempos). --- ## Webhooks Reciba eventos de servicios externos y enrutelos a agentes. ### Gmail Pub/Sub Integrese con el sistema de notificaciones push de Gmail para activar acciones del agente cuando llegan emails: 1. Configure un tema y suscripcion de GCP Pub/Sub 2. Configure el filtrado de etiquetas de Gmail 3. Apunte la entrega push a su URL de webhook 4. Neotask recibe mensajes y encola eventos del agente ### Webhooks Personalizados Registre endpoints HTTP que activan turnos del agente cuando se les llama. Util para integrarse con pipelines de CI/CD, sistemas de monitoreo o cualquier servicio que pueda enviar solicitudes HTTP. --- ## Eventos del Sistema Los eventos del sistema son senales que activan un agente para procesamiento: - **Inmediato** -- Procesar en el proximo latido - **Proximo latido** -- Encolar para la proxima verificacion programada Use eventos del sistema para flujos de trabajo reactivos -- los agentes se activan cuando algo sucede en lugar de en un horario fijo. --- ## Latido (Heartbeat) El latido es una senal periodica (por defecto ~15 segundos) que da a los agentes la oportunidad de procesar trabajo pendiente: - Verificar nuevos eventos del sistema - Procesar mensajes en cola - Ejecutar automatizaciones pendientes El latido puede habilitarse, deshabilitarse o configurarse por agente. --- ## Hooks Automatizacion impulsada por eventos que activa comandos shell o scripts en respuesta a eventos del Gateway: - **On message** -- Ejecutar cuando se recibe un mensaje - **On agent turn** -- Ejecutar antes o despues de que un agente procese un mensaje - **On channel event** -- Ejecutar en eventos especificos del canal (unirse, salir, reaccion) Los hooks se ejecutan en el host del Gateway y tienen acceso a datos de contexto del evento. --- ## Casos de Uso | Escenario | Solucion | |----------|----------| | Resumen matutino diario | Trabajo cron a las 7 AM -> el agente resume las actualizaciones nocturnas | | Generacion de reportes semanales | Trabajo cron cada lunes -> el agente genera y envia por email el reporte | | Monitoreo de email | Webhook de Gmail -> el agente procesa emails entrantes | | Notificaciones de build | Webhook de CI/CD -> el agente anuncia resultados de build en Discord | | Verificacion de datos por hora | Cron basado en intervalos -> el agente verifica el dashboard y alerta sobre anomalias | | Publicaciones sociales programadas | Trabajo cron -> el agente redacta y publica contenido en momentos optimos |