2.9. 자동화¶

자동화 페이지(사이드바 > 자동화)는 키보드 앞에 사람이 없어도 추론 작업을 일정대로 실행합니다. 문서 폴더의 일일 요약, URL을 대상으로 한 시간별 상태 점검, 주간 보고서 초안 같은 작업이 여기에 어울리죠. 자동화 하나는 모델(필요하면 에이전트까지)과 프롬프트 템플릿, 입력 소스, 출력 동작의 조합으로 구성됩니다.

페이지에는 자동화(목록), 실행 기록, Container Tasks 세 개의 탭이 있습니다. Container Tasks 탭은 컨테이너 안에서 실행되는 예약 작업을 보여주며, 자세한 내용은 컨테이너 작업 스케줄링을 참고하세요.

자동화 만들기¶

새 자동화를 클릭하고 양식을 채웁니다:

1. 기본 정보: 이름 (예: "일일 요약", "시간별 점검").
2. 일정: 빈도 프리셋(15분/30분마다, 매시간, 매일, 매주)을 고르거나 cron 표현식을 직접 입력합니다. 표현식은 입력하는 동안 검증되고, 시간대는 IANA 이름(예: Asia/Seoul, America/New_York)을 사용합니다.
3. 모델 및 에이전트: 작업을 실행할 모델을 고릅니다. 에이전트 필드의 기본값은 없음 (직접 추론)으로 프롬프트를 모델에 바로 보내고, 에이전트 프로필을 선택하면 해당 에이전트를 거쳐 실행됩니다. 모델 수명 주기는 토글 세 개로 조절합니다:
   • 실행 전 모델 자동 로드: 모델이 메모리에 없으면 로드합니다.
   • 실행 후 모델 언로드: 실행이 끝나면 메모리를 해제합니다.
   • 앱 시작 시 누락된 실행 따라잡기: 예약 시각에 앱이 꺼져 있었다면 다음 실행 시 한 번 실행합니다.
4. 도구: 예약 실행 중 모델이 호출할 수 있는 도구를 선택합니다. 아무것도 선택하지 않으면 도구 호출이 비활성화됩니다.

5. 입력 소스: 프롬프트에 {{input}}으로 주입되는 외부 데이터입니다 (선택 사항):

   • 없음: 외부 입력 없음.
   • 파일: 지정한 파일 경로의 내용.
   • 디렉터리 (글로브): glob 패턴에 일치하는 파일들 (예: /data/docs/*.txt).
   • URL (HTTP GET): URL 응답 본문.
   • 셸 명령어: 명령 실행 결과.

   셸 명령어

   셸 명령어는 앱의 권한으로 실행됩니다. 신뢰할 수 있는 명령만 사용하세요.

6. 프롬프트: 모델에 보낼 프롬프트 템플릿과 선택적인 시스템 프롬프트입니다.

7. 출력 동작: 결과를 어떻게 처리할지 정합니다:
   • 히스토리에만 저장: 실행 기록에서 확인합니다.
   • 파일로 저장: 지정한 디렉터리에 기록합니다.
   • 데스크탑 알림: OS 알림으로 표시합니다 (권한이 없으면 양식에서 알림 권한을 요청합니다).
   • 웹훅 (HTTP POST): 지정한 URL로 전송합니다.
8. 파라미터: 실행에 적용할 생성 설정으로, temperature(0~2)와 최대 토큰 수를 포함합니다.

템플릿 변수¶

프롬프트 템플릿(및 시스템 프롬프트)에는 실행 시점에 치환되는 변수를 쓸 수 있습니다:

자동화 관리¶

자동화 카드에는 모델, 일정을 풀어 쓴 문구(예: "매일 09:00"), 마지막 실행 결과, 다음 실행 시각이 표시됩니다. 카드에서 바로 할 수 있는 일은 다음과 같습니다:

• 삭제하지 않고 활성과 일시 중지 사이를 전환합니다.
• 지금 실행으로 일정과 무관하게 즉시 실행합니다.
• 편집으로 구성을 수정합니다.
• 삭제로 자동화를 제거합니다. 실행 기록도 함께 삭제되며, 진행 전에 확인 대화상자가 표시됩니다.

실행이 시작되거나 완료(소요 시간 포함)되거나 실패하면 데스크탑 알림이 표시됩니다.

실행 기록¶

실행 기록 탭에는 모든 실행이 자동화 이름, 상태, 시작 시각, 지속 시간, 결과와 함께 나열됩니다. 자동화, 상태, 날짜 범위로 필터링하고, 실행을 열어 전체 결과나 오류를 확인할 수 있습니다.