AI 에이전트

하트비트Heartbeat

하트비트 (Heartbeat)는 심장 박동 같은 것 — AI 에이전트 (Agent)가 '나 아직 살아있어요'라고 일정 간격으로 보내는 신호로, 에이전트가 멈추거나 죽었는지 시스템이 알아채는 방법이다.

사람도 맥박이 멈추면 의식을 잃은 걸 알 수 있듯, 소프트웨어 세계에서도 프로그램이 정상 작동 중인지 확인하는 방법이 필요하다. 하트비트 (Heartbeat)는 에이전트 (Agent)나 서버 (Server)가 정해진 시간 간격(예: 30초마다)으로 '나 정상이에요'라는 신호를 게이트웨이 (Gateway)나 관리 시스템에 보내는 동작이다. 신호가 일정 횟수 이상 오지 않으면 시스템은 해당 에이전트가 멈춘 것으로 판단하고 재시작하거나 알림을 보낸다.

1인 비즈니스(1인 사이트 운영)에서 하트비트는 백그라운드에서 조용히 일하는 자동화 에이전트를 관리할 때 핵심 역할을 한다. 예를 들어 OpenClaw 의 게이트웨이 (Gateway)가 하트비트를 통해 연결된 에이전트들의 생존 여부를 모니터링하고, 채널 (Channel, Discord·Slack·Telegram 등)로 메시지가 왔는데 에이전트가 응답하지 않는다면 하트비트 신호 부재를 통해 문제를 감지할 수 있다. 혼자 운영하는 사이트에서 에이전트가 몰래 죽어 있어도 알아채지 못한다면 큰 문제가 생길 수 있기 때문에, 하트비트는 에이전트 신뢰성의 보험 같은 장치다.

초보자가 흔히 혼동하는 점은 하트비트를 '에이전트가 실제로 일하는 신호'로 착각하는 것이다. 하트비트는 '살아있음'을 알리는 신호일 뿐, 작업을 열심히 하고 있다는 의미가 아니다. 에이전트가 멈추지 않고 대기 중인 상태도 정상 하트비트로 표시된다. 실제 작업 결과는 별도의 로그 (Log)나 응답으로 확인해야 한다.

💡 대표 예시

  • OpenClaw 게이트웨이 (Gateway)가 30초마다 에이전트 (Agent)의 하트비트를 확인해 연결이 끊기면 자동 재시작
  • 뉴스레터 발송 자동화 에이전트가 하트비트를 보내지 않자 운영자에게 Slack 채널 (Channel)로 '에이전트 비정상' 알림 발송
  • SaaS 사이트의 백그라운드 크론 (Cron) 작업 에이전트가 하트비트 미전송 시 관리 대시보드에 경고 표시
  • 커뮤니티 사이트의 스팸 감지 에이전트가 하트비트 중단 → 웹훅 (Webhook)으로 운영자 이메일에 장애 알림
  • 멤버십 사이트에서 결제 상태를 주기적으로 점검하는 에이전트의 하트비트가 끊기자 세션 (Session)이 자동 초기화됨
  • 포트폴리오 사이트 문의 자동 응답 에이전트가 하트비트 기반으로 생존 여부를 게이트웨이에 보고하고 죽으면 샌드박스 (Sandbox)에서 재구동

🔗 관련 용어

에이전트

에이전트 (Agent)는 나 대신 심부름을 해주는 AI 직원 같은 것 — 내가 '블로그 글 올려줘'라고 말하면 브라우저를 열고, 글을 작성하고, 발행까지 스스로 처리한다.

크론

크론 (Cron)은 자명종 시계 같은 것 — 내가 없어도 정해진 시간에 정해진 일을 자동으로 해주는 예약 실행 장치로, AI 에이전트가 '매일 오전 9시에 이것을 해라'처럼 스케줄대로 움직이게 만든다.

게이트웨이

게이트웨이 (Gateway)는 내 기기 안의 우체국 같은 것 — 슬랙·텔레그램·디스코드 등 어느 채널로 메시지가 와도 게이트웨이가 한 곳에서 받아서 에이전트 (Agent)에게 넘기고, 답장도 같은 길로 돌려보낸다.

샌드박스

샌드박스 (Sandbox)는 아이들 모래 놀이터 같은 것 — 모래를 아무리 흩뿌려도 놀이터 밖은 더럽혀지지 않듯, 에이전트 (Agent)가 실험적으로 코드를 실행해도 내 컴퓨터 실제 환경에는 전혀 영향을 주지 않는 격리된 공간이다.

세션

세션 (Session)은 대화방의 '문이 열려 있는 동안' 같은 것 — 에이전트 (Agent)가 사용자를 기억하고 맥락을 유지하는 시간 단위로, 문이 닫히면 그 안의 흐름도 끝난다.

툴 (Tool)은 에이전트 (Agent)의 손 같은 것 — 머리(AI)만 있으면 생각만 하지만, 손(툴)이 생겨야 브라우저를 열고, 파일을 만들고, 예약 작업을 실행하는 등 실제로 무언가를 할 수 있다.

이 개념, 직접 적용해볼까요?

AI 에이전트를 직접 만들고 24시간 운영하는 법을 단계별 강의로 배워보세요.