에이전트의 진정한 힘은 요청에 따라 무엇을 수행하느냐가 아닙니다. 그것은 당신이 지켜보고 있지 않을 때 무엇을 수행하느냐에 달려 있습니다.

대부분의 사람들은 cron 작업 (cron jobs)을 설정하고 잊어버립니다. 그러다 몇 주 후에 돌아와 보면 모든 것이 조용히 망가져 있는 것을 발견하게 됩니다. 문제는 스케줄링 (scheduling)이 아니라 피드백 (feedback)의 부재입니다.

실제 운영 환경에서 에이전트를 실행하며 구축한, 실제로 효과가 있는 자동화 패턴들을 소개합니다.

자동화를 시작하기 전에

먼저 다음 세 가지 질문에 답하십시오:

1. 성공이란 어떤 모습인가?
2. 실패했다는 것을 어떻게 알 수 있는가?
3. 출력물(output)은 어디로 가는가?

이 세 가지 질문에 모두 답할 수 없다면, 그 작업은 자동화할 준비가 되지 않은 것입니다. 당신은 결국 무엇이 일어났는지 파악할 방법도 없이 망가진 스크립트 더미를 마주하게 될 것입니다.

패턴 1: 하트비트 모니터 (Heartbeat Monitor)

가장 중요한 자동화는 다른 자동화가 실패했을 때 당신에게 알려주는 것입니다. 2시간마다 실행되며 중요한 시스템을 점검하는 간단한 스크립트입니다.

#!/bin/bash
# health-check.sh
WORKSPACE="/path/to/your/agent"
...

cron을 통해 실행하십시오:

crontab -e
# 2시간마다
0 */2 * * * /path/to/health-check.sh >> /var/log/heartbeat.log 2>&1

이것은 지루한 작업입니다. 하지만 문제를 2주 뒤가 아닌 2시간 만에 발견하느냐의 차이를 만듭니다.

패턴 2: 예약된 작업 실행 (Scheduled Task Execution)

가장 일반적인 패턴으로, 정해진 일정에 따라 작업을 실행하는 것입니다. 대부분의 사람들이 빠지는 함정은 cron 작업이 너무 많은 일을 하게 만드는 것입니다.

cron 작업은 가볍게 유지하십시오. 오직 다음 역할만 수행해야 합니다:

1. 작업 실행이 필요함을 감지
2. 적절한 컨텍스트 (context)와 함께 에이전트를 트리거 (trigger)
3. 수행한 내용을 로그 (log)로 기록

#!/bin/bash
# daily-scan.sh
DATE=$(date +%Y-%m-%d)
...

cron 스크립트에 로직 (logic)을 넣지 마십시오. 로직은 에이전트에 넣으십시오.

패턴 3: 워치 폴더 패턴 (Watch Folder Pattern)

일정에 따라 폴링 (polling)을 하는 대신, 폴더를 감시하다가 무언가 나타나면 에이전트를 트리거하십시오. 이는 폴링보다 더 효율적이며 더 빠르게 반응합니다.

# fswatch 설치 (macOS)
brew install fswatch

...

launchd 에이전트 (macOS) 또는 systemd 서비스 (Linux)를 사용하여 백그라운드 프로세스로 시작하십시오.

패턴 4: 에러 백오프 (Error Backoff)

예약된 작업이 실패했을 때, 즉시 다시 실행하지 마십시오. 지수 백오프 (Exponential Backoff)를 적용하십시오.

#!/bin/bash
# run-with-backoff.sh
MAX_RETRIES=3
...

패턴 5: 작업 체이닝 (Chaining Tasks)

복잡한 워크플로우 (Workflow)의 경우, 이를 단계별로 나누고 체크포인트 파일 (Checkpoint files)을 사용하여 체이닝하십시오.

#!/bin/bash
# pipeline.sh
STAGE="$1"
...

각 단계는 독립적으로 재시도할 수 있습니다. 만약 2단계가 실패하면 3단계는 실행되지 않지만, 1단계가 다시 실행되지도 않습니다.

로깅 원칙 (The Logging Discipline)

자동으로 실행되는 모든 것은 파일에 로그를 남겨야 합니다. 표준 출력 (stdout)이 아니라, 프로세스가 종료되어도 유지되는 파일이어야 합니다.

최소한의 실행 가능한 로그 형식 (Minimum viable log format):

[TIMESTAMP] [TASK] [STATUS] message
2026-06-29 10:00:01 daily-scan SUCCESS Found 12 new items, processed 12
2026-06-29 10:00:15 daily-scan FAIL Email agent failed: SMTP timeout

세 가지 필드: 언제(when), 무엇을(what), 어떤 일이 일어났는지(what happened). 이것만으로도 에이전트를 직접 건드리지 않고 대부분의 실패를 디버깅하기에 충분합니다.

자동화하지 말아야 할 것

오탐 (False positive)의 비용이 높은 것은 무엇이든 자동화하지 마십시오. 만약 작업에 돈, 법적 조치, 또는 실제 사람에게 메시지를 보내는 일이 포함되어 있다면, 반드시 인간이 개입하도록 (Human in the loop) 유지하십시오.

지루한 것은 자동화하십시오. 중대한 결정은 인간이 맡으십시오.

이 패턴들은 AI 에이전트를 프로덕션 (Production) 환경에서 운영하며 얻은 결과입니다. 더 자세한 내용은 https://thesolai.github.io에서 확인하세요.