에이전트 스케줄링
에이전트 작업을 예약하고 자동으로 반복 실행하는 방법
에이전트 스케줄링은 정해진 시간에 에이전트 세션을 자동으로 시작하는 기능입니다. 반복적인 코드 리뷰, 보안 점검, 데이터 수집 등의 작업을 자동화할 수 있습니다.
개요
스케줄링을 사용하면 Cron 표현식으로 에이전트 실행 시점을 정의하고, 지정된 프롬프트로 세션을 자동 시작할 수 있습니다. Daemon 서버가 실행 중인 동안 스케줄이 자동으로 트리거됩니다.
스케줄 생성
에이전트 선택
스케줄을 등록할 에이전트를 선택합니다. 에이전트 설정 페이지 또는 스케줄 관리 화면에서 접근할 수 있습니다.
프롬프트 작성
에이전트가 실행할 작업 지시사항을 입력합니다. 명확하고 구체적인 프롬프트가 안정적인 결과를 만듭니다.
실행 주기 설정
매시간 / 매일 / 매주 프리셋을 고르거나 분 단위 간격(intervalMinutes)을 직접 입력합니다.
모바일 화면에는 Cron 입력이 없습니다 — Cron 표현식은 아래 MCP 경로에서만 씁니다.
스케줄 저장
저장하면 Daemon 서버에 스케줄이 등록되고, 지정된 시간에 자동으로 세션이 시작됩니다.
Cron 표현식 (MCP 경로)
에이전트가 angski-schedule MCP 도구로 스케줄을 만들 때는 Cron 표현식을 받습니다. 모바일 UI는
간격 프리셋만 제공합니다.
| 표현식 | 의미 |
|---|---|
0 9 * * 1-5 | 평일 오전 9시 |
0 0 * * * | 매일 자정 |
0 */6 * * * | 6시간마다 |
30 8 * * 1 | 매주 월요일 오전 8시 30분 |
0 18 1 * * | 매월 1일 오후 6시 |
0 9,18 * * * | 매일 오전 9시와 오후 6시 |
Cron 팁
Cron 표현식은 5개 필드로 구성됩니다: 분 시 일 월 요일.
시간대는 Daemon 서버의 로컬 시간을 기준으로 합니다.
실행 기록 모니터링
스케줄에 의해 실행된 세션은 에이전트의 세션 목록에 자동으로 표시됩니다.
확인 가능한 정보
| 항목 | 설명 |
|---|---|
| 실행 시각 | 스케줄이 트리거된 정확한 시간 |
| 세션 상태 | 실행 중, 완료, 오류 등 |
| 세션 링크 | 클릭하여 세션 상세로 이동 |
| 실행 로그 | 에이전트의 작업 로그 확인 |
활용 사례
- 일일 코드 리뷰: 매일 오전 최신 커밋을 리뷰하는 에이전트 실행
- 보안 스캔: 주기적으로 의존성 취약점을 점검
- 데이터 수집: 웹 스킬과 연계하여 정기 데이터 수집
- 테스트 실행: CI/CD 보완으로 주기적 통합 테스트
제한 사항
- Daemon 서버가 꺼져 있으면 스케줄이 실행되지 않습니다
- 놓친 실행은 기본 정책(
missedRunPolicy: run_once)에서 Daemon이 다시 켜질 때 한 번 소급 실행됩니다.skip으로 두면 유예 시간이 지난 실행은 건너뛰고 다음 시각으로 넘어갑니다 - 동시에 너무 많은 스케줄이 실행되면 Daemon 리소스에 영향을 줄 수 있으므로 간격을 충분히 두세요
스케줄 관리
등록된 스케줄은 에이전트 설정에서 관리할 수 있습니다.
- 활성화/비활성화: 스케줄을 일시적으로 끄거나 켤 수 있습니다
- 수정: 프롬프트, Cron 표현식, 옵션을 변경할 수 있습니다
- 삭제: 더 이상 필요 없는 스케줄을 제거합니다