- 예약 작업: 프로젝트에 속한 지시입니다. 정해진 시각에 에이전트가 해당 프로젝트의 클라우드 서버에서 실행하며, 실행할 때마다 세션을 하나 만듭니다(또는 같은 세션에서 이어 갑니다). Scheduled 보드에서 만들거나, 에이전트가 세션에서 초안을 만들고 사용자가 확인하면 적용됩니다.
- 세션 타이머: 세션에 연결된 타이머입니다. 정해진 시각에 해당 세션으로 트리거 메시지를 보내고, 에이전트가 작업을 이어 갑니다. 에이전트가 세션에서 직접 만들 수 있으며(확인 불필요), 사용자도 세션 상단 바의 타이머 패널에서 만들 수 있습니다. 반복 세션 타이머는 7일 후 만료되며 갱신할 수 있습니다.
진입 위치
- 데스크톱 앱 왼쪽 아이콘 바의 Scheduled, 또는 웹 앱 사이드바 하단의 Scheduled.
- 명령 메뉴(
⇧⌘P, Windows에서는Ctrl+Shift+P)에서 Go to · Scheduled tasks 를 검색합니다. - 앱 내 알림(예약 작업 완료, 실패, 일시 중지)을 클릭하면 해당 예약 작업이 열립니다.
- 세션 타이머에는 추가 진입 위치가 있습니다: 세션 상단 바의 타이머 아이콘, 또는 상단 바의 … › Session timers.
보드
왼쪽 목록은 Upcoming, Paused, Ended 그룹으로 나뉩니다. 각 행에는 다음 실행 시각과 일정이 표시됩니다. 세션 타이머에는 해당 세션과 만료 시각도 표시됩니다. 행을 클릭하면 오른쪽에 상세가 열립니다. 상세에서 할 수 있는 작업:
상세에는 일정, 다음 실행, 프로젝트, 모델, 알림, 만든 방식(세션에서 만든 작업은 해당 세션으로 연결됨), 지시, 실행 기록도 표시됩니다.
Runs 에는 실행마다 한 행이 있으며, 시각과 결과(진행 중, Done, Failed · 이유, Skipped · 이유, Stopped)가 표시됩니다. 세션이 있는 기록을 클릭하면 해당 실행의 세션이 열립니다.
예약 작업 만들기
- 보드에서 New task 를 클릭해 Schedule a task 를 엽니다. Plus가 없으면 구독 대화 상자가 먼저 열리고, 구독 후 자동으로 이 화면으로 돌아옵니다.
- 텍스트 상자에 일정에 따라 실행할 내용을 작성합니다.
- Project 를 선택합니다. 기본값은 가장 최근에 사용한 프로젝트입니다. 아직 프로젝트가 없으면 먼저 프로젝트를 만들고 게시해야 합니다.
- Repeat 를 선택한 다음 해당 반복 옵션의 시각을 입력합니다(아래 표 참고).
- (선택) Advanced 를 펼쳐 다른 설정을 조정합니다.
- Create 를 클릭합니다. Scheduled · next run X 가 표시됩니다.
- Time 은 30분 단위이며 현지 시간 기준입니다.
- 지시는 최대 16 KiB입니다. 각 실행은 최대 1시간이며, 이를 초과한 실행은 Timed out 으로 기록됩니다.
- 일회성 작업은 실행 후 Ended 로 이동합니다.
고급 설정
예약 작업에는 권한 설정이 없습니다. 클라우드 예약 작업은 항상 전체 권한으로 실행됩니다.
예약 작업 편집
상세에서 연필 아이콘을 클릭해 Edit scheduled task 를 엽니다. 필드는 만들 때와 같습니다. 작업을 내 다른 프로젝트로 옮길 수 있습니다. 세션에서 만든 작업은 프로젝트를 변경할 수 없습니다.세션에서 에이전트가 만든 초안
어느 세션에서든 일상 언어로 일정을 요청할 수 있습니다. 예: “평일 오전 9시마다 의존성 업데이트 확인”. 에이전트가 예약 작업 초안을 만들고 세션에 확인 카드가 나타납니다. 확인 카드의 예약 작업은 Create를 클릭하기 전에는 실행되지 않습니다.- Create: 즉시 적용됩니다. 카드가 Scheduled · next run X 로 바뀌고 View in Scheduled 가 표시됩니다.
- Edit: Edit scheduled task 를 열어 수정합니다. 저장한 후 Create 를 클릭합니다.
- Not now: 아무것도 만들어지지 않습니다.
세션 타이머
세션 타이머 는 세션에 연결됩니다. 정해진 시각에 해당 세션으로 트리거 메시지를 보내고, 에이전트가 그 세션에서 작업을 이어 갑니다. “30분 후에 배포를 다시 확인” 또는 “매시간 대기열 확인”처럼 현재 세션의 맥락과 관련된 작업에 적합합니다.- 에이전트가 만들기: 에이전트는 사용자 확인 없이 현재 세션의 타이머를 직접 만들고, 수정하고, 삭제할 수 있습니다. 변경할 때마다 타임라인에 한 줄이 남습니다.
- 타이머 패널: 세션에 타이머가 있으면 상단 바의 제목 옆에 타이머 아이콘이 나타납니다. 타이머가 없으면 상단 바의 … › Session timers 에서 패널을 엽니다. 패널에서 각 타이머를 Run now, Turn off / Turn on, Renew, Delete 할 수 있습니다.
- 새 타이머: 패널에서 New timer 를 클릭하고 Prompt 와 Name (optional) 을 입력한 다음, In N minutes(최대 7일) 또는 Repeating (cron)(5필드 cron 표현식, 최소 5분 간격)을 선택하고 Create 를 클릭합니다.
- 세션을 중지하면 현재 턴만 종료됩니다. 세션 타이머는 계속 유효합니다.
타이머가 실행될 때
- 정해진 시각에 세션에 Timer fired · name 메시지가 나타나고, 에이전트가 턴을 시작합니다.
- 세션이 사용 중이면 타이머의 When busy 설정에 따라 Skip this run 또는 Wait in queue 로 처리됩니다.
- 일회성 타이머는 실행 후 자동으로 꺼집니다.
만료와 갱신
- 반복 세션 타이머는 만든 후 7일간 유효합니다. 만료 24시간 전부터 패널에 Expiring soon 이 표시되고, 타임라인에 Renew 버튼이 있는 알림이 표시됩니다. 클릭하면 타이머가 7일 연장됩니다.
- 만료된 타이머는 꺼집니다. 먼저 갱신한 다음 켭니다.
- 갱신은 원래의 켜짐 또는 꺼짐 상태를 유지합니다. 사용자가 직접 끈 타이머는 갱신 후에도 꺼져 있습니다. 만료로 꺼진 타이머는 갱신 후 다시 켜집니다.
실행 규칙
반복 실패 후 자동 일시 중지
3회 연속 실행에 실패하면 예약 작업이 자동으로 일시 중지됩니다. 보드에 Paused after failures 가 표시되고 알림을 받습니다. 실행 기록에서 실패 이유를 확인하고 수정한 다음 Resume 을 클릭합니다.삭제
상세에서 삭제 아이콘을 클릭하고 확인합니다. 일정은 더 이상 실행되지 않으며 실행 기록이 삭제됩니다. 이미 만들어진 세션과 세션의 메시지는 유지됩니다.참고 및 제한 사항
- 예약 작업의 가장 짧은 고정 간격은 15분입니다. 반복 세션 타이머의 최소 간격은 5분입니다.
- 예약 작업 양식은 사용자 지정 cron 표현식을 지원하지 않습니다. 세션 타이머는 cron을 지원합니다.
- 반복 세션 타이머는 7일 후 만료되며 갱신해야 합니다.
- 각 실행은 모델 사용량을 소모합니다(Plus 모델, 또는 선택한 구독 / BYOK).
- Plus가 없어도 보드를 둘러볼 수 있으며, 작업을 만들면 먼저 구독을 안내합니다. Plus가 없을 때를 참고하세요.