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:<jobId>) 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:
- Configure un tema y suscripcion de GCP Pub/Sub
- Configure el filtrado de etiquetas de Gmail
- Apunte la entrega push a su URL de webhook
- 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 |