Skip to main content
Trigger 블록으로 Flow를 시작합니다. Flow가 어떻게 시작되는지, 어떤 페이로드가 첫 Agent로 들어가는지 정합니다. Flow를 실행하려면 Trigger가 하나 이상 필요합니다. 하나의 Flow에 여러 Trigger를 추가하면 API 호출, Webhook, 야간 Schedule로 한꺼번에 실행할 수 있습니다.

​
Trigger 종류

​
1. API 엔드포인트 Trigger

Flow를 POST 엔드포인트로 노출합니다. 서비스에서 호출하는 가장 흔한 방식입니다.
  • API 슬러그 엔드포인트 주소에 들어갈 이름입니다.
  • 엔드포인트 슬러그로 만들어진 POST 주소입니다. 인스펙터에서 복사합니다.
  • 본문 POST로 받을 JSON 필드입니다. 기본으로 input, threadId, userId, image, audio, document, tts, model을 지원하고, 파라미터 추가로 직접 파라미터를 추가할 수 있습니다.
  • 인증 다음 중에서 선택합니다.
    • 없음 인증 없이 오픈. 개발용 또는 다른 게이트웨이 뒤에서만 씁니다.
    • 헤더 토큰 서버가 생성한 토큰을 지정한 헤더(기본 Authorization)에 실어 호출합니다.
    헤더 이름은 자유롭게 바꿀 수 있습니다. 시크릿 관리는 아래 시크릿 관리를 참고하세요.
대화형 서비스를 만들 때 이 Trigger를 사용합니다. 턴마다 같은 threadId를 넘기면 같은 대화로 이어지고, userId로 사용자를 구분합니다.

​
2. 웹훅 Trigger

웹훅 Trigger를 켜면 Flow에 URL이 생깁니다. 해당 주소로 JSON을 POST하는 외부 서비스가 Flow를 실행시킬 수 있습니다.
  • 웹훅 슬러그 엔드포인트 주소에 들어갈 이름입니다.
  • 엔드포인트 슬러그로 만들어진 POST 주소입니다. 인스펙터에서 복사합니다.
  • 인증 다음 중에서 선택합니다.
    • 없음 인증 없이 오픈.
    • 헤더 토큰 (기본) 서버가 생성한 토큰을 지정한 헤더(기본 X-Webhook-Token)에 실어 호출합니다.
    • HMAC SHA-256 요청 본문을 시크릿으로 서명해 지정한 헤더(기본 X-Signature-256)로 보냅니다. GitHub·Stripe 등의 서명 웹훅에서 사용합니다.
    헤더 이름은 자유롭게 바꿀 수 있으니 보내는 서비스가 요구하는 이름에 맞추면 됩니다 (예: GitHub라면 X-Hub-Signature-256).
  • Body 매핑 외부 서비스마다 웹훅 body 구조가 다르므로, 수신 body의 어떤 필드를 어디에 쓸지 경로로 지정합니다. 첫 웹훅을 한 번 보낸 뒤 [새로 고침] 버튼을 누르면 최근 수신 body에 마지막으로 수신한 body가 필드 단위로 표시되고, 각 필드의 → 버튼으로 input·image·audio에 바로 매핑할 수 있습니다. 매핑하면 라벨 옆에 실제 수신 값이 미리보기로 표시됩니다.
    • 입력 필드 Agent 입력으로 쓸 필드 경로입니다. 비우면 body 전체가 입력으로 들어갑니다.
    • 이미지 경로 · 오디오 경로 이미지·음성으로 쓸 필드 경로입니다. 비우면 최상위 image·audio 필드를 사용합니다.
    • Thread ID 경로 · User ID 경로 대화와 사용자를 정할 필드 경로입니다. 비우면 X-Nora-Thread-Id·X-Nora-User-Id 헤더나 최상위 threadId·userId 필드를 사용합니다.

​
3. 스케줄 Trigger

Flow를 정해진 시각마다 돌립니다.
  • 프리셋 / 사용자 정의 cron 자주 쓰는 주기를 선택하거나 cron 표현식을 직접 씁니다.
  • 시간대 cron을 해석할 기준 시간대입니다.
  • 입력 실행마다 첫 Agent로 보낼 고정 입력입니다.
  • Thread ID · User ID 실행을 묶을 대화와 사용자입니다. 스케줄 실행의 메모리 스코프가 됩니다.
  • 음성 출력(TTS) 켜면 답변을 음성으로도 만듭니다.

​
시크릿 관리

인증에 쓰는 토큰·서명 키는 서버가 생성합니다. 직접 입력하지 않습니다.
  • 토큰은 [토큰 생성] 버튼으로 발급하며, 발급 직후 딱 한 번 화면에 표시됩니다. 이때 복사해 두세요. 이후에는 마지막 4자리만 노출됩니다.
  • [회전] 버튼을 누르면 확인 모달을 거쳐 새 토큰이 발급됩니다.
  • 인증을 없음 으로 바꾸면 시크릿이 삭제되고, 다시 켜면 새로 발급됩니다.
  • 시크릿 발급, 회전, 인증 없음으로 수정되는 사항은 바로 적용되지 않고, 배포하는 시점에 옛 토큰이 무효가 됩니다. 배포 순간부터는 옛 토큰을 쓰는 애플리케이션의 호출이 전부 실패합니다. 새 토큰을 미리 복사해 두었다가 준비가 완료된 후 Flow를 배포하세요.

​
여러 Trigger

Trigger마다 서로 다른 Agent로 와이어링할 수도 있고, 여러 Trigger를 한 Agent로 와이어링할 수도 있습니다. 한 Agent로 와이어링 시 실행 경로에 따라 서로 다른 모양의 입력이 그 Agent로 들어옵니다. 스케줄 실행이면 트리거에 적어둔 고정 입력이, 웹훅이면 Body 매핑으로 뽑은 필드 값이, API 호출이면 호출자가 보낸 input이 들어오는 식입니다. Agent의 프롬프트와 입력 스키마는 이 모든 모양을 처리할 수 있도록 작성해야 합니다. 흔한 해법은 페이로드에 "type": "webhook" 같은 구분 필드를 넣는 것입니다. Agent가 이 값을 보고 입력이 어느 경로로 들어왔는지 알 수 있습니다.