모든 노드는 좌측이 입력, 우측이 출력입니다. 조건·라우터·가드레일·승인 게이트처럼 갈라지는 노드는 우측에 출력 핸들을 여러 개 세로로 쌓아 표시합니다.
일반
시작
플로우 시작점. 사용자 입력을
input State 키로 받아 다음 노드로 전달합니다.출력
플로우 종료점. 이전 노드의 결과를 사용자에게 반환합니다. 작업 유형으로 그대로 전달 / 응답 / 오류를 고릅니다.
에이전트
에이전트
등록된 에이전트를 연결된 리소스와 함께 실행합니다. KBSphere(향상된 RAG) / DBSphere(데이터베이스) 모드 에이전트도 지원.
모델
에이전트 없이 LLM 모델을 직접 호출하는 가벼운 실행. 요약·번역·분류에 적합.
슈퍼바이저
여러 워커 에이전트를 조율합니다. 슈퍼바이저 모델이 라운드마다 작업을 위임하고 결과를 검토해 최종 답변을 구성합니다.
로직 & 데이터
조건
참/거짓 분기. 11종 조건 유형 지원.
라우터
N-way 라우팅. 규칙 기반 또는 LLM 기반으로 여러 라우트 중 하나를 고릅니다.
병합
병렬 경로의 결과를 하나로 취합. concat / json / template 3종 모드.
데이터 변환
Jinja2 템플릿으로 State 값을 조합해 새 텍스트를 만듭니다.
반복
입력을 항목 단위로 쪼개 병렬로 처리합니다. 템플릿 렌더링 또는 항목별 LLM 호출.
서브플로우
다른 플로우를 하위 단계로 실행하고 그 최종 출력을 이 노드의 출력으로 삼습니다.
제어 & 안전
승인 게이트
사람의 승인을 기다립니다. 승인/거부 결과에 따라 분기하는 Human-in-the-loop 게이트.
가드레일
가드레일을 적용해 통과 / 차단으로 분기하는 안전 필터.
노드 상세 설정
모든 노드의 설정 패널 맨 위에는 레이블이 있습니다. 캔버스에 표시되는 이름이자, 다른 노드에서 이 노드의 출력을 참조할 때 쓰는 이름입니다 ({레이블.key}). 레이블을 바꾸면 그 노드를 가리키던 참조 표기도 함께 바뀌므로, 이미 참조를 걸어둔 뒤 이름을 바꿨다면 참조 쪽도 확인하세요.
시작 노드
시작 노드
플로우 시작점. 사용자 메시지가
input State 키로 전달됩니다.설정 패널에는 사용 가능한 State 키 목록이 표시됩니다. 이 플로우의 다른 노드들이 만들어내는 State 키를 자동으로 수집해 보여주는 읽기 전용 참조이며, 각 항목의 키 이름·출처 노드·타입을 확인할 수 있습니다.시작 노드에는 변수를 직접 정의하는 입력란이 없습니다. 후속 노드에서 참조할 값은 각 노드가 만들어내는 State 키(
{Label.key})로 넘깁니다.시작 노드는 유일하게 “오류 처리 / 재시도” 설정이 없는 노드입니다.
출력 노드
출력 노드
플로우 종료점. 이전 노드의 결과를 사용자에게 반환합니다.
작업 유형별 동작:
응답 유형에서는 최종 응답 프롬프트와 응답 생성 모델을 추가로 지정합니다. 프롬프트에서
{'{{ input }}'}과 State 키를 참조할 수 있고, 패널의 사용 가능한 State 키 칩을 클릭하면 커서 위치에 삽입됩니다.오류 유형에서는 오류 메시지 템플릿을 지정하며 {'{{ input }}'}, {'{{ error }}'}를 쓸 수 있습니다.UI 라벨은 “출력” 으로 표시됩니다. 내부 타입명은
flowOutput.에이전트 노드
에이전트 노드
등록된 에이전트를 실행합니다. KBSphere / DBSphere 에이전트도 지원.
- KBSphere 에이전트 사용 시 검색된 문서 출처가 함께 반환됩니다
- DBSphere 에이전트 사용 시 SQL 실행 결과가 포함됩니다
모델 노드
모델 노드
에이전트 없이 LLM 모델을 직접 호출합니다.
구조화 출력 (JSON) 을 체크하면 출력 필드를 필드명 · 타입 · 설명으로 정의할 수 있고, 타입은
string, number, boolean, array 중에서 고릅니다. 체크하지 않으면 일반 텍스트 응답입니다.슈퍼바이저 노드
슈퍼바이저 노드
하나의 슈퍼바이저 모델이 여러 워커 에이전트에게 작업을 나눠 맡기고 결과를 종합합니다.
워커 행마다 에이전트를 고르고, 필요하면 설명을 덧붙입니다. 설명을 비우면 해당 에이전트 자신의 설명이 사용됩니다 — 이 설명이 슈퍼바이저가 “누구에게 맡길지” 판단하는 근거이므로, 에이전트 이름만으로 역할이 드러나지 않으면 채우는 편이 좋습니다.동작: 슈퍼바이저 모델이 라운드마다 워커에게 작업을 위임하고, 결과를 검토한 뒤 최종 답변을 구성합니다.
조건 노드
조건 노드
조건에 따라 플로우를 분기합니다. 우측에 참과 거짓 두 개의 출력 핸들을 가집니다.
지원 조건 유형 (11종):
라우터 노드
라우터 노드
다중 경로 라우팅. 라우트를 정의하고 각 라우트마다 우측 출력 핸들이 생깁니다.
규칙 기반 라우팅의 라우트별 조건은 조건 노드와 동일한 11종을 지원합니다.
병합 노드
병합 노드
병렬로 처리된 여러 출력을 하나로 결합합니다.
모드별 동작:
데이터 변환 노드
데이터 변환 노드
Jinja2 템플릿으로 State 값을 조합해 새 텍스트를 만듭니다.
템플릿에서 쓸 수 있는 것:
{'{{ input }}'}— 현재 입력{'{{ Label_key }}'}— State 키. 점과 공백은 밑줄로 바뀝니다 (요약 노드.response→{'{{ 요약_노드_response }}'})
이전 가이드에 있던 Extract Field / Format Text 모드 선택, Output Key, Advanced Settings의 Jinja2 토글은 현재 제품에 없습니다. 데이터 변환 노드는 Jinja2 템플릿 하나로 통합됐습니다.
반복 노드
반복 노드
입력을 항목 단위로 쪼개 각 항목을 병렬로 처리합니다.
입력은 JSON 배열 또는 줄바꿈으로 구분된 목록으로 해석됩니다.템플릿 모드 — 항목 템플릿에
{'{{ item }}'}(현재 항목), {'{{ index }}'}(항목 번호), {'{{ input }}'}(원본 입력)을 씁니다.LLM 모드 — 모델(필수)과 사용자 프롬프트를 지정하고, 프롬프트에서 {item}, {index}, {input}을 참조합니다. 최대 토큰도 지정할 수 있습니다.서브플로우 노드
서브플로우 노드
다른 플로우를 하위 단계로 실행하고, 그 최종 출력을 이 노드의 출력으로 삼습니다.
선택 목록에는 현재 플로우를 제외한 나머지가 표시되며, 다른 플로우가 하나도 없으면 “선택할 수 있는 다른 플로우가 없습니다”로 표시됩니다.
승인 게이트 노드
승인 게이트 노드
사람이 승인할 때까지 플로우를 멈춥니다. 우측에 승인(위) / 거부(아래) 두 개의 출력 핸들을 가집니다.
동작: 플로우가 이 노드에서 멈추고 승인 요청이 뜹니다. 승인하면 승인 브랜치로 계속 진행하고, 거부하면 설정에 따라 플로우를 중단하거나 거부 브랜치로 진행합니다. 승인·거부 시 메모를 남길 수 있습니다.테스트 실행 중에는 테스트 드로어에 승인 필요 카드가 나타나며, 여기서 바로 승인 / 거부를 누르면 그 지점부터 실행이 이어집니다.
가드레일 노드
가드레일 노드
가드레일을 적용해 입력을 검증합니다. 우측에 통과(위) / 차단(아래) 두 개의 출력 핸들을 가집니다.
차단 브랜치로 넘어간 경우 State에
guardrail_type(차단 유형)과 guardrail_reason(차단 사유)이 포함됩니다.공통 설정 — 오류 처리 / 재시도
시작 노드를 제외한 모든 노드는 설정 패널 맨 아래에 접이식 오류 처리 / 재시도 섹션을 가집니다.이전 가이드가 안내하던 Error Handler 노드는 존재하지 않습니다. 오류 시 대체 경로는 이 공통 섹션에서 노드별로 지정합니다.
팔레트에 없는 노드
다음 타입은 러너와 검증기가 인식하지만 노드 팔레트에서 직접 추가할 수는 없습니다.이전 가이드가 “곧 활성화될 예정”이라며 나열한 Aggregator · Human Input · Error Handler · Notification 노드는 제품에 존재하지 않습니다. 같은 목록에 있던 서브플로우는 이미 팔레트에 정식 노출돼 있습니다.
노드 간 데이터 흐름 (State)
플로우는 공유 State 객체로 노드 간 데이터를 주고받습니다.
참조 표기는 위치에 따라 두 가지입니다.