Skip to main content
Trigger는 Flow를 시작하는 방식입니다. 세 종류가 있습니다. api(SDK/CLI에서 호출), webhook(외부 HTTP POST), schedule(크론 기반)입니다.

명령

triggers create

플래그:
  • --kind(필수) api / webhook / schedule
  • --name <n> 표시 이름
  • --config <json> 종류별 인라인 설정
  • --x <n>, --y <n> 캔버스 위치
명령이 생성한 Trigger의 ID를 출력합니다(그리고 webhook/api에는 초기 시크릿도 나옵니다. 한 번만 표시하니 지금 복사하세요).

triggers update

Update 플래그가 많습니다. 아래에 그룹별로 정리했습니다.

Update 플래그 (그룹별)

정체성
  • --set-name <n>
  • --set-kind api|webhook|schedule
  • --set-x <n>, --set-y <n>, --set-width <n>
Schedule 설정(kind = schedule)
  • --set-schedule-mode preset|cron
  • --set-cron <expr> mode = cron 용, 예: "0 9 * * *"
  • --set-period daily|weekly|monthly|yearly mode = preset 용
  • --set-time HH:MM preset 용
  • --set-day-of-week 1..7 weekly 용
  • --set-day-of-month 1..31 monthly 용
  • --set-month-of-year 1..12 yearly 용
  • --set-interval <n> 간격 수
  • --set-timezone <IANA> 예: America/Los_Angeles
  • --set-schedule-input <text> 스케줄 실행마다 넣는 페이로드
  • --set-schedule-thread-id <id> 채팅 Agent 용, 게시할 스레드
  • --set-schedule-user-id <id> 사용자 귀속
  • --set-schedule-tts true|false text-to-speech 입력으로 다룹니다
Webhook 설정(kind = webhook)
  • --set-webhook-slug <s> 경로 접미사(URL이 .../trigger/webhook/<slug>가 됩니다)
  • --set-webhook-input-path <json-path> 본문에서 입력 추출
  • --set-webhook-image-path <json-path> 이미지 데이터 추출
  • --set-webhook-audio-path <json-path> 오디오 데이터 추출
  • --set-webhook-auth-kind <k> none / header_token / hmac_sha256
  • --set-webhook-auth-header <name> header auth의 헤더 이름
API 설정(kind = api)
  • --set-api-slug <s> 경로 접미사
  • --set-api-auth-kind <k> none / header_token / hmac_sha256
  • --set-api-auth-header <name>
한꺼번에
  • --patch <json> 임의 병합
설정 패치는 기존 설정에 deep-merge 됩니다.

triggers edit

$EDITOR에 전체 JSON을 엽니다. 저장하면 적용됩니다.

triggers delete

triggers lock / triggers unlock

MCP 로 굴리는 에이전트나 CLI 스크립트가 편집하지 못하게 보호할 때 씁니다. 잠금 시맨틱은 agents · tools · actions · triggers 네 블록 타입이 동일합니다.

triggers secret rotate

새 서명 시크릿을 발급합니다. 평문을 한 번 출력하니 호출자에 복사하세요. 이전 시크릿이 60분 동안 그대로 남아, 다운타임 없이 호출자를 업데이트할 수 있습니다. 스케줄로 돌리거나(분기마다가 흔합니다) 새는 게 의심되면 바로 돌립니다.

레시피

매일 오전 9시 서울 시간 스케줄 추가

Flow를 배포하면 스케줄이 걸리기 시작합니다.

CMS 용 웹훅 트리거 추가

웹훅 URL은 앱의 Trigger 인스펙터에서 복사합니다. https://<서버>/api/v1/<워크스페이스 ID>/webhooks/<슬러그> 모양이고, 워크스페이스 ID는 발급 시 임의로 정해지는 문자열이라 주소를 짐작할 수 없습니다. X-Nora-Signature로 POST 하도록 CMS를 설정합니다.

preset 스케줄을 cron으로 전환

Cron이 preset보다 표현력이 큽니다. daily/weekly/monthly 패턴을 넘는 건 다 cron으로 씁니다.

웹훅이 추출하는 입력 경로 바꾸기

옛 CMS 모양은 { "body": "..." }이고, 경로는 body입니다. 새 모양은 { "message": { "body": "..." } }입니다:
변경을 라이브로 하려면 Flow를 배포합니다.