💓 O que é o heartbeat
Heartbeat é um cron job (tarefa periódica) que mantém o agente acordado o tempo todo, em vez de só reagir quando você fala. É literalmente um batimento: a cada intervalo, algo "pulsa" e verifica se há trabalho a fazer. É o que transforma um chatbot reativo num agente que opera sozinho.
Diagrama ilustrativo · o batimento que nunca para
🧟 Zombie detection
Um "zombie process" é silencioso até algo morrer — uma tarefa que travou mas não avisa. O heartbeat resolve isso com um sub-agente que faz ping a cada poucos segundos. Se um processo parou de responder, ele é detectado, reciclado e a tarefa é tentada de novo, inclusive recuperando alucinações.
🔧 O que o ping faz
- Zombie detection — acha processos travados que ficariam parados para sempre.
- Fresh agent reclaim — substitui o agente morto por um novo, com contexto limpo.
- Retries com recuperação — tenta de novo e corrige rumos quando o agente alucinou.
💡 Dica prática
É essa malha de detecção que torna seguro deixar o agente rodando sem você olhando. Sem ela, uma única tarefa travada paralisaria a operação inteira.
⏰ Cron / scheduled task
Além de manter vivo, o heartbeat permite agendar ações num intervalo. O exemplo mínimo do material: "me lembre em 30 segundos que o céu é azul". O Hermes guarda a tarefa e dispara sozinho quando o tempo chega — você nem precisa estar com o app aberto.
Exemplos de agendamento (ilustrativo)
🌅 O briefing matinal das 8h
O caso de uso que faz a feature brilhar: todo dia às 8h, o Hermes varre email + calendário + tudo que sabe de você (memória) e entrega 5 itens relevantes. Não é uma lista crua — é curadoria. Cron + memória + integrações viram um assistente proativo.
Dispara às 8h
O cron acorda a tarefa sem você pedir.
Varre as fontes
Email, calendário e a memória do que importa para você.
Entrega 5 itens curados
Só o que merece sua atenção — não a caixa de entrada inteira.
🌟 Faz parecer vivo
Com heartbeat, a relação se inverte: o agente vem até você. Você pode pedir "periodicamente me pergunte coisas, faça check-in" e ele aparece de tempos em tempos com perguntas e sugestões. Deixa de ser uma ferramenta que espera e vira um parceiro com iniciativa.
✗ Chatbot reativo
- ✗Só existe quando você abre.
- ✗Nunca toma iniciativa.
- ✗Esquece de você entre sessões.
✓ Agente com heartbeat
- ✓Acordado 24/7.
- ✓Faz check-in proativo.
- ✓Vem com sugestões na hora certa.
⚠️ Cuidados com agendamentos
Heartbeat e crons são poderosos, mas cada disparo consome tokens. Agendamentos demais geram custo silencioso e uma enxurrada de notificações. Isso conecta direto com o próximo módulo (3.5, Budget): um cron esquecido pode queimar dinheiro enquanto você dorme.
🚨 Atenção
Revise periodicamente os crons ativos. Um agendamento que pulsa de minuto em minuto, multiplicado pelos ~73% de overhead fixo de cada request, vira uma fatura desagradável.
Mantém vivo 24/7.
Recupera travados.
Dispara por tempo.
Frequência sob medida.
🧰 Casos de uso de heartbeat
Para fixar, alguns padrões reais onde o batimento brilha — todos combinando cron, memória e integrações que você já viu nas trilhas anteriores.
8h: 5 itens de email + calendário.
Sexta 17h: o que aconteceu na semana.
"Me lembre em 30s / amanhã / toda 2ª."
Checa repositório e avisa novidades.
"Periodicamente me pergunte coisas."
Snapshot diário do OS no GitHub.
💡 Dica prática
Comece com um cron simples (o briefing das 8h) e observe por uma semana antes de adicionar mais. Assim você sente o custo e o valor antes de encher a agenda do agente.
📌 Resumo do Módulo
Próximo Módulo:
3.5 - 💰 Budget & Tokens: por que 73% de cada request é overhead fixo e como cortar a conta.