> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 예약 작업과 세션 타이머: 일정에 따라 자동 실행

> 예약 작업은 에이전트가 일정에 따라 클라우드 서버에서 지시를 자동으로 실행하도록 합니다. 세션 타이머는 에이전트가 정해진 시각에 세션에서 작업을 이어 가도록 합니다. 이 페이지에서는 작업 만들기, 확인 카드, 세션 타이머, 갱신, 실패, 자동 일시 중지를 설명합니다.

AIHubMix Cloud에는 두 종류의 일정이 있습니다.

* **예약 작업**: 프로젝트에 속한 지시입니다. 정해진 시각에 에이전트가 해당 프로젝트의 클라우드 서버에서 실행하며, 실행할 때마다 세션을 하나 만듭니다(또는 같은 세션에서 이어 갑니다). **Scheduled** 보드에서 만들거나, 에이전트가 세션에서 초안을 만들고 사용자가 확인하면 적용됩니다.
* **세션 타이머**: 세션에 연결된 타이머입니다. 정해진 시각에 해당 세션으로 트리거 메시지를 보내고, 에이전트가 작업을 이어 갑니다. 에이전트가 세션에서 직접 만들 수 있으며(확인 불필요), 사용자도 세션 상단 바의 타이머 패널에서 만들 수 있습니다. 반복 세션 타이머는 7일 후 만료되며 갱신할 수 있습니다.

