💓 Qué es el heartbeat
Heartbeat es un cron job (tarea periódica) que mantiene al agente despierto todo el tiempo, en vez de solo reaccionar cuando hablas. Es literalmente un latido: a cada intervalo, algo "pulsa" y verifica si hay trabajo por hacer. Es lo que transforma un chatbot reactivo en un agente que opera solo.
Diagrama ilustrativo · el latido que nunca se detiene
🧟 Zombie detection
Un "zombie process" pasa inadvertido hasta que algo muere: una tarea que se bloqueó pero no avisa. El heartbeat lo resuelve con un subagente que hace ping cada pocos segundos. Si un proceso dejó de responder, se detecta, se reinicia y se vuelve a intentar la tarea, incluso recuperándose de alucinaciones.
🔧 Qué hace el ping
- Detección de procesos zombie — encuentra procesos bloqueados que se quedarían detenidos para siempre.
- Fresh agent reclaim — reemplaza al agente que dejó de funcionar por uno nuevo, con el contexto limpio.
- Reintentos con recuperación — vuelve a intentarlo y corrige el rumbo cuando el agente alucinó.
💡 Consejo práctico
Es esta red de detección la que hace seguro dejar al agente funcionando sin que estés pendiente. Sin ella, una sola tarea bloqueada paralizaría toda la operación.
⏰ Cron / scheduled task
Además de mantenerlo activo, el heartbeat permite programar acciones en un intervalo. El ejemplo mínimo del material: «recuérdame en 30 segundos que el cielo es azul». Hermes guarda la tarea y la ejecuta automáticamente cuando llega el momento; ni siquiera necesitas tener la aplicación abierta.
Ejemplos de programación (ilustrativos)
🌅 El resumen matutino de las 8h
El caso de uso que hace brillar la función: todos los días a las 8h, Hermes revisa email + calendario + todo lo que sabe de ti (memoria) y entrega 5 elementos relevantes. No es una lista sin filtrar: es curaduría. Cron + memoria + integraciones se convierten en un asistente proactivo.
Se activa a las 8h
El cron activa la tarea sin que tengas que pedirlo.
Explora las fuentes
Email, calendario y la memoria de lo que te importa.
Entrega 5 elementos seleccionados
Solo lo que merece tu atención — no toda la bandeja de entrada.
🌟 Hace que parezca vivo
Con heartbeat, la relación se invierte: el agente viene hasta ti. Puedes pedirle «pregúntame cosas periódicamente, haz un check-in» y aparece de vez en cuando con preguntas y sugerencias. Deja de ser una herramienta que espera y se convierte en un socio con iniciativa.
✗ Chatbot reactivo
- ✗Solo existe cuando la abres.
- ✗Nunca toma la iniciativa.
- ✗Se olvida de ti entre sesiones.
✓ Agente con heartbeat
- ✓Activo 24/7.
- ✓Hace un check-in proactivo.
- ✓Viene con sugerencias en el momento justo.
⚠️ Precauciones con las programaciones
Heartbeat y los crons son poderosos, pero cada activación consume tokens. Demasiadas tareas programadas generan costos silenciosos y una avalancha de notificaciones. Esto se conecta directamente con el siguiente módulo (3.5, Budget): un cron olvidado puede gastar dinero mientras duermes.
🚨 Atención
Revisa periódicamente los cron activos. Una tarea programada que se ejecuta cada minuto, multiplicada por el ~73% de sobrecarga fija de cada request, se convierte en una factura desagradable.
Se mantiene activo 24/7.
Recupera tareas bloqueadas.
Se activa por tiempo.
Frecuencia a medida.
🧰 Casos de uso de heartbeat
Para fijar la idea, algunos patrones reales en los que el pulso brilla: todos combinan cron, memoria e integraciones que ya viste en las rutas anteriores.
8h: 5 elementos de correo electrónico + calendario.
Viernes a las 17 h: lo que pasó durante la semana.
"Recuérdamelo en 30s / mañana / cada 2.º lunes."
Revisa el repositorio y te avisa de las novedades.
"Pregúntame cosas periódicamente."
Snapshot diario del OS en GitHub.
💡 Consejo práctico
Empieza con uno cron simple (el briefing de las 8h) y obsérvalo durante una semana antes de añadir más. Así percibes el costo y el valor antes de llenar la agenda del agente.
📌 Resumen del módulo
Próximo módulo:
3.5 - 💰 Budget & Tokens: por qué el 73% de cada solicitud es sobrecarga fija y cómo reducir el costo.