노드¶

노드(Node)는 워크플로우의 개별 작업 단위입니다. w5w는 9가지 노드 타입을 제공하며, 각 노드는 고유한 역할을 수행합니다.

노드 타입 요약¶

노드	설명	주요 용도	상세
트리거	워크플로우의 시작점	수동/스케줄/웹훅/앱 이벤트로 실행
AI 에이전트	LLM 기반 AI 실행	텍스트 생성, 판단, 분석, 스킬 활용
스킬	단일 기능 실행	이메일 전송, DB 조회, HTTP 요청
조건	IF/ELSE 분기	데이터 값에 따라 경로 분기	-
텍스트 분류	AI 텍스트 분류	입력 텍스트를 카테고리로 분류	-
반복	배열 순회 실행	여러 항목에 대해 동일 작업 반복	-
파일 검색	지식 베이스 검색 (RAG)	업로드 문서에서 관련 정보 검색	-
응답	HTTP 응답 정의	웹훅 트리거의 응답 본문 설정	-
메모	워크플로우 메모	설명/주석 용도 (실행 안 됨)	-

노드 공통 구조¶

출력 형식¶

모든 노드(메모 제외)는 다음 공통 출력 구조를 가집니다:

{
  "node_type": "agent",
  "status": "success",
  "text_content": "노드의 텍스트 출력",
  "data_content": {
    "key": "구조화된 데이터"
  }
}

필드	설명
`node_type`	노드 타입 식별자
`status`	실행 결과 (`success` 또는 `error`)
`text_content`	주요 텍스트 출력
`data_content`	구조화된 데이터 출력 (JSON)

핸들(Handle)¶

입력 핸들: 노드 상단에 위치. 이전 노드의 출력을 수신
출력 핸들: 노드 하단에 위치. 다음 노드로 데이터 전달
조건/분류 노드는 여러 출력 핸들을 가짐 (분기별 1개)

노드 타입별 상세¶

조건 노드 (Condition)¶

데이터 값에 따라 True/False 두 경로로 분기합니다.

설정:

항목	설명
조건식	변수 비교 또는 표현식
True 경로	조건이 참일 때 실행할 노드
False 경로	조건이 거짓일 때 실행할 노드

예시 조건식:

{{ $('trigger').data_content.amount }} > 100000
{{ $('agent_1').data_content.category }} == "urgent"

텍스트 분류 노드 (Text Classifier)¶

AI가 입력 텍스트를 사전 정의된 카테고리로 분류합니다.

설정:

항목	설명
입력 텍스트	분류할 텍스트 (변수 참조 가능)
카테고리	분류할 카테고리 목록 (예: 긴급, 일반, 스팸)
LLM 모델	분류에 사용할 AI 모델

활용 예시: 이메일 분류, 고객 문의 카테고리 분류, 감성 분석

반복 노드 (Iterator)¶

배열 데이터를 순회하며 각 항목에 대해 하위 노드를 반복 실행합니다.

설정:

항목	설명
입력 배열	순회할 배열 데이터 (변수 참조)
반복 본체	각 항목에 대해 실행할 노드

활용 예시: DB에서 조회한 여러 레코드에 각각 이메일 전송, 파일 목록 처리

파일 검색 노드 (File Search / RAG)¶

업로드된 지식 베이스에서 질의와 관련된 문서를 검색합니다.

설정:

항목	설명
검색 질의	검색할 텍스트 (변수 참조 가능)
지식 베이스	검색 대상 문서 셋

활용 예시: 고객 문의에 맞는 FAQ 검색, 사내 문서에서 관련 정보 추출

응답 노드 (Response)¶

웹훅 트리거의 HTTP 응답을 정의합니다.

설정:

항목	설명
응답 본문	HTTP 응답으로 반환할 내용 (변수 참조 가능)
상태 코드	HTTP 상태 코드 (기본 200)

활용 예시: 웹훅 호출에 대한 처리 결과 반환, API 엔드포인트 구성

메모 노드 (Memo)¶

워크플로우에 설명/주석을 남기는 노드입니다. 실행에 영향을 주지 않습니다.

활용 예시: 복잡한 워크플로우에 설명 추가, 팀 협업 시 메모

노드¶

노드 타입 요약¶

노드 공통 구조¶

출력 형식¶

핸들(Handle)¶

노드 타입별 상세¶

조건 노드 (Condition)¶

텍스트 분류 노드 (Text Classifier)¶

반복 노드 (Iterator)¶

파일 검색 노드 (File Search / RAG)¶

응답 노드 (Response)¶

메모 노드 (Memo)¶

노드 조합 예시¶

고객 문의 자동 처리¶

정기 보고서 자동 생성¶

주문 처리 자동화¶

다음 단계¶