예약 작업 생명 주기
예약 작업 목록
워크스페이스 > 예약 작업에서 모든 스케줄을 확인합니다.| 기능 | 설명 |
|---|---|
| 검색 | 이름, 설명, 프롬프트로 검색 |
| 활성/비활성 토글 | 스케줄 즉시 켜기/끄기 |
| 즉시 실행 | 다음 주기를 기다리지 않고 바로 실행 |
| 삭제 | 스케줄 및 실행 이력 삭제 |
예약 작업 생성
”+ 새 예약 작업” 버튼을 클릭하여 스케줄을 생성합니다.대상 선택
실행할 에이전트, 플로우, 또는 모델을 선택합니다.
| 대상 유형 | 설명 |
|---|---|
| 에이전트 | 지식기반, 데이터베이스 등이 연결된 AI 에이전트 |
| 플로우 | 다단계 워크플로우 |
| 모델 | 기본 LLM 모델 (직접 프롬프트 전달) |
대상 에이전트/모델에 대한 접근 권한이 있어야 선택할 수 있습니다. 권한이 없으면 목록에 표시되지 않습니다.
프롬프트 작성
실행 시 전달할 프롬프트를 입력합니다.작성 팁:
- 구체적인 출력 형태를 명시하세요
- 에이전트에 구조화된 출력(JSON Schema)이 설정되어 있으면, 결과 필드를 알림 템플릿에서 활용할 수 있습니다
반복 주기 설정 (크론 에디터)
실행 주기를 설정합니다. 직관적인 크론 에디터를 제공합니다.
타임존과 실행 기간도 설정할 수 있습니다.
| 모드 | 설명 | 예시 |
|---|---|---|
| 간격 | N분마다 실행 (1, 2, 3, 5, 10, 15, 20, 30분) | 매 10분마다 |
| 매시간 | 매시간 특정 분에 실행 | 매시간 30분에 |
| 매일 | 매일 지정 시간에 실행 | 매일 오전 9:00 |
| 매주 | 지정 요일 + 시간에 실행 | 월~금 오전 9:00 |
| 매월 | 지정 일 + 시간에 실행 | 매월 1일 오전 8:00 |
| 커스텀 | 크론 표현식 직접 입력 | 0 9 * * 1-5 |
| 설정 | 설명 |
|---|---|
| 타임존 | 실행 시간 기준 시간대 (기본: 브라우저 시간대) |
| 시작일 | 스케줄 시작 날짜 (선택) |
| 종료일 | 스케줄 종료 날짜 (선택, 미설정 시 무기한) |
알림 설정
실행 결과를 알림으로 받을 채널을 설정합니다. 여러 개의 알림을 추가할 수 있습니다.
| 설정 | 설명 |
|---|---|
| 채널 유형 | 이메일 / 웹훅(사전 설정) / 직접 URL |
| 채널 선택 | 관리자가 설정한 이메일 또는 웹훅 채널 선택 |
| 트리거 | 항상 / 성공 시만 / 실패 시만 |
| 이메일 수신자 | 이메일 주소 목록 (이메일 채널만) |
| 제목/본문 템플릿 | 이메일 제목 및 본문 (이메일 채널만) |
| 메시지 템플릿 | 웹훅 메시지 (웹훅 채널만, 선택) |
크론 표현식 가이드
커스텀 모드에서 크론 표현식을 직접 입력할 수 있습니다. 크론 표현식은 5개 필드로 구성됩니다.특수 문자
| 문자 | 의미 | 예시 |
|---|---|---|
* | 모든 값 | * * * * * = 매분 실행 |
, | 여러 값 나열 | 0 9,18 * * * = 9시, 18시 |
- | 범위 지정 | 0 9 * * 1-5 = 월~금 |
/ | 간격 지정 | */10 * * * * = 10분마다 |
요일 번호
| 번호 | 요일 |
|---|---|
| 0 | 일요일 |
| 1 | 월요일 |
| 2 | 화요일 |
| 3 | 수요일 |
| 4 | 목요일 |
| 5 | 금요일 |
| 6 | 토요일 |
자주 사용하는 표현식
| 크론 표현식 | 설명 |
|---|---|
0 9 * * * | 매일 오전 9시 |
0 9 * * 1-5 | 평일(월~금) 오전 9시 |
0 9,18 * * * | 매일 오전 9시, 오후 6시 |
30 8 * * 1 | 매주 월요일 오전 8시 30분 |
0 0 1 * * | 매월 1일 자정 |
0 0 1,15 * * | 매월 1일, 15일 자정 |
*/30 * * * * | 30분마다 |
0 */2 * * * | 2시간마다 정각 |
0 9 * * 1,3,5 | 월/수/금 오전 9시 |
0 22 * * 0 | 매주 일요일 오후 10시 |
예약 작업 관리
활성화/비활성화
목록에서 토글 스위치로 스케줄을 즉시 켜거나 끌 수 있습니다. 비활성화 시 다음 실행이 예약되지 않습니다.즉시 실행
“실행” 버튼을 클릭하면 다음 주기를 기다리지 않고 즉시 실행합니다. 수동으로 결과를 확인하거나 설정을 테스트할 때 유용합니다.편집
스케줄 카드를 클릭하여 상세 페이지에서 모든 설정을 수정할 수 있습니다. 수정 시 다음 실행 시간이 자동으로 재계산됩니다.삭제
스케줄을 삭제하면 관련 실행 이력도 함께 삭제됩니다.공유
예약 작업을 다른 사용자에게 공유할 수 있습니다. 프로젝트와 마찬가지로 복사 기반으로 동작합니다.| 항목 | 설명 |
|---|---|
| 독립 복사본 | 공유받은 사용자에게 별도의 스케줄이 생성됩니다 |
| 설정 복사 | 대상, 프롬프트, 주기, 알림 설정이 모두 복사됩니다 |
| 독립 수정 | 공유 후 각 사용자가 자신의 스케줄을 자유롭게 수정할 수 있습니다 |
| 출처 추적 | 복사본 메타데이터에 원본 소유자와 스케줄 정보가 기록됩니다 |
실행 이력
스케줄 상세 페이지에서 최근 실행 이력을 확인할 수 있습니다.상태
| 상태 | 색상 | 설명 |
|---|---|---|
| 대기 중 | 노란색 | 실행 대기 |
| 실행 중 | 파란색 | 현재 실행 중 |
| 완료 | 초록색 | 정상 완료 |
| 실패 | 빨간색 | 오류 발생 |
이력 상세 정보
| 항목 | 설명 |
|---|---|
| 실행 시간 | 예약된 실행 시간 |
| 소요 시간 | 시작부터 완료까지 걸린 시간 |
| 재시도 횟수 | 오류 발생 시 자동 재시도 횟수 (최대 2회) |
| 에러 메시지 | 실패 원인 (실패 시) |
| 채팅 보기 | 결과가 저장된 채팅으로 이동 |
자동 재시도
타임아웃, 서버 오류(5xx), 속도 제한 오류는 자동으로 최대 2회 재시도됩니다. 10분 이상 실행 중인 작업은 자동으로 복구됩니다.이력 보관
완료 및 실패한 실행 기록은 30일 후 자동으로 삭제됩니다.채팅 저장
모든 실행 결과는 전용 채팅에 저장됩니다.| 항목 | 설명 |
|---|---|
| 첫 실행 | 새 채팅이 자동 생성됩니다 |
| 이후 실행 | 같은 채팅에 결과가 누적됩니다 |
| 채팅 제목 | 알림 제목 템플릿으로 설정 (기본: [예약 작업] 스케줄명) |
| 바로가기 | 실행 이력에서 “채팅 보기” 링크로 이동 |
차트 이미지
데이터베이스(DbSphere) 에이전트가 생성한 차트는 서버사이드 렌더링으로 이미지로 변환되어 알림에 포함됩니다. 지원 차트 유형:- 막대 차트, 선 차트, 원형 차트, 산점도
- 히트맵, 히스토그램, 그룹 막대 차트
| 채널 | 방식 |
|---|---|
| 이메일 | 인라인 이미지로 본문에 포함 |
| Slack | 이미지 URL로 표시 |
| Teams | Adaptive Card에 이미지 포함 |
| Discord | Embed에 이미지 포함 (첫 번째 이미지) |
템플릿 변수
알림 제목, 본문, 메시지 템플릿에서 사용할 수 있는 변수입니다.| 변수 | 설명 | 예시 |
|---|---|---|
{{schedule_name}} | 스케줄 이름 | 일일 매출 보고서 |
{{prompt}} | 실행된 프롬프트 | 오늘의 매출 데이터를… |
{{result}} | 전체 실행 결과 | (AI 응답 전체) |
{{status}} | 실행 상태 | completed / failed |
{{completed_at}} | 완료 시간 | 2025-02-27 09:00:45 |
구조화된 출력 접근
대상 에이전트에 JSON Schema 응답 형식이 설정되어 있으면, 점 표기법으로 개별 필드에 접근할 수 있습니다.템플릿 예시
- 이메일 제목
- 이메일 본문
- Slack 메시지
FAQ
스케줄이 실행되지 않아요.
스케줄이 실행되지 않아요.
다음을 확인하세요:
- 스케줄이 활성 상태인지 확인
- 시작일/종료일이 올바르게 설정되어 있는지 확인
- 대상 에이전트/모델에 대한 접근 권한 확인
features.scheduled_tasks권한이 사용자 그룹에 활성화되어 있는지 확인
여러 시간대의 사용자가 있으면 어떻게 하나요?
여러 시간대의 사용자가 있으면 어떻게 하나요?
각 스케줄에 개별 타임존을 설정할 수 있습니다. 예: 서울 사무소는
Asia/Seoul, 뉴욕 사무소는 America/New_York.실행 결과가 채팅에 보이지 않아요.
실행 결과가 채팅에 보이지 않아요.
실행이 실패했을 수 있습니다. 실행 이력에서 상태와 에러 메시지를 확인하세요.
알림 채널은 어디서 설정하나요?
알림 채널은 어디서 설정하나요?
이메일, 웹훅 채널은 관리자가 관리자 > 설정 > 알림에서 사전 설정합니다. 직접 URL 방식은 사전 설정 없이 스케줄에서 바로 입력할 수 있습니다.
크론 표현식을 모르겠어요.
크론 표현식을 모르겠어요.
간격/매시간/매일/매주/매월 모드를 선택하면 자동으로 크론 표현식이 생성됩니다. 커스텀 모드는 위의 크론 표현식 가이드 섹션을 참고하세요.
예약 작업을 다른 사용자에게 공유할 수 있나요?
예약 작업을 다른 사용자에게 공유할 수 있나요?
네, 프로젝트와 마찬가지로 복사 기반 공유가 가능합니다. 스케줄 상세 페이지에서 “공유” 버튼을 클릭하고 대상 사용자를 선택하세요. 각 사용자에게 독립적인 복사본이 생성됩니다.