스케줄로 자동 실행하기

스케줄을 걸어두면, 사용자가 앱을 켜지 않아도 에이전트가 정해진 시간에 알아서 깨어나 작업을 수행하고 결과를 가져다 둡니다. 매일 아침 시황 정리, 매시간 사이트 모니터링, “30분 뒤 다시 확인해줘” 같은 일회성 지연 실행 모두 같은 방식으로 등록할 수 있습니다.

무엇을 할 수 있나요?

시나리오	예시
매일 같은 시각에 실행	매일 아침 8시, 간밤의 뉴스 요약 보내기
평일·주말 구분	평일 오전 9시·오후 6시 두 번 시황 점검
매시간/매분 반복	1시간마다 재고 페이지를 확인하고, 변동이 있으면 알림
한 번만 지연 실행	”30분 뒤에 회의 자료 다시 정리해줘”
무거운 작업을 한가한 시간에	매주 일요일 새벽에 데이터 정리

스케줄을 통한 자동 실행은 에이전트가 일을 마치고 결과를 채팅에 남긴 뒤, 푸시 알림으로 도착을 알려주는 흐름입니다. 자리에 없을 때 일하고, 돌아왔을 때 결과만 확인하는 식입니다.

등록하는 두 가지 방법

1. 에이전트에게 자연어로 부탁하기

가장 쉬운 방법입니다. 채팅에서 그냥 말로 부탁하면 됩니다.

“매일 아침 8시에 어제 올라온 AI 뉴스 5개를 골라서 요약해 보내줘.”

“매시간 이 페이지 확인하고, 가격이 바뀌면 그때만 알려줘.”

“30분 뒤에 다시 한 번 점검해서 결과 정리해줘.”

에이전트는 요청을 이해하고 스스로 스케줄을 등록합니다. 채팅 화면에는 “스케줄 등록됨” 카드가 떠서 다음 실행 시각과 어떤 지시를 저장했는지 보여줍니다. 사용자는 그 카드를 보고 확인만 하면 됩니다.

에이전트가 직접 등록한 반복 스케줄은 한 에이전트당 최대 5개까지 동시에 활성화될 수 있습니다. 화면에서 사용자가 직접 추가하는 스케줄에는 이 한도가 적용되지 않습니다.

2. 화면에서 직접 추가하기

화면의 스케줄 메뉴(/agents/<에이전트>/schedules)에는 두 가지 설정이 있습니다.

스스로 움직이는 정도 (자율 빈도)

페이지 상단의 “스스로 움직이는 정도” 섹션에서 에이전트가 사용자 없이 얼마나 자주 스스로 할 일을 살피는지 고를 수 있습니다. 세 가지 선택지가 있고, 셋 모두 하루 24시간 동작하며 차이는 점검 주기뿐입니다.

선택지	점검 주기	언제 쓰면 좋나요?
게으름	4시간마다	가끔 배경 작업이 필요한 에이전트
보통	2시간마다	대부분의 경우에 적합한 기본값
부지런함	1시간마다	빠른 응대가 필요한 에이전트 (크레딧이 더 들어요)

원하는 선택지를 클릭하면 즉시 저장됩니다. 별도 저장 버튼을 누를 필요가 없습니다.

에이전트를 사용자가 부르거나 예약된 일이 있을 때만 동작하게 하고 싶다면, 이 섹션이 아니라 아래의 “스케줄 추가”로 특정 시각을 등록하면 됩니다.

추가 스케줄 (특정 시각 반복)

더 세밀하게 시각을 지정하고 싶을 때는 스케줄 추가 버튼을 누릅니다.

활성 시간대를 설정합니다.
- 요일(월~일)과 시작·종료 시각, 그리고 간격(30분·1시간·2시간 등)을 고릅니다.
- 예: 평일 09:00–18:00, 2시간 간격 → 하루에 최대 4–5회 실행.
- 시간대(타임존)는 계정 설정에 저장된 값이 자동으로 적용됩니다.
저장하면 목록에 새 스케줄이 나타나고, 다음 실행 예정 시각이 표시됩니다. 이 스케줄은 따로 지시문을 받지 않고 정해진 시각에 에이전트가 스스로 할 일을 판단합니다. 특정 지시문이 매번 실행되게 하려면 채팅에서 에이전트에게 반복 실행을 부탁하세요.

목록에서는 다음을 할 수 있습니다.

활성/비활성 토글 — 잠시 멈추고 싶을 때 비활성으로 두면 다음 자동 실행을 건너뜁니다.
편집 — 활성 시간대·요일·간격을 바꿉니다(지시문 입력은 없습니다).
삭제 — 더 이상 필요 없으면 제거합니다.
비활성 스케줄 숨기기/보기 — 보관용으로 비활성 스케줄이 쌓였을 때 화면을 깔끔히 유지.

