Skip to main content
Trigger 블록 은 Flow 의 진입점입니다. 실행이 어떻게 시작되는지와 어떤 페이로드 가 첫 Agent 로 들어가는지 정의합니다. 모든 Flow 는 최소 하나의 Trigger 가 필요합니다. 여러 개도 가능 — 같은 Flow 가 채팅 UI, 웹훅, 야간 스케줄을 동시에 서빙할 수 있습니다.

​
Trigger 종류

​
채팅 Trigger

기본 — Nora 대시보드, 공유된 워크스페이스 채팅 링크, 또는 임베드에서 Flow 를 채팅 인터페이스로 표면화. 각 턴은 같은 세션 안에 새 실행을 만듭니다. 설정:
  • Public link — 온/오프. 켜면 공유 가능한 URL 생성 (워크스페이스에 인증 게이트).
  • Anonymous access — 온/오프. 기본 오프. 오프면 로그인 필요.
  • Session memory — 유지할 컨텍스트 턴 수. 기본 20.

​
웹훅 Trigger

Flow 를 HTTP 엔드포인트로 만듭니다. JSON 을 POST 할 수 있는 무엇이든 호출 가능. 받게 되는 것:
  • URL: https://api.platform.nora.my/flows/{slug}/trigger
  • 서명 시크릿. 매 요청에 X-Nora-Signature 로 포함.
POST 본문이 Trigger 의 출력 페이로드가 됩니다 — 첫 Agent 가 입력으로 받습니다.

​
스케줄 Trigger

Flow 를 크론 스케줄로 실행.
  • Cron 표현식 — 표준 5필드, @daily / @hourly 축약 지원.
  • Timezone — 워크스페이스 타임존이 기본.
  • Payload 템플릿 — 첫 Agent 로 보낼 정적 JSON 페이로드 (스케줄 실행 파라미터화에 유용).
Flow 가 언퍼블리시되면 스케줄은 자동으로 일시정지.

​
이벤트 Trigger

Nora 내부 이벤트에 발화: 새 문서 인제스트, 피드백 추가, 시그널 열림, 승인 결정. 시스템 활동에 반응하는 메타-Flow 에 유용.

​
서명 (웹훅)

Trigger 인스펙터에서 언제든 서명 시크릿을 로테이션 가능. 60분 유예 기간 동안은 이전 서명도 허용되어 호출자를 다운타임 없이 업데이트 가능. 호출자에서 검증:

​
요율 제한

Trigger 별 요율 제한 (RPS + 동시 실행). 제한 초과 요청은 429. 인스펙터 → Limits 에서 조정.

​
여러 Trigger

각 Trigger 를 다른 시작 Agent 로 배선하거나 하나로 수렴시키세요. Agent 의 입력 스키마는 받을 수 있는 모든 페이로드 모양을 다뤄야 합니다 — 페이로드에 type 판별자를 두는 것이 흔한 패턴.