플로우 vs 단일 에이전트
플로우 목록
워크스페이스 > 플로우에서 생성된 모든 플로우를 확인할 수 있습니다.
플로우 목록
플로우 생성
1
새 플로우 만들기
워크스페이스 > 플로우에서 우측 상단의 ”+ 새 플로우” 버튼을 클릭합니다.
새 플로우 만들기 진입 후
2
노드 배치
왼쪽 노드 패널에서 원하는 노드를 캔버스로 드래그합니다.
모든 플로우는 반드시 시작 노드와 출력 노드를 포함해야 합니다.
패널에서 드래그된 노드는 사용자가 놓은 자리에 배치됩니다
3
노드 연결
노드의 출력 핸들(하단 점)을 드래그하여 다음 노드의 입력 핸들(상단 점)에 연결합니다.
데이터는 위에서 아래(Top → Bottom) 방향으로 흐릅니다.
핸들 위치: 상단(Top) = 입력, 하단(Bottom) = 출력입니다.
가드레일, 조건 등 분기 노드는 하단에 여러 출력 핸들을 가집니다.
4
노드 설정
노드를 클릭하면 오른쪽에 설정 패널이 나타납니다.
에이전트 노드라면 실행할 에이전트를 선택하고, 모델 노드라면 LLM 모델과 시스템/유저 프롬프트를 설정합니다.
에이전트 노드 설정
모델 노드 설정
5
유효성 검증 및 저장
상단 툴바에서 검증 버튼과 저장 및 생성 버튼은 별도로 존재합니다.
- 검증: 시작/출력 노드 누락, 연결되지 않은 노드, 순환 참조 등 문제를 검증합니다.
- 저장 및 생성: 현재 플로우를 저장합니다. 저장은 별도 동작이며, 자동으로 유효성 검증이 수행되지 않습니다.
AI로 플로우 생성
플로우 에디터 하단의 “AI 어시스턴트” 버튼(보라색 번개 아이콘)을 클릭하면, 대화형 AI 빌더가 열립니다. 자연어로 원하는 플로우를 설명하면 AI가 노드와 연결을 자동으로 생성합니다.대화형 빌드 흐름
AI 빌더는 즉시 생성하지 않고, 주요 결정 사항을 먼저 질문합니다:1
의도 입력
“고객 문의를 부서별로 분류하는 플로우 만들어줘”와 같이 원하는 플로우를 설명합니다.
2
AI 질문에 답변
AI가 가드레일 사용 여부, 라우팅 방식, 세부 옵션 등을 버튼 형태로 질문합니다. 원하는 옵션을 클릭하세요.예시:
- “가드레일을 사용할까요?” → [개인정보보호] [금칙어 차단] [사용 안함]
- “어떤 라우팅 방식을 사용할까요?” → [라우터] [조건] [직접 연결]
3
자동 생성
충분한 정보가 모이면 AI가 노드와 엣지를 자동으로 생성하여 캔버스에 배치합니다.
AI 빌더 특징
- 대화 히스토리 유지: 플로우에 대화 기록이 저장되어, 나중에 다시 열면 이어서 수정 가능
- 기존 플로우 편집: 이미 만들어진 플로우에서 AI를 열면 현재 구조를 인식하고 수정 제안
- 실시간 캔버스 반영: AI가 생성한 노드가 즉시 캔버스에 표시됨
- 패널 높이 조절: 상단 드래그 핸들로 패널 크기를 자유롭게 조절
노드 타입
에이전트 플로우는 총 10종의 노드를 4개 카테고리로 제공합니다.플로우 실행
채팅에서 실행
- 새 채팅을 시작합니다
- 모델 선택기에서 연결 타입 필터에 Flow가 표시됩니다. 이를 선택합니다
- 원하는 플로우를 선택한 후 메시지를 입력합니다
플로우는 모델 선택기에서 별도의 탭이 아닌, 연결 타입(connection type) 필터로 노출됩니다.
실행 흐름
실행 중에는 각 노드의 상태가 실시간으로 표시됩니다.유효성 검증
상단 툴바의 검증 버튼으로 수행할 수 있는 검증 항목입니다.AI 자동생성 빌더
플로우 편집기 화면 하단의 AI 채팅 패널에서 자연어로 대화하며 플로우를 자동 구성할 수 있습니다. 노드를 하나하나 배치하는 대신, AI에게 원하는 워크플로우를 설명하면 됩니다.사용 방법
1
채팅 패널 열기
플로우 편집기 하단의 AI 채팅 영역에서 모델을 선택합니다.
2
자연어로 워크플로우 설명
원하는 플로우를 자연어로 입력합니다.예시:
- “고객 문의를 분류한 뒤, 기술 질문은 기술팀 에이전트로, 일반 문의는 CS 에이전트로 분기해줘”
- “입력을 가드레일로 검증하고 통과하면 에이전트 A → 에이전트 B 순서로 처리해줘”
- “3개 에이전트를 병렬로 실행한 뒤 결과를 합쳐줘”
3
AI 응답 확인
AI가 플로우 구조를 생성하고 편집기에 자동으로 반영합니다. AI가 추가 질문을 할 수도 있으며, 버튼 형태의 선택지가 나타나면 클릭으로 응답합니다.
4
반복 수정
대화를 이어가며 노드 추가, 변경, 삭제를 요청할 수 있습니다.
- “라우터 노드를 조건으로 바꿔줘”
- “에이전트 C를 중간에 추가해줘”
- “가드레일 노드를 제거해줘”
AI 빌더는 플로우 쓰기 권한이 있는 사용자만 사용할 수 있습니다. 대화 이력은 플로우에 저장되어 다음 편집 시 이어서 대화할 수 있습니다.
원클릭 생성 vs 대화형 수정
내보내기 / 가져오기
내보내기와 가져오기는 플로우 편집기(FlowEditor) 상단 툴바에서 수행합니다.- 내보내기
- 가져오기
플로우 편집기 상단 툴바의 내보내기 버튼을 클릭하면 JSON 파일로 다운로드됩니다.
내보내기 파일에는 플로우 이름, 설명, 노드 구성, 연결 정보가 포함됩니다.
활용 사례
예시 1: 문서 분석 플로우
예시 1: 문서 분석 플로우
예시 2: 조건 분기 고객 지원
예시 2: 조건 분기 고객 지원
예시 3: 데이터 리포트 플로우
예시 3: 데이터 리포트 플로우
예시 4: 가드레일 적용 플로우
예시 4: 가드레일 적용 플로우
Continue로 설정하면 차단 정보를 데이터 변환 노드에서 가공하여 사용자에게 안내할 수 있습니다.접근 권한
플로우에도 다른 워크스페이스 리소스와 동일한 접근 제어가 적용됩니다.FAQ
플로우 메뉴가 보이지 않습니다
플로우 메뉴가 보이지 않습니다
에이전트 플로우는 두 가지 조건이 모두 충족되어야 워크스페이스에 표시됩니다:
- 개발자 모드(
developer_mode)가 활성화되어 있어야 합니다 agent_flow라이선스가 부여되어 있어야 합니다
플로우에서 사용할 수 있는 에이전트는?
플로우에서 사용할 수 있는 에이전트는?
워크스페이스에 등록된 모든 에이전트를 사용할 수 있습니다.
일반 모드, KBSphere(향상된 RAG), DBSphere(데이터베이스) 모드 모두 지원됩니다.
플로우 실행 중 오류가 발생하면?
플로우 실행 중 오류가 발생하면?
오류가 발생한 노드에서 실행이 멈추고 에러 메시지가 표시됩니다.
Error Handler 노드를 사용하면 오류 시 대체 경로를 설정할 수 있습니다.
노드 설정(리소스 선택, 파라미터)을 확인하고 다시 시도하세요.
하나의 플로우에 여러 에이전트를 연결할 수 있나요?
하나의 플로우에 여러 에이전트를 연결할 수 있나요?
네, 여러 에이전트를 순차적으로 연결하거나 조건/라우터 노드로 분기할 수 있습니다.
각 에이전트의 출력이 다음 에이전트의 입력으로 자동 전달됩니다.
플로우의 실행 순서는?
플로우의 실행 순서는?
시작 노드에서 시작하여 연결된 노드를 순서대로 따라갑니다.
조건 노드에서는 조건 평가 결과에 따라 True 또는 False 경로로 분기하고,
라우터 노드에서는 매칭되는 Route 경로로 분기합니다.
병합 노드에서는 여러 병렬 경로가 합류합니다.
플로우를 다른 환경으로 이동하려면?
플로우를 다른 환경으로 이동하려면?
플로우 편집기 상단 툴바의 내보내기 버튼으로 JSON 파일을 내보내고, 대상 환경의 편집기에서 가져오기 버튼으로 가져옵니다.
참조하는 에이전트, 모델, 가드레일이 대상 환경에도 존재해야 합니다.
다음 단계
에이전트 생성
플로우에서 사용할 에이전트를 구성합니다
가드레일 설정
플로우 내에서 안전한 응답을 위한 필터를 구성합니다