노드 타입 상세

워크플로우를 구성하는 각 노드의 설정과 활용법을 설명합니다.

에디터 좌측의 노드 팔레트에서 노드를 추가하면 캔버스에 배치되고, 노드를 클릭하면 우측 설정 패널이 열립니다.

워크플로우 에디터 — 노드 팔레트와 설정 패널

시작 노드 (start)

워크플로우의 입력을 정의하는 시작점입니다. 모든 워크플로우는 반드시 하나의 시작 노드를 가져야 합니다.

  • 입력 변수 추가 — 이름·타입(텍스트/숫자/불린/파일)을 지정해 여러 입력을 정의할 수 있습니다.
  • 후속 노드는 {{start.question}} 처럼 정의한 이름으로 입력을 참조합니다.
  • 파일 타입은 아직 실행 시점 입력으로 지원되지 않습니다.

LLM 노드 (llm)

LLM 모델을 호출합니다.

설정설명
모델호출할 LLM 선택
시스템 프롬프트역할·제약 등의 시스템 지시
사용자 프롬프트실제 처리할 내용. 변수 삽입 가능
창의성 (온도)낮을수록 결정적, 높을수록 다양한 출력
웹검색 사용켜면 답변 전 웹 검색으로 자료 수집
검색어 / 가져올 결과 수웹검색 사용 시 검색어(비우면 프롬프트 기반 자동)와 결과 수

LLM 노드 설정 — 시스템/사용자 프롬프트와 변수 삽입

예시:

사용자 프롬프트:
사용자 질문: {{start.question}}

위 질문에 친절하게 답변해 줘.

출력: {{llm_1.text}}

도구 노드 (tool)

OpenAPI 또는 MCP 도구를 호출합니다.

  • 사용할 도구 선택
  • 도구가 요구하는 파라미터에 변수 매핑
  • 결과는 {{tool_1.result}} 로 후속 노드에 전달

지식검색 노드 (knowledge_retrieval)

지식 베이스에서 문서를 검색합니다 (RAG).

지식베이스에서 문서 검색

  • 검색할 지식 베이스 선택
  • 검색 쿼리로 변수 사용 (예: {{start.question}})
  • 가져올 문서 수검색 방식 (하이브리드 / 벡터) 지정
  • 검색 결과는 {{kb_1.result}} 로 전달되며, 후속 LLM 노드의 컨텍스트로 활용

에이전트 노드 (agent)

저장된 챗봇을 하나의 처리 단계로 호출합니다. 챗봇에 설정된 프롬프트·도구·지식 베이스가 그대로 적용됩니다.

  • 호출할 챗봇 선택, 입력 메시지 매핑
  • 출력: {{agent_1.output}}

웹검색 노드 (web_search)

웹에서 자료를 수집합니다. LLM 호출 없이 검색 결과만 필요할 때 사용합니다.

  • 검색 방식 — 웹 검색 / 뉴스 검색 / 트렌드 조회
  • 검색 엔진 — 자유 입력 (비워두면 google. 예: bing, duckduckgo, hackernews, github)
  • 기간(시간 범위) · 가져올 결과 수 지정
  • 출력: {{web_1.results}} (결과 목록), {{web_1.text}} (하나로 합쳐진 텍스트)

질문분류기 노드 (question_classifier)

LLM으로 사용자 질문을 분류해 라우팅합니다.

질문 분류 → 라우팅

  • 분류용 모델 — 분류에 사용할 LLM
  • 케이스 추가 — 분류 항목별 이름 입력
  • 어떤 케이스에도 해당하지 않으면 첫 번째 분류로 이동합니다.
  • 선택된 분류는 {{classifier_1.class_id}} 로 참조 가능

예시 분류 케이스:

  • 결제/환불 → "너는 결제/환불 전문가야..."
  • 기술지원 → "너는 기술지원 전문가야..."
  • 일반 → "너는 친절한 도우미야..."

조건분기 노드 (if_else)

조건을 비교해 분기합니다.

조건 비교로 분기

  • 모두 만족 (AND) — 모든 조건이 참일 때
  • 하나 이상 (OR) — 하나라도 참일 때
  • 각 조건은 변수 + 비교 연산자 + 값으로 구성 (같음/다름/포함/시작with/끝with/비교 등 다양한 연산자 지원)
  • 기본 분기 id — 조건이 거짓일 때 이동할 경로

예시:

조건: {{classifier_1.class_id}} == "결제"
→ true: 결제 분기로 이동
→ false: 기본 분기로 이동

반복 노드 (iteration)

배열의 각 아이템에 대해 본문을 반복 실행합니다.

배열의 각 아이템마다 본문 실행

  • 반복 대상 배열을 변수로 지정 (예: {{start.items}})
  • 매 회차에서 수집할 값 을 지정하면 반복 결과가 배열로 모입니다.
  • 본문 안에서 사용 가능한 변수:
    • {{iteration_1.current}} — 현재 아이템
    • {{iteration_1.index}} — 현재 인덱스 (0, 1, 2, ...)
  • 본문에는 LLM · 도구 · 지식검색 노드만 배치할 수 있습니다.

루프 노드 (loop)

조건을 만족할 때까지 본문을 반복 실행합니다. (배열 순회는 반복(iteration) 노드를 사용하세요.)

조건 만족까지 본문 반복

  • 종료 조건 — 변수/값을 지정하고, 참으로 평가되면 반복을 멈춥니다.
  • 최대 반복 횟수 — 기본 10회. 안전장치로 초과 시 강제 종료됩니다.
  • 매 회차에서 수집할 값 을 지정할 수 있습니다.
  • 본문 안에서 {{loop_1.index}} 등으로 현재 상태를 참조합니다.
  • 본문에는 LLM · 도구 · 지식검색 노드만 배치할 수 있습니다.

노트 노드 (note)

플랫폼의 노트 시스템에 접근합니다. 실행에 따라 노트를 만들고 읽고 고칠 수 있습니다.

  • 동작: 노트 생성 / 조회 / 수정
  • 대상 노트와 폴더(경로) 지정, 태그 설정
  • 수정 시 덮어쓰기 / 이어쓰기 선택
  • 파일 이름이나 경로에 날짜 변수(예: {{sys.date:%Y-%m}})를 사용할 수 있습니다.
  • 출력: {{note_1.note_id}}, {{note_1.content}}

메모 노드 (memo)

실행에 영향을 주지 않는 설명 메모입니다.

메모는 실행에 영향을 주지 않습니다

설계 목적·주의사항·TODO 등을 자유롭게 적어주세요. (노트 시스템에 기록을 남기는 것은 노트(note) 노드입니다.)

출력 노드 (output)

최종 결과를 출력하는 종료점입니다.

최종 결과 출력

최종 답변 내용을 변수로 구성해 지정합니다.

다음 단계