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

# 자동화

> 정해진 때나 무슨 일이 생겼을 때 저절로 도는 요청과, 실행이 남기는 것.

자동화는 **관리 → 자동화 → 일정**에 있습니다. 이 페이지에는 목록이 두 개 있습니다. 정해진 때 도는 일정과, 이벤트가 오면 도는 트리거입니다. 대화 안에서는 `/schedules`와 `/triggers`로 목록을 봅니다.

## 일정

일정은 아침 요약이나 주간 점검처럼 정해진 때 스스로 요청합니다. **새 일정**을 누르고 다음을 채웁니다.

| 칸 | 정하는 것 |
| - | - |
| **이름** | 영문 소문자, 숫자, `-`로 씁니다 |
| **무엇을 할까요** | 보낼 요청 |
| **언제** | **한 번**, 몇 분마다, 고른 요일의 정한 시각, 또는 cron 표현식. 시각은 내 시간대 기준입니다 |
| **위치** | 일정이 도는 대화, 또는 답을 보낼 채팅 |
| **새 소식만 보내기 (확인만, 밤에는 조용히)** | 할 말이 있을 때만 답하고, 방해 금지 시간에는 돌지 않습니다 |
| **중요도** | 실행이 실패했을 때 알리는 방식(아래 참고) |

대화에서 "내일 9시에 알려 줘"라고 해도 됩니다. 그러면 에이전트가 일정을 만듭니다. 채팅 채널에서 부탁하면 답도 그 채팅으로 갑니다.

일정은 앱이 열려 있으면 앱이 돌리고, 앱이 닫혀 있으면 백그라운드 서비스(`archetype daemon install`, [CLI](https://docs.archetype.ing/ko/start/cli.md) 참고)가 돌립니다. 컴퓨터가 꺼져 있는 동안 놓친 실행은 가장 최근 것 하나만 한 번 돕니다. 한 번에 도는 일정은 4개까지이고, 나머지는 차례를 기다립니다.

모델 없이 명령만 실행하는 일정은 터미널에서만 만들 수 있습니다. `archetype --create-schedule … -- PROGRAM` 형식입니다.

## 트리거

트리거는 무슨 일이 생기면 요청을 실행합니다. **새 트리거**를 누르고 무엇이 트리거를 깨울지 고릅니다.

* **플러그인 이벤트**: 미리 만든 예시로 **입금되면**, **회의 전에**, **답장이 필요한 메일이 오면**, **할 일 마감이 오늘이면**, **누군가의 생일이나 기념일이 다가오면**이 있습니다. 이벤트의 필드로 범위를 좁힐 수 있습니다. 글자는 대소문자를 가리지 않고 맞추고, 앞이나 뒤에 `*`를 붙이면 일부만 맞아도 됩니다. 20초 안에 이어서 온 이벤트는 한 턴에 묶어서 처리합니다.
* **주소로 이벤트가 오면**: 실패한 빌드나 새 이슈처럼, 다른 서비스가 이 주소를 부릅니다. 주소에는 시크릿 토큰이 들어 있습니다. **서명 요구 (권장)** 옵션을 켜면 GitHub 웹훅에 넣을 시크릿이 나오는데, 이 시크릿은 만들 때 한 번만 보여 줍니다. 같은 이벤트가 다시 와도 한 번만 실행합니다.

이벤트는 지시가 아니라 자료로서 요청과 함께 갑니다.

## 실행이 남기는 것

* **대화**: 실행 한 번이 자동화 대화의 턴 하나입니다. 대화는 내가 고른 것이거나, 자동화마다 따로 생긴 것입니다. **대화 열기**로 엽니다. 사람이 요청하지 않은 턴에는 무엇이 시작했는지가 적혀 있습니다.
* **최근 실행**: 실행마다 언제 돌았고 어떻게 끝났는지 나옵니다. **다음 실행**은 다음에 돌 때를 보여 주고, **지금 실행**은 바로 돌립니다.
* **실패한 실행**: **중요도**에 따라 알립니다. **고정됨**은 바로 알리고, **보통**은 **확인 필요**에 올리고 내 기기에 알리며, **배경**은 기록에만 남깁니다.
* **실행이 요청한 승인**: 기본으로는 60분까지 기다렸다가 거부되고, 실행은 무엇을 하지 못했는지 보고합니다. **자리에 없을 때의 승인**을 켜 두면 실행이 멈추고, 요청은 [Arch](https://docs.archetype.ing/ko/use/arch.md)에서 나를 기다립니다. 내가 답하면 실행이 이어집니다.
* **출력**: 명령 일정은 최근 20번 실행의 출력을 남깁니다.

자동화를 삭제하면 더는 돌지 않습니다. 대화와 답은 남습니다.


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