Heartbeat di Sessione — Le Attività Lunghe Restano Attive
Heartbeat di Sessione — Le Attività Lunghe Restano Attive — guida facile da comprendere basata sulla documentazione ufficiale
Immagina di lavorare con un assistente diligente che non ti aleggia sulle spalle, ma ogni tanto, con discrezione, dà un’occhiata a ciò che gli hai chiesto di sorvegliare — e interviene solo quando qualcosa cambia davvero. Questa è la realtà quotidiana di /heartbeat: permette all’IA di “ricontrollare” automaticamente un’attività secondo una pianificazione, tutto all’interno della stessa conversazione.
Cos’è?
/heartbeat imposta un promemoria ricorrente per la tua sessione corrente. Quando la conversazione è inattiva e il tempo è scaduto, l’IA invia un messaggio a se stessa — proprio come farebbe un utente normale. Il dettaglio chiave: non interrompe mai un’attività in corso. Si inserisce solo durante una “pausa”, usando un normale messaggio utente, e non modifica alcuna impostazione di sistema.
In Cosa è Diverso da Cron?
/heartbeat |
hermes cron |
|
|---|---|---|
| Contesto | Conversazione corrente — memoria e contesto completi | Sessione nuova e isolata ogni volta |
| Dopo il riavvio | Stato salvato nel DB, riprende in seguito | Completamente persistente |
| Quantità | Uno per sessione | Illimitati |
| Ideale per | “Tieni d’occhio questo argomento” | Attività autonome, report programmati |
Regola pratica veloce: se il promemoria dipende dalla storia della conversazione, usa /heartbeat. Se l’attività è completamente indipendente, usa cron.
Comandi Principali
# Imposta un heartbeat (controlla il deployment ogni 10 minuti)
/heartbeat every 10m Check the deployment and report meaningful changes
# Visualizza lo stato attuale
/heartbeat status
# Metti in pausa (senza eliminare)
/heartbeat pause
# Riprendi (il timer riparte, non scatterà immediatamente)
/heartbeat resume
# Rimuovi completamente
/heartbeat clear
/hb è un alias comodo. Intervalli supportati: 90s, 10m, 2h, 1d (minimo 60 secondi).
Piccoli Dettagli Curati
- Scatta solo quando sei inattivo — se l’IA è occupata, l’heartbeat aspetta pazientemente. Niente salti in coda.
- Nessun arretrato — se passano diversi cicli senza un trigger, viene inviato solo un messaggio. Niente accumuli.
- I messaggi utente hanno la priorità — i tuoi messaggi superano sempre un heartbeat.
- Niente lavoro inutile — i messaggi heartbeat contengono un’istruzione integrata: “se non è cambiato nulla, rispondi brevemente.” Nessun bisogno di fingere attività.
Un Esempio Reale
Tu: /heartbeat every 15m Check whether the CI run for PR #1234 finished; summarize the result when it does
♥ Heartbeat impostato (ogni 15m): controlla CI per PR #1234; riepiloga quando finito
[15 minuti dopo, sei occupato con altro]
Hermes: [heartbeat attivato]
💻 gh pr checks 1234 (1.2s)
CI superato ✅ Tutti i test verdi
Riepilogo e Consigli Pratici
/heartbeat è come una sveglia intelligente per la tua conversazione — ricorda il contesto, rispetta il tuo ritmo e ti sollecita solo quando conta davvero. Caso d’uso migliore: scenari “sorveglia mentre lavoro” — aspettare un deployment, monitorare anomalie nei log o seguire gli sviluppi di una discussione. Ricorda solo: se un’attività è completamente indipendente dalla chat corrente, cron è la scelta più sicura. Ma se si tratta di “rimanere sintonizzati su questo argomento”, l’heartbeat è il tuo partner perfetto.
📖 Documentazione ufficiale
この記事は Hermes Agent のDocumentazione ufficialeに基づいています:Documentazione ufficiale › user-guide/features/heartbeat