두 종류 모두 **Scheduled** 보드에 표시됩니다. 일정은 앱이나 웹 페이지를 닫아도 클라우드 서버에서 계속 실행됩니다. 예약 작업을 실행하려면 [Plus](https://docs.aihubmix.com/ko/cloud/plus/plus-plan.md)가 필요하며, 데스크톱 앱, 웹 앱, 모바일 웹에서 지원됩니다.

## 진입 위치

* 데스크톱 앱 왼쪽 아이콘 바의 **Scheduled**, 또는 웹 앱 사이드바 하단의 **Scheduled**.
* 명령 메뉴(`⇧⌘P`, Windows에서는 `Ctrl+Shift+P`)에서 **Go to · Scheduled tasks** 를 검색합니다.
* 앱 내 알림(예약 작업 완료, 실패, 일시 중지)을 클릭하면 해당 예약 작업이 열립니다.
* 세션 타이머에는 추가 진입 위치가 있습니다: 세션 상단 바의 타이머 아이콘, 또는 상단 바의 **…** › **Session timers**.

## 보드

왼쪽 목록은 **Upcoming**, **Paused**, **Ended** 그룹으로 나뉩니다. 각 행에는 다음 실행 시각과 일정이 표시됩니다. 세션 타이머에는 해당 세션과 만료 시각도 표시됩니다. 행을 클릭하면 오른쪽에 상세가 열립니다.

상세에서 할 수 있는 작업:

| 작업 | 설명 |
| - | - |
| **Run now** | 즉시 한 번 실행합니다. 이전 실행이 진행 중이면 클릭할 수 없습니다 |
| **Renew** | 반복 세션 타이머에만 있습니다. 7일 연장합니다 |
| **Pause** / **Resume** | 일시 중지하면 더 이상 일정에 따라 실행되지 않습니다 |
| 편집(연필 아이콘) | **Edit scheduled task** 를 엽니다. 세션 타이머는 편집할 수 없습니다 |
| 삭제(휴지통 아이콘) | 확인 후 삭제합니다 |

상세에는 일정, 다음 실행, 프로젝트, 모델, 알림, 만든 방식(세션에서 만든 작업은 해당 세션으로 연결됨), 지시, 실행 기록도 표시됩니다.

**Runs** 에는 실행마다 한 행이 있으며, 시각과 결과(진행 중, **Done**, **Failed · 이유**, **Skipped · 이유**, **Stopped**)가 표시됩니다. 세션이 있는 기록을 클릭하면 해당 실행의 세션이 열립니다.

## 예약 작업 만들기

1. 보드에서 **New task** 를 클릭해 **Schedule a task** 를 엽니다. Plus가 없으면 구독 대화 상자가 먼저 열리고, 구독 후 자동으로 이 화면으로 돌아옵니다.
2. 텍스트 상자에 일정에 따라 실행할 내용을 작성합니다.
3. **Project** 를 선택합니다. 기본값은 가장 최근에 사용한 프로젝트입니다. 아직 프로젝트가 없으면 먼저 프로젝트를 만들고 게시해야 합니다.
4. **Repeat** 를 선택한 다음 해당 반복 옵션의 시각을 입력합니다(아래 표 참고).
5. (선택) **Advanced** 를 펼쳐 다른 설정을 조정합니다.
6. **Create** 를 클릭합니다. **Scheduled · next run X** 가 표시됩니다.

| Repeat | 입력 항목 |
| - | - |
| Once | **Date**(오늘부터 7일 이내) + **Time** |
| Daily | **Time** |
| Weekdays | **Time**(월요일부터 금요일) |
| Weekly | **Day** + **Time** |
| Fixed interval | **Run every**: 15 min, 20 min, 30 min, 1 h |

* **Time** 은 30분 단위이며 현지 시간 기준입니다.
* 지시는 최대 16 KiB입니다. 각 실행은 최대 1시간이며, 이를 초과한 실행은 **Timed out** 으로 기록됩니다.
* 일회성 작업은 실행 후 **Ended** 로 이동합니다.

### 고급 설정

| 설정 | 옵션 | 기본값 |
| - | - | - |
| Notifications | All updates(완료와 실패 시 알림) / Important updates(실패 시에만 알림) / Off | Important updates |
| New chat for each run | 끄면 모든 실행이 같은 세션에서 이어집니다 | 켜짐 |
| Harness / Model / Effort | 새 세션과 같은 옵션 | 마지막 새 세션에서 선택한 값 |

예약 작업에는 권한 설정이 없습니다. 클라우드 예약 작업은 항상 전체 권한으로 실행됩니다.

### 예약 작업 편집

상세에서 연필 아이콘을 클릭해 **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일 연장됩니다.
* 만료된 타이머는 꺼집니다. 먼저 갱신한 다음 켭니다.
* 갱신은 원래의 켜짐 또는 꺼짐 상태를 유지합니다. 사용자가 직접 끈 타이머는 갱신 후에도 꺼져 있습니다. 만료로 꺼진 타이머는 갱신 후 다시 켜집니다.

## 실행 규칙

| 상황 | 결과 |
| - | - |
| 이전 실행이 아직 진행 중 | 이번 실행을 건너뜁니다. 이 동안에는 **Run now** 를 클릭할 수 없습니다 |
| 한 번 실패 | 실패 이유가 기록되고 알림 설정에 따라 알림이 전송됩니다. 다음 실행은 일정대로 진행됩니다 |
| 3회 연속 실패 | 자동으로 일시 중지됩니다. 다음 섹션을 참고하세요 |
| 앱 또는 웹 페이지를 닫음 | 정상적으로 실행됩니다. 결과는 나중에 세션과 실행 기록에서 확인합니다 |
| Plus가 없거나 구독이 비활성 | **Run now** 또는 **Resume** 을 할 수 없습니다. 화면에서 구독 또는 갱신을 안내합니다 |
| 클라우드 서버가 실행 중이 아님 | **Run now** 를 할 수 없습니다 |

## 반복 실패 후 자동 일시 중지

3회 연속 실행에 실패하면 예약 작업이 자동으로 일시 중지됩니다. 보드에 **Paused after failures** 가 표시되고 알림을 받습니다. 실행 기록에서 실패 이유를 확인하고 수정한 다음 **Resume** 을 클릭합니다.

## 삭제

상세에서 삭제 아이콘을 클릭하고 확인합니다. 일정은 더 이상 실행되지 않으며 실행 기록이 삭제됩니다. 이미 만들어진 세션과 세션의 메시지는 유지됩니다.

## 참고 및 제한 사항

* 예약 작업의 가장 짧은 고정 간격은 15분입니다. 반복 세션 타이머의 최소 간격은 5분입니다.
* 예약 작업 양식은 사용자 지정 cron 표현식을 지원하지 않습니다. 세션 타이머는 cron을 지원합니다.
* 반복 세션 타이머는 7일 후 만료되며 갱신해야 합니다.
* 각 실행은 모델 사용량을 소모합니다(Plus 모델, 또는 선택한 구독 / BYOK).
* Plus가 없어도 보드를 둘러볼 수 있으며, 작업을 만들면 먼저 구독을 안내합니다. [Plus가 없을 때](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)를 참고하세요.

## 자주 묻는 질문

### 컴퓨터를 꺼도 예약 작업이 실행되나요?

예. 예약 작업은 클라우드 서버에서 실행되므로 기기가 켜져 있는지와 관계없이 실행됩니다.

### 예약 작업이 왜 일시 중지되었나요?

직접 일시 중지했거나, 3회 연속 실패해 자동으로 일시 중지되었을 수 있습니다. 세션 타이머라면 만료되었을 수도 있습니다. 실행 기록에서 이유를 확인하고 수정한 다음 **Resume** 을 클릭하세요(만료된 타이머는 먼저 **Renew**).

### 에이전트가 내 승인 없이 일정을 만들 수 있나요?

세션 타이머는 가능합니다. 에이전트가 현재 세션에서 직접 만들 수 있고, 타임라인에 기록이 한 줄 남으며, 상단 바 패널에서 끄거나 삭제할 수 있습니다. 프로젝트 예약 작업은 불가능합니다. 에이전트는 초안만 만들 수 있고, 확인 카드에서 사용자가 **Create** 를 클릭해야 합니다.

### 세션 타이머와 예약 작업 중 무엇을 써야 하나요?

현재 세션의 맥락을 이어서 작업해야 하면 세션 타이머를 사용합니다. 프로젝트에서 장기간 일정에 따라 독립적으로 실행해야 하면 예약 작업을 사용합니다.

## 관련 문서

* [Plus가 없을 때](https://docs.aihubmix.com/ko/cloud/plus/without-plus.md)
* [클라우드 서버 개요](https://docs.aihubmix.com/ko/cloud/cloud-host/overview.md)
* [Harness와 모델](https://docs.aihubmix.com/ko/cloud/models/harness-and-models.md)
* [알림 설정](https://docs.aihubmix.com/ko/cloud/settings/notifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.