nora pipelines 참고).
Schedule
정해 둔 시각마다 돕니다.- 프리셋 매일·매주·매월·매년 중 선택하고 시간과 간격을 정합니다.
- 사용자 정의 cron 5필드 cron 표현식을 씁니다.
0 9 * * 1은 매주 월요일 09:00입니다. - 시간대 기본은 UTC입니다. 한국 시각 기준으로 돌리려면 Asia/Seoul로 바꾸세요.
user_input으로 전달됩니다. Workflow의 같은 필드와 동일하게 동작합니다. RSS 주소처럼 실행마다 필요한 입력을 넣어 두는 자리입니다.
Watch
연결해 둔 소스를 지켜보다가 변화가 생기면 정제라인을 돌립니다. 폴더에 새 문서가 올라올 때마다 지식을 갱신하는 용도에 맞습니다.- Trigger on 무엇에 반응할지 선택합니다. New file(새 파일), New or modified file(새 파일과 수정된 파일), Any change(삭제까지 포함한 모든 변화).
- Debounce 기본 5초. 파일 여러 개가 한꺼번에 올라오면 이 시간 동안 기다렸다가 실행 하나로 묶어서 돌립니다. 100개를 업로드해도 실행이 100번 돌지 않습니다.
Webhook
정제라인을 HTTP 엔드포인트로 만듭니다. JSON을 POST 할 수 있는 시스템이면 무엇이든 실행을 걸 수 있습니다. CMS·티켓팅·CI에 이미 웹훅이 있을 때 좋습니다.- 엔드포인트 웹훅 슬러그로 만들어진 POST 주소입니다. 인스펙터에서 복사합니다.
- 인증 헤더 토큰 방식입니다. 기본 헤더는
X-Webhook-Token이고, [토큰 생성] 버튼을 누르면 서버가 랜덤 토큰을 만들어 줍니다. 호출할 때 이 값을 헤더로 보냅니다. - Body 매핑 첫 POST를 받은 뒤 [새로 고침] 버튼을 누르면 수신한 body가 보입니다. 필드를 클릭해 input·image·audio·Thread ID·User ID로 매핑합니다.
API
코드에서 호출해 실행을 걸 때 씁니다. Webhook이 외부 시스템의 이벤트를 받는 자리라면, API는 우리 서비스가 정제라인을 직접 부르는 자리입니다.- 엔드포인트
…/api/v1/<워크스페이스>/foundry/<슬러그>에 POST 합니다. - 본문
input(object),variables(object),idempotency_key(string) - 인증 헤더 토큰 방식이고 기본 헤더는
Authorization입니다. 토큰 생성은 Webhook과 같습니다.
트리거 종류와 그래프 규칙
Trigger 노드은 두 갈래로 갈립니다. 정제라인이 반드시 갖춰야 할 구성이 이 갈래에 따라 달라집니다.- Payload 트리거 (Webhook · API) 호출 쪽이 본문을 넘겨 주므로, 트리거가 곧 입력입니다. Source 노드가 없어도 되고, Output 노드가 없어도 됩니다. 결과는 호출자에게 응답 본문으로 그대로 돌아갑니다. 검증·알림·계산처럼 값을 계산해 돌려주기만 하는 정제라인에 맞습니다.
- Signal 트리거 (Schedule · Watch) “언제” 만 알려 주므로 실제 데이터는 Source 노드가 읽어야 합니다. Source 없이 저장하면 오류가 나고, 결과를 어딘가에 남겨야 하니 Output 도 최소 하나 필요합니다.