iOS 앱에서도 같은 편집 화면을 통해 스케줄을 추가하고 관리할 수 있습니다.

정확한 시각(예: “매일 오전 8시 정각”)이나 일회성 지연 실행이 필요하다면 화면 대신 채팅에서 에이전트에게 직접 부탁하세요. 정밀한 반복 스케줄은 에이전트가 도구를 통해 등록합니다.

자동 실행 흐름

스케줄이 등록되면 다음 순서로 진행됩니다.


  [등록된 스케줄]
       │
       │ 정해진 시각이 되면
       ▼
   에이전트가 자동으로 깨어남
       │
       │ 도구를 선택해 작업 수행
       │ (웹 검색·페이지 가져오기·메모리 등 활성화된 도구만 사용)
       ▼
   결과를 채팅에 남김
       │
       │ ┌──────────────────────────┐
       └▶│  푸시 알림으로 도착      │
         │  채팅을 열면 결과 확인   │
         └──────────────────────────┘

작업 결과는 사용자에게 보낸 평소 메시지와 똑같이 채팅 히스토리에 남습니다. 어떤 스케줄이 깨운 실행인지, 그 시각에 어떤 지시를 받았는지가 메시지에 함께 표시되어 나중에 다시 봐도 맥락이 분명합니다.

결과는 어디서 확인하나요?

채팅 화면: 결과 메시지가 평소처럼 새 메시지로 들어옵니다. 메시지에는 “스케줄로 실행됨” 표시와 함께 스케줄 이름·지시문이 같이 보여, 사용자가 직접 보낸 메시지에 대한 답변과 헷갈리지 않습니다.
푸시 알림: 모바일 / 데스크톱 알림을 켜둔 경우, 결과가 도착했을 때 알림이 옵니다. 알림을 누르면 바로 해당 채팅으로 이동합니다.
스케줄 메뉴: 각 스케줄의 카드에서 마지막 실행 시각, 누적 실행 횟수, 다음 실행 시각을 확인할 수 있습니다.
실행 이력: 에이전트의 로그 메뉴(/agents/<에이전트>/logs)에서 스케줄 실행 기록(성공/실패·시각)을 확인할 수 있습니다. 현재 로그 메뉴는 목록에서 첫 번째 스케줄의 실행 이력을 표시합니다. 특정 스케줄의 이력을 자세히 보려면 스케줄 메뉴에서 해당 스케줄을 직접 열어보세요.

안전 가드

자동 실행은 사용자가 자리에 없을 때 크레딧을 쓰기 때문에 다음 안전 장치가 함께 동작합니다.

장치	동작
도구 승인	위험 도구(스킬 설치, 팀 에이전트 생성 등)는 `항상 묻기` 로 두면 자동 실행 중 호출되지 않고 사용자 확인을 기다립니다
크레딧 한도	사용자 크레딧이 소진되면 다음 자동 실행은 건너뜁니다
미확인 메시지 한도	채팅을 한참 열어보지 않아 미확인 메시지가 설정한 한도를 넘으면, 추가 자동 실행을 건너뜁니다. 채팅을 열어 메시지를 읽으면 한도가 초기화되어 다음 실행부터 다시 정상 동작합니다
연속 실패 알림	같은 스케줄이 연속해서 실패하면 푸시 알림으로 사용자에게 알려, 원인을 확인하도록 합니다
동시 실행 방지	동일 에이전트가 한 시점에 한 번만 실행되도록 시스템이 자동으로 보호하므로, 스케줄이 겹쳐도 안전합니다
활성 시간대	사용자가 “활성 시간”을 설정해두면, 그 바깥 시각으로 스케줄을 등록하려 할 때 에이전트가 도구 에러를 받습니다. 에이전트는 이를 보고 직접 사용자에게 확인을 요청하거나, 사용자가 명시적으로 그 시각을 요청한 것이 분명하다면 그대로 진행할 수 있습니다

자동 실행은 사용자가 미리 켜둔 도구만 사용하고, 항상 묻기로 표시된 위험 도구는 자동으로 호출되지 않습니다. 즉 자리를 비운 동안에도 “사용자가 미리 허락한 범위” 안에서만 일이 진행됩니다.

자주 쓰는 패턴

매일 아침 브리핑

매일 정해진 시각에 뉴스/주가/이메일을 요약해 채팅으로 받기. 일어나서 채팅만 열어보면 끝.

모니터링 + 변화 시에만 알림

“매시간 이 페이지를 확인하고 가격이 바뀌면 그때만 알림”처럼 변화 감지형. 평소엔 조용하다가 필요할 때만 알림이 옵니다.

주기적 정리 작업

주말 새벽에 무거운 데이터 가공·요약을 돌려두기. 평일에 영향이 없도록 한가한 시간을 선택.

일회성 지연 실행

