조건·라우터·가드레일 노드의 분기 중 하나가 루프 밖으로 나가면 안전한 루프로 간주해 경고만 표시합니다. 밖으로 나가는 분기가 하나도 없을 때만 오류입니다.실행은 슈퍼스텝 상한(기본 50)으로 제한되며, 탈출 조건은 조건 노드에서 {Label.loop_count}를 보다 큼과 조합해 겁니다.
툴바의 테스트 실행을 누르면 캔버스 아래에 테스트 드로어가 열립니다. 저장하지 않은 현재 캔버스 그대로 실행되므로, 게시 전에 안전하게 확인할 수 있습니다.드로어는 세 탭으로 구성됩니다.
탭
내용
테스트 실행
테스트 입력을 넣고 실행. 노드별 진행 상황과 최종 출력을 봅니다
실행 이력
이 플로우의 실행 이력 (소유자·관리자는 전체, 공유 사용자는 자신의 실행만)
버전
게시 이력과 복원
실행 중에는 노드별 상태(실행 중 / 완료 / 오류)가 캔버스와 스텝 목록에 동시에 표시되고, 스텝을 클릭하면 그 노드의 출력 미리보기가 펼쳐집니다. KBSphere 에이전트를 쓰면 검색된 출처 개수도 함께 표시됩니다.드로어 위쪽 경계를 드래그하면 높이를 조절할 수 있습니다.
플로우에 승인 게이트가 있으면 실행이 그 지점에서 멈추고 승인 필요 카드가 뜹니다. 메모를 남기고 승인 또는 거부를 누르면 그 지점부터 실행이 이어집니다.
새 채팅을 시작합니다
모델 선택기에서 연결 타입 필터에 플로우가 표시됩니다. 이를 선택합니다
원하는 플로우를 선택한 후 메시지를 입력합니다
플로우는 모델 선택기에서 별도의 탭이 아닌, 연결 타입(connection type) 필터로 노출됩니다. 이 필터는 사용 가능한 플로우가 하나라도 있을 때만 나타납니다.
채팅 실행은 대화 단위로 상태가 이어지므로, 상태 지속 토글과 무관하게 같은 대화 안에서는 문맥이 유지됩니다.
편집 화면 좌측 패널 아래쪽에 웹훅 엔드포인트가 표시됩니다. URL 복사를 누르면 전체 주소가 복사됩니다.
POST /api/v1/agent-flows/{플로우 ID}/invoke
요청 필드
설명
input
플로우에 전달할 입력 (필수)
stream
true면 SSE 스트림, 기본 false
session_id
대화 세션 키. 주면 세션별 상태가 유지됩니다
기본 응답은 flow_id · session_id · output 을 담은 JSON입니다.
API 키(Bearer sk-...)로도 호출할 수 있어 외부 시스템 연동에 쓸 수 있습니다. 호출자는 해당 플로우에 읽기 권한이 있어야 하고, 비활성 플로우는 호출이 거부됩니다.
플로우에도 다른 워크스페이스 리소스와 동일한 접근 제어가 적용됩니다.플로우는 생성할 때도 편집할 때도 화면 상단 툴바의 자물쇠 아이콘 [접근] 버튼으로 접근 제어 모달을 엽니다 — 다른 리소스처럼 화면 안에 인라인 권한 영역이 있지 않습니다.모달의 접근 권한 셀렉터에서 공개 범위를 고릅니다.
옵션
설명
전체 사용자
모든 사용자가 읽기 가능
지정된 그룹만
접근 가능한 그룹에 올린 그룹의 구성원만 사용 가능
그룹 표에 올라간 그룹은 그 자체로 읽기 권한이며, 편집 가능 열을 체크해야 쓰기까지 허용됩니다.
새로 만든 플로우는 기본값이 전체 사용자 읽기 공개입니다. 채널과 함께 워크스페이스에서 몇 안 되는 예외입니다 — 범위를 좁히려면 만든 뒤 접근 권한을 지정된 그룹만으로 직접 바꿔야 합니다.
전체 사용자 옵션은 관리자에게만 표시됩니다. 일반 사용자에게는 지정된 그룹만 하나만 보입니다.
접근 제어 모달에서는 반드시 적용을 누르세요. 그룹을 고르기만 하고 모달을 닫으면 변경이 반영되지 않습니다. 적용 후 화면의 저장 및 생성(생성) 또는 초안 저장 · 게시(편집)까지 눌러야 최종 저장됩니다.
조직 단위는 이 화면에서 지정할 수 없습니다. 조직 단위로 열어주려면 관리자가 그룹에 조직 단위를 연결해야 합니다 — 그러면 그 조직 소속 사용자가 해당 그룹의 구성원으로 취급됩니다. 자세한 내용은 공유 및 권한을 참고하세요.
플로우는 아직 미리보기 기능이라, 라이선스와 권한이 있어도 일반 운영 주소에서는 메뉴가 나오지 않습니다. 관리자에게 확인을 요청하세요.
분명히 저장했는데 채팅에서는 예전대로 동작합니다
편집 화면의 초안 저장은 라이브 플로우를 바꾸지 않습니다. 게시를 눌러야 채팅과 웹훅에 반영됩니다.캔버스 위에 “초안 편집 중” 배너가 떠 있거나 게시 버튼에 주황 점이 붙어 있다면 아직 미게시 상태입니다.
플로우에서 사용할 수 있는 에이전트는?
워크스페이스에 등록된 모든 에이전트를 사용할 수 있습니다.
일반 모드, KBSphere(향상된 RAG), DBSphere(데이터베이스) 모드 모두 지원됩니다.
플로우 실행 중 오류가 발생하면?
기본 동작은 오류가 발생한 노드에서 실행이 멈추고 오류 메시지가 표시되는 것입니다.노드별로 다르게 처리하려면 설정 패널 맨 아래 오류 처리 / 재시도 섹션에서 오류 발생 시 동작(플로우 중단 / 건너뛰고 계속 / 기본값 사용)과 최대 재시도, 재시도 간격, 타임아웃을 지정하세요. 이 섹션은 시작 노드를 제외한 모든 노드에 있습니다.
별도의 Error Handler 노드는 존재하지 않습니다.
같은 노드를 반복 실행할 수 있나요?
두 가지 방법이 있습니다.
반복 노드 — 여러 항목을 한 번에 병렬 처리할 때 (동시 실행 수 1~8)
루프 연결 — 조건에 따라 이전 노드로 되돌아가는 순환 경로. 정식 지원되며, 조건·라우터·가드레일 분기 중 하나가 루프 밖으로 나가야 합니다
루프 실행은 슈퍼스텝 상한(기본 50)으로 제한되며, {Label.loop_count}를 보다 큼 조건과 조합해 탈출 조건을 겁니다.
하나의 플로우에 여러 에이전트를 연결할 수 있나요?
네, 여러 에이전트를 순차적으로 연결하거나 조건·라우터 노드로 분기할 수 있습니다.
각 에이전트의 출력이 다음 에이전트의 입력으로 자동 전달됩니다.하나의 모델이 여러 에이전트에게 작업을 나눠 맡기고 결과를 종합하게 하려면 슈퍼바이저 노드를 사용하세요.
플로우의 실행 순서는?
시작 노드에서 시작하여 연결된 노드를 순서대로 따라갑니다.
조건 노드에서는 평가 결과에 따라 참 / 거짓 경로로 분기하고, 라우터 노드에서는 매칭되는 라우트로 분기합니다.
병합 노드에서는 여러 병렬 경로가 합류합니다.시작 노드가 없으면 첫 번째 노드가, 출력 노드가 없으면 말단 노드가 자동으로 진입점·종료점이 됩니다.
이전 버전으로 되돌리려면?
테스트 드로어의 버전 탭에서 게시 이력을 확인하고 복원을 누릅니다.
복원은 그 버전을 초안으로 되돌리는 것이므로, 캔버스에서 확인한 뒤 게시를 눌러야 롤백이 확정됩니다.보관되는 스냅샷은 최대 20개입니다.
플로우를 다른 환경으로 이동하려면?
편집기 상단 툴바의 내보내기로 JSON 파일을 받고, 대상 환경의 편집기에서 가져오기로 올립니다.
참조하는 에이전트, 모델, 가드레일이 대상 환경에도 존재해야 하므로 가져온 뒤 검증으로 확인하세요.
