세션 하트비트 — 장기 작업 유지
세션 하트비트 — 장기 작업 유지 — 공식 문서 기반 이해하기 쉬운 가이드
세션 하트비트 — 오래 걸리는 작업은 계속 살아있게
여러분이 부지런한 어시스턴트와 함께 일한다고 상상해 보세요. 어깨 너머로 계속 지켜보진 않지만, 가끔씩 조용히 맡겨둔 일을 확인하고, 실제로 변화가 생겼을 때만 말을 거는 그런 조수 말이에요. 그게 바로 /heartbeat의 일상적인 모습입니다. AI가 같은 대화 안에서 일정에 따라 작업을 자동으로 “다시 확인”할 수 있게 해주는 기능이죠.
이게 뭔가요?
/heartbeat는 현재 세션에 반복 알림을 설정합니다. 대화가 한가하고 시간이 되면, AI가 일반 사용자처럼 자기 자신에게 메시지를 보냅니다. 핵심적인 디테일: 진행 중인 작업을 절대 방해하지 않습니다. 오직 “숨 고르는” 틈에만 일반 사용자 메시지 형태로 끼어들며, 시스템 설정을 변경하지도 않습니다.
크론(Cron)과 뭐가 다르죠?
/heartbeat |
hermes cron |
|
|---|---|---|
| 맥락 | 현재 대화 — 전체 기억 & 맥락 공유 | 매번 새롭고 독립된 세션 |
| 재시작 후 | 상태가 DB에 저장되어 나중에 이어짐 | 완전히 영구적 |
| 개수 | 세션당 하나 | 무제한 |
| 최적의 용도 | “이 주제를 계속 주시” | 독립적인 작업, 예약 보고서 |
빠른 판단 기준: 알림이 대화의 앞선 맥락에 의존한다면 /heartbeat를 사용하세요. 작업이 완전히 독립적이라면 크론을 사용하세요.
핵심 명령어
# 하트비트 설정 (10분마다 배포 상태 확인)
/heartbeat every 10m Check the deployment and report meaningful changes
# 현재 상태 확인
/heartbeat status
# 일시 중지 (삭제는 아님)
/heartbeat pause
# 재개 (타이머가 다시 시작되며, 즉시 실행되지는 않음)
/heartbeat resume
# 완전히 제거
/heartbeat clear
/hb는 편리한 별칭입니다. 지원되는 간격: 90s, 10m, 2h, 1d (최소 60초).
세심한 작은 디테일들
- 한가할 때만 실행 — AI가 바쁘면 하트비트는 인내심 있게 기다립니다. 새치기 없음.
- 밀리지 않음 — 여러 주기가 지나도 실행되지 않았다면, 단 하나의 메시지만 보냅니다. 쌓이지 않아요.
- 사용자 메시지가 최우선 — 여러분의 메시지는 항상 하트비트보다 우선합니다.
- 불필요한 작업 없음 — 하트비트 메시지에는 “변화가 없으면 짧게 답하라”는 내장 지침이 포함되어 있습니다. 가짜 활동을 만들 필요가 없어요.
실제 예시
You: /heartbeat every 15m Check whether the CI run for PR #1234 finished; summarize the result when it does
♥ 하트비트 설정됨 (15분마다): PR #1234의 CI 확인; 완료되면 요약
[15분 후, 다른 일로 바쁜 당신]
Hermes: [하트비트 트리거됨]
💻 gh pr checks 1234 (1.2s)
CI 통과 ✅ 모든 테스트 성공
요약 및 실용적인 조언
/heartbeat는 대화를 위한 똑똑한 알람시계와 같습니다. 맥락을 기억하고, 여러분의 리듬을 존중하며, 중요한 순간에만 살짝 알려줍니다. 최적의 사용 사례: “내가 작업하는 동안 지켜봐 줘” 시나리오 — 배포 대기, 로그 이상 징후 모니터링, 토론 후속 조치 추적 등이죠. 기억하세요: 작업이 현재 채팅과 완전히 독립적이라면 크론이 더 안전한 선택입니다. 하지만 “이 주제에 계속 귀 기울이는 것”이라면, 하트비트가 완벽한 파트너가 되어 줄 겁니다.
📖 공식 문서
この記事は Hermes Agent の공식 문서に基づいています:공식 문서 › user-guide/features/heartbeat