“한 시간 뒤에 다시 검토해서 결과만 보내줘” 같은 단발성 작업. 한 번 실행되면 스케줄이 스스로 비활성화되어 다시 발동하지 않고, 따로 정리할 필요도 없습니다.

다음 단계

도구 부여하기 — 자동 실행 중에 에이전트가 쓸 도구를 미리 켜두기
스킬과 자율 스킬 시스템 — 반복 작업을 스킬로 묶어 더 안정적으로 자동화
에이전트 공유 (스냅샷) — 외부 사용자가 쓰는 공유 링크와의 차이

고급 (Advanced)

아래 내용은 일반 사용 시 알 필요가 없습니다. 정밀하게 시각을 잡거나 동작을 조정하고 싶을 때만 참고하세요.

스케줄 종류

종류	등록 방법	설명
하트비트	화면(스케줄 추가)	요일·시간대·간격 기반. 활성 구간 안에서 일정 주기로 깨어남
반복(cron)	에이전트 `schedule_create` 도구만	UTC 기준 cron 표현식. 매일/매주/매시간 등 정밀 시각 지정
일회성(once)	에이전트 `schedule_create` 도구만	N분 뒤 한 번만 실행 후 자동 비활성화 (최소 1분, 최대 7일)

화면의 “스케줄 추가”는 하트비트 프로파일 전용입니다. 정확한 시각의 반복 스케줄이나 일회성 지연 실행은 채팅에서 에이전트에게 직접 부탁하면 에이전트가 도구를 통해 등록합니다.

일회성 vs 반복 실행

일회성 실행은 한 번 동작한 뒤 스스로 비활성화됩니다. 반복 실행(cron)은 별도 종료 처리를 하지 않는 한 계속 동작하며, 에이전트가 직접 등록한 반복 스케줄은 기본 7일(최대 90일까지 지정 가능) 후 자동으로 비활성화되어 잊혀진 스케줄이 끝없이 돌아가는 것을 막습니다.

시각 지정 (cron 표현식)

에이전트에게 자연어로 부탁하면 내부적으로는 표준 cron 표기를 사용합니다. 시각은 모두 UTC 기준으로 저장되며, 사용자의 시간대로 변환되어 표시됩니다.

표현식	의미
`0 8 * * *`	매일 08:00 UTC (= 한국 기준 오후 17:00 KST)
`0 23 * * *`	매일 23:00 UTC (= 다음날 오전 08:00 KST — 한국 아침 브리핑에 사용)
`0 * * * *`	매시 정각
`0 9 * * 1-5`	평일 오전 9시
`0 0 * * 0`	매주 일요일 자정

“한국 아침 8시에 실행해줘”처럼 부탁하면 에이전트가 시간대 변환을 알아서 처리합니다.

동시 실행 보호 동작

동일한 에이전트는 한 시점에 하나의 실행 라인만 활성화됩니다.

스케줄 시각이 겹치거나, 이전 실행이 길어져 다음 실행 시각을 넘긴 경우에도 한 번만 실행됩니다.
이전 실행이 진행 중일 때 다음 시각이 도래하면, 다음 실행은 건너뛰거나 큐잉되어 폭주가 발생하지 않습니다.
서버가 여러 대로 운영되어 같은 스케줄이 동시에 트리거되더라도 시스템 차원에서 중복 실행이 차단됩니다.
시스템이 잠시 중단됐다가 복구된 경우, 밀린 스케줄이 정상 시각으로 자동 보정된 뒤 다시 동작합니다.

이 덕분에 “겹쳐서 두 번 실행되거나, 한 시간 동안 같은 일을 60번 반복하는” 사고는 발생하지 않습니다.

여러 에이전트가 동일한 cron 시각(예: 0 * * * *)을 공유하면 동시 발동으로 부하가 몰릴 수 있어, 에이전트가 등록한 반복(cron) 스케줄에는 시스템이 자동으로 최대 180초 범위의 무작위 지연을 더해 실행 시작 시점을 분산시킵니다. 별도 설정은 필요 없으며, 일회성 지연 실행에는 적용되지 않습니다.

한도와 보존 정책

항목	값
에이전트가 스스로 만들 수 있는 활성 반복 스케줄	최대 5개
일회성 지연 범위	1분 ~ 7일
반복 스케줄 자동 비활성화 (에이전트 등록 시 기본)	7일 (1~90일 사이 지정 가능)
연속 실패 시 알림 임계치 (기본)	3회 연속 실패 (0으로 설정하면 실패 알림을 끕니다)
실행 이력 보존	약 90일 (오래된 실행 기록은 자동 정리)

화면에서 사용자가 직접 만든 스케줄에는 활성 개수 한도가 적용되지 않으며, 자동 비활성화 만료도 사용자가 별도로 설정하지 않으면 유지됩니다.