콘텐츠로 이동

w5w Docs

실행

워크플로우 실행¶

w5w는 두 가지 실행 모드를 제공합니다: 테스트 실행과 프로덕션 실행.

테스트 실행¶

개발 중에 워크플로우의 동작을 검증하는 모드입니다.

특징¶

항목	설명
실행 조건	에디터에서 테스트 실행 버튼 클릭
워크플로우 상태	비활성 상태에서도 실행 가능
입력 데이터	트리거의 테스트 데이터 사용
결과 확인	에디터에서 각 노드의 입력/출력을 실시간 확인

테스트 데이터 설정¶

트리거 노드의 테스트 탭에서 JSON 형태로 테스트 데이터를 입력합니다:

{
  "name": "테스트 사용자",
  "email": "test@example.com",
  "message": "테스트 메시지입니다."
}

실행 과정¶

테스트 실행 버튼을 클릭합니다.
트리거 테스트 데이터를 확인하고 실행을 클릭합니다.
각 노드가 순서대로 실행됩니다.
AI 에이전트 노드는 실시간 스트리밍으로 토큰 생성 과정이 표시됩니다.
완료 후 각 노드를 클릭하여 결과를 확인합니다.

주의

테스트 실행 시에도 스킬(이메일 전송, DB 쓰기 등)은 실제로 동작합니다. 테스트용 데이터를 사용하세요.

노드별 결과 확인¶

실행 완료 후 각 노드를 클릭하면 실행 결과 모달이 열립니다.

항목	설명
상태	성공(success) / 실패(error)
text_content	노드의 텍스트 출력
data_content	구조화된 데이터 출력 (JSON)
실행 시간	노드 처리에 소요된 시간

프로덕션 실행¶

워크플로우를 활성화하면 트리거 조건에 따라 자동으로 실행됩니다.

트리거별 실행 방식¶

트리거	실행 조건	입력 데이터
수동	API 호출 또는 대시보드에서 수동 실행	API 요청 Body
스케줄	Cron 표현식에 따라 주기적 실행	없음 (빈 객체)
웹훅	외부 시스템이 웹훅 URL로 POST 요청	POST Body (JSON)
앱 이벤트	Gmail 새 메일, Telegram 메시지 등	이벤트 데이터

실시간 스트리밍 (SSE)¶

테스트 실행 시 Server-Sent Events(SSE)를 통해 실행 과정을 실시간으로 확인합니다.

이벤트	설명
노드 시작	각 노드의 실행 시작 알림
토큰 스트리밍	AI 에이전트의 텍스트 생성 과정 실시간 표시
스킬 실행	스킬 호출 및 결과 수신
노드 완료	각 노드의 실행 완료 + 결과
워크플로우 종료	전체 워크플로우 실행 완료

실행 로그¶

모든 실행 결과는 실행 로그에 저장됩니다.

실행 로그 목록¶

프로젝트 대시보드 또는 워크플로우 상세에서 실행 로그를 확인합니다.

항목	설명
실행 ID	각 실행의 고유 식별자
상태	`success`, `failed`, `running`, `cancelled`
시작/종료 시간	실행 시간 정보
트리거 타입	실행을 발생시킨 트리거 종류

실행 상세¶

실행을 클릭하면 노드별 상세 결과를 볼 수 있습니다.

실행 상태¶

상태	설명
`running`	실행 중
`success`	모든 노드가 정상 완료
`failed`	하나 이상의 노드에서 오류 발생
`cancelled`	사용자가 실행을 중단

오류 처리

노드 실행 중 오류가 발생하면 해당 노드에서 실행이 중단되고, 후속 노드는 실행되지 않습니다. 실행 로그에서 오류 내용을 확인하고 수정하세요.

다음 단계¶

변수 시스템 — 노드 간 데이터 전달 방법
트리거 노드 — 트리거 타입별 상세 설정