상단 툴바의 검증 버튼으로 점검합니다. 오류가 있으면 해당 노드가 캔버스에서 빨간 링으로 표시됩니다.
오류 — 고쳐야 실행됩니다
검증 항목
설명
리소스 미선택
에이전트 / 모델 / 가드레일 / 지식베이스 / 용어집 노드에 리소스 미지정
슈퍼바이저 설정 누락
슈퍼바이저 모델 미선택 또는 워커 0개
서브플로우 설정 누락
실행할 플로우 미선택, 또는 자기 자신을 참조
반복 노드 모델 누락
LLM 모드인데 모델 미선택
끊어진 연결
삭제된 노드를 가리키는 잔여 연결선
지원하지 않는 노드 유형
빌더가 다루지 않는 타입 (가져오기한 레거시 플로우 등)
탈출 없는 루프
순환 경로에 밖으로 나가는 조건 분기가 없음
경고 — 실행은 됩니다
검증 항목
설명
시작 노드 없음
첫 번째 노드가 자동으로 진입점이 됩니다
출력 노드 없음
말단 노드가 자동으로 플로우 끝에 연결됩니다
연결 안 된 노드
어떤 노드와도 연결되지 않은 노드 (노드가 1개뿐인 플로우는 정상)
루프 감지
순환 경로가 있음
시작 / 출력 노드가 없어도 오류가 아닙니다. 암묵적 진입·종료가 지원되므로 경고로만 표시됩니다. 다만 의도를 분명히 하려면 두 노드를 명시하는 편이 좋습니다.
루프는 정식 지원됩니다
조건·라우터·가드레일 노드의 분기 중 하나가 루프 밖으로 나가면 안전한 루프로 간주해 경고만 표시합니다. 밖으로 나가는 분기가 하나도 없을 때만 오류입니다.실행은 슈퍼스텝 상한(기본 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-...)로도 호출할 수 있어 외부 시스템 연동에 쓸 수 있습니다. 호출자는 해당 플로우에 읽기 권한이 있어야 하고, 비활성 플로우는 호출이 거부됩니다.
상태 지속
편집 화면 좌측의 상태 지속 토글은 실행 간 대화 상태를 유지할지 정합니다 (신규 플로우 기본 켜짐).
채팅 실행 — 대화(chat) 단위로 자동 유지되므로 토글과 무관합니다
웹훅·임베드·예약 작업 등 비채팅 실행 — 이 토글이 켜져 있고 session_id를 넘겨야 세션별 상태가 이어집니다
AI로 플로우 만들기
편집기 우측 하단의 보라색 AI 어시스턴트 버튼을 누르면 대화형 빌더가 열립니다. 자연어로 원하는 플로우를 설명하면 AI가 노드와 연결을 생성해 캔버스에 바로 반영합니다.
1
모델 선택
패널 헤더의 셀렉터에서 빌더가 사용할 모델을 고릅니다.
2
의도 입력
“고객 문의를 부서별로 분류하는 플로우 만들어줘”처럼 원하는 플로우를 설명합니다.
처음 열면 예시 제안이 칩으로 떠 있으니 클릭해 바로 시작해도 됩니다.
3
AI 질문에 답변
AI가 가드레일 사용 여부, 라우팅 방식 등을 버튼 형태로 되묻습니다. 원하는 옵션을 클릭하세요.예시:
“가드레일을 사용할까요?” → [개인정보보호][금칙어 차단][사용 안함]
“어떤 라우팅 방식을 사용할까요?” → [라우터][조건][직접 연결]
4
생성 및 반복 수정
충분한 정보가 모이면 노드와 연결이 캔버스에 배치됩니다. 이어서 대화하며 수정할 수 있습니다.
“라우터 노드를 조건으로 바꿔줘”
“에이전트 C를 중간에 추가해줘”
“가드레일 노드를 제거해줘”
처음부터 구체적으로 요청하면 되묻지 않고 바로 생성됩니다. 예: “PII 가드레일 → 감정 분석 라우터 → 긍정/부정별 에이전트로 분기하는 플로우 만들어줘”
AI 빌더 특징
대화 히스토리 유지 — 대화 기록이 플로우에 저장되어 나중에 다시 열면 이어서 수정 가능
기존 플로우 편집 — 이미 만들어진 플로우에서 열면 현재 구조를 인식하고 수정 제안
실시간 캔버스 반영 — 생성된 노드가 즉시 캔버스에 표시됨
패널 높이 조절 — 상단 드래그 핸들로 크기 조절
AI 어시스턴트 버튼은 플로우 쓰기 권한이 있는 사용자에게만 표시됩니다.
AI가 만든 플로우도 수동으로 자유롭게 고칠 수 있습니다. AI로 뼈대를 잡고 세부 설정은 노드별로 직접 조정하는 것이 효과적입니다. 생성 결과는 게시하기 전까지 초안이므로 부담 없이 시도해 보세요.
내보내기 / 가져오기
내보내기와 가져오기는 플로우 편집기 상단 툴바에서 수행합니다.
내보내기
가져오기
툴바의 내보내기 버튼을 클릭하면 JSON 파일로 다운로드됩니다.
파일에는 플로우 이름, 설명, 노드 구성, 연결 정보가 포함됩니다.
툴바의 가져오기 버튼을 클릭하고 내보낸 JSON 파일을 업로드합니다.
type: "agent_flow" 형식의 JSON 파일만 허용됩니다.
가져온 플로우에서 참조하는 에이전트, 모델, 가드레일이 현재 환경에 존재해야 정상 실행됩니다. 먼저 검증을 눌러 리소스 미선택 오류부터 확인하세요.
활용 사례
예시 1: 문서 분석 플로우
[시작] → [에이전트: 문서 요약] → [에이전트: 핵심 추출] → [출력]
사용자 입력을 문서 요약 에이전트가 처리한 후, 핵심 추출 에이전트가 요약 결과에서 주요 포인트를 정리합니다.
모델이 작성한 초안을 사람이 검토한 뒤에만 발송 단계로 넘깁니다.
거부 시 동작을 거부 브랜치로 진행으로 두면 거부 경로를 따로 설계할 수 있고, 플로우 중단으로 두면 그 자리에서 끝납니다.
예시 6: 항목별 병렬 처리
[시작] → [반복: LLM 모드] → [병합] → [출력]
줄바꿈으로 구분된 목록이나 JSON 배열을 입력으로 받아, 반복 노드가 각 항목을 병렬로 LLM에 태우고 결과를 이어붙입니다.
동시 실행 수(1~8)와 최대 항목 수로 부하를 제어합니다.
접근 권한
플로우에도 다른 워크스페이스 리소스와 동일한 접근 제어가 적용됩니다.플로우는 생성할 때도 편집할 때도 화면 상단 툴바의 자물쇠 아이콘 [접근] 버튼으로 접근 제어 모달을 엽니다 — 다른 리소스처럼 화면 안에 인라인 권한 영역이 있지 않습니다.모달의 접근 권한 셀렉터에서 공개 범위를 고릅니다.
옵션
설명
전체 사용자
모든 사용자가 읽기 가능
지정된 그룹만
접근 가능한 그룹에 올린 그룹의 구성원만 사용 가능
그룹 표에 올라간 그룹은 그 자체로 읽기 권한이며, 편집 가능 열을 체크해야 쓰기까지 허용됩니다.
새로 만든 플로우는 기본값이 전체 사용자 읽기 공개입니다. 채널과 함께 워크스페이스에서 몇 안 되는 예외입니다 — 범위를 좁히려면 만든 뒤 접근 권한을 지정된 그룹만으로 직접 바꿔야 합니다.
전체 사용자 옵션은 관리자에게만 표시됩니다. 일반 사용자에게는 지정된 그룹만 하나만 보입니다.
접근 제어 모달에서는 반드시 적용을 누르세요. 그룹을 고르기만 하고 모달을 닫으면 변경이 반영되지 않습니다. 적용 후 화면의 저장 및 생성(생성) 또는 초안 저장 · 게시(편집)까지 눌러야 최종 저장됩니다.
조직 단위는 이 화면에서 지정할 수 없습니다. 조직 단위로 열어주려면 관리자가 그룹에 조직 단위를 연결해야 합니다 — 그러면 그 조직 소속 사용자가 해당 그룹의 구성원으로 취급됩니다. 자세한 내용은 공유 및 권한을 참고하세요.
FAQ
플로우 메뉴가 보이지 않습니다
플로우 탭은 세 조건이 모두 충족돼야 표시됩니다.
agent_flow 라이선스가 부여된 환경
계정에 플로우 권한(workspace.agent_flows)
접속 주소가 미리보기 대상 호스트
플로우는 아직 미리보기 기능이라, 라이선스와 권한이 있어도 일반 운영 주소에서는 메뉴가 나오지 않습니다. 관리자에게 확인을 요청하세요.
분명히 저장했는데 채팅에서는 예전대로 동작합니다
편집 화면의 초안 저장은 라이브 플로우를 바꾸지 않습니다. 게시를 눌러야 채팅과 웹훅에 반영됩니다.캔버스 위에 “초안 편집 중” 배너가 떠 있거나 게시 버튼에 주황 점이 붙어 있다면 아직 미게시 상태입니다.
플로우에서 사용할 수 있는 에이전트는?
워크스페이스에 등록된 모든 에이전트를 사용할 수 있습니다.
일반 모드, KBSphere(향상된 RAG), DBSphere(데이터베이스) 모드 모두 지원됩니다.
플로우 실행 중 오류가 발생하면?
기본 동작은 오류가 발생한 노드에서 실행이 멈추고 오류 메시지가 표시되는 것입니다.노드별로 다르게 처리하려면 설정 패널 맨 아래 오류 처리 / 재시도 섹션에서 오류 발생 시 동작(플로우 중단 / 건너뛰고 계속 / 기본값 사용)과 최대 재시도, 재시도 간격, 타임아웃을 지정하세요. 이 섹션은 시작 노드를 제외한 모든 노드에 있습니다.
별도의 Error Handler 노드는 존재하지 않습니다.
같은 노드를 반복 실행할 수 있나요?
두 가지 방법이 있습니다.
반복 노드 — 여러 항목을 한 번에 병렬 처리할 때 (동시 실행 수 1~8)
루프 연결 — 조건에 따라 이전 노드로 되돌아가는 순환 경로. 정식 지원되며, 조건·라우터·가드레일 분기 중 하나가 루프 밖으로 나가야 합니다
루프 실행은 슈퍼스텝 상한(기본 50)으로 제한되며, {Label.loop_count}를 보다 큼 조건과 조합해 탈출 조건을 겁니다.
하나의 플로우에 여러 에이전트를 연결할 수 있나요?
네, 여러 에이전트를 순차적으로 연결하거나 조건·라우터 노드로 분기할 수 있습니다.
각 에이전트의 출력이 다음 에이전트의 입력으로 자동 전달됩니다.하나의 모델이 여러 에이전트에게 작업을 나눠 맡기고 결과를 종합하게 하려면 슈퍼바이저 노드를 사용하세요.
플로우의 실행 순서는?
시작 노드에서 시작하여 연결된 노드를 순서대로 따라갑니다.
조건 노드에서는 평가 결과에 따라 참 / 거짓 경로로 분기하고, 라우터 노드에서는 매칭되는 라우트로 분기합니다.
병합 노드에서는 여러 병렬 경로가 합류합니다.시작 노드가 없으면 첫 번째 노드가, 출력 노드가 없으면 말단 노드가 자동으로 진입점·종료점이 됩니다.
이전 버전으로 되돌리려면?
테스트 드로어의 버전 탭에서 게시 이력을 확인하고 복원을 누릅니다.
복원은 그 버전을 초안으로 되돌리는 것이므로, 캔버스에서 확인한 뒤 게시를 눌러야 롤백이 확정됩니다.보관되는 스냅샷은 최대 20개입니다.
플로우를 다른 환경으로 이동하려면?
편집기 상단 툴바의 내보내기로 JSON 파일을 받고, 대상 환경의 편집기에서 가져오기로 올립니다.
참조하는 에이전트, 모델, 가드레일이 대상 환경에도 존재해야 하므로 가져온 뒤 검증으로 확인하세요.
다음 단계
노드 레퍼런스
13종 노드의 설정과 State 키를 확인합니다
에이전트 생성
플로우에서 사용할 에이전트를 구성합니다
가드레일 설정
플로우 내에서 안전한 응답을 위한 필터를 구성합니다
공유 및 권한
접근 제어 모달의 사용법을 확인합니다
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"ko/workspace/flows","slug":"/ko/workspace/flows","pageMetadata":{"title":"에이전트 플로우","description":"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더","href":"/ko/workspace/flows"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,CodeBlock,Columns,Frame,Heading,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`에이전트 플로우는 여러 에이전트, 모델, 지식기반을 시각적으로 연결하여 복잡한 AI 파이프라인을 구축하는 기능입니다.\nn8n이나 Dify와 유사한 `,_jsx(_components.strong,{children:`비주얼 워크플로우 빌더`}),`로, 드래그 앤 드롭만으로 멀티 에이전트 오케스트레이션을 구성할 수 있습니다.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[시작] --> B{조건}\n B -->|참| C[에이전트 1]\n B -->|거짓| D[에이전트 2]\n C --> E[데이터 변환]\n D --> E\n E --> F[가드레일]\n F -->|통과| G[출력]`}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`워크스페이스에 플로우 탭이 보이려면 세 조건이 모두 충족돼야 합니다.`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`agent_flow`}),` 라이선스`]}),`가 부여된 환경일 것`]}),`\n`,_jsxs(_components.li,{children:[`계정에 `,_jsx(_components.strong,{children:`플로우 권한`}),`(`,_jsx(_components.code,{children:`workspace.agent_flows`}),`)이 있을 것 — 관리자는 항상 해당`]}),`\n`,_jsxs(_components.li,{children:[`접속한 주소가 `,_jsx(_components.strong,{children:`미리보기 대상 호스트`}),`일 것 — 플로우는 아직 미리보기 기능이라 지정된 개발·데모 호스트에서만 메뉴가 노출됩니다`]}),`\n`]}),_jsxs(_components.p,{children:[`세 번째 조건 때문에, 라이선스와 권한이 있어도 `,_jsx(_components.strong,{children:`일반 운영 주소에서는 메뉴 자체가 보이지 않습니다.`}),` 사용이 필요하면 관리자에게 문의하세요.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`플로우-vs-단일-에이전트`,children:`플로우 vs 단일 에이전트`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`구분`}),_jsx(_components.th,{children:`단일 에이전트`}),_jsx(_components.th,{children:`에이전트 플로우`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`복잡도`})}),_jsx(_components.td,{children:`단순 질의응답`}),_jsx(_components.td,{children:`멀티스텝 파이프라인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`에이전트 연결`})}),_jsx(_components.td,{children:`독립 실행`}),_jsx(_components.td,{children:`에이전트 간 데이터 전달`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`조건 분기`})}),_jsx(_components.td,{children:`불가`}),_jsx(_components.td,{children:`조건 / 라우터 노드로 분기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`데이터 변환`})}),_jsx(_components.td,{children:`불가`}),_jsx(_components.td,{children:`데이터 변환 노드의 Jinja2 템플릿`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`안전 검증`})}),_jsx(_components.td,{children:`에이전트 단위`}),_jsx(_components.td,{children:`가드레일 노드로 플로우 내 검증`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`사람의 승인`})}),_jsx(_components.td,{children:`불가`}),_jsx(_components.td,{children:`승인 게이트 노드로 중간 승인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`반복 처리`})}),_jsx(_components.td,{children:`불가`}),_jsx(_components.td,{children:`반복 노드로 항목별 병렬 처리`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`재사용`})}),_jsx(_components.td,{children:`개별 호출`}),_jsx(_components.td,{children:`서브플로우로 파이프라인 중첩`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`외부 호출`})}),_jsx(_components.td,{children:`채팅`}),_jsx(_components.td,{children:`채팅 + 웹훅 엔드포인트`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`단순한 Q\u0026A나 RAG 검색은 에이전트 하나로 충분합니다.\n여러 에이전트를 순차 또는 조건부로 연결해야 할 때 플로우를 사용하세요.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`플로우-목록`,children:`플로우 목록`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 > 플로우`}),`에서 생성된 모든 플로우를 확인할 수 있습니다.`]}),`\n`,_jsx(Frame,{caption:`플로우 목록`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-list.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=6ff38379a26d7d8b6eba65b2045d3f73`,alt:`플로우 목록`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/flows-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=2f02dbfb03e68bdf784c09e692e6863f 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=370c5ecb91042b4fca4ded0b1777d8dd 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=a313a5fc37b8a09964ec93128eaee916 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=35bf5b1b02f7acd19d80de3b370a7ff6 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=ae8869a30bc3df3c212b0d3ff2132aba 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=81bc45b539a4bf2edc847f519b252357 2500w`})}),`\n`,_jsx(_components.p,{children:`각 플로우 카드에는 다음 정보가 표시됩니다.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`요소`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`활성 / 비활성 배지`})}),_jsx(_components.td,{children:`플로우 활성 상태`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`노드 수`})}),_jsx(_components.td,{children:`플로우에 포함된 노드 개수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`이름`})}),_jsx(_components.td,{children:`플로우 식별 이름`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`설명`})}),_jsx(_components.td,{children:`플로우 용도 설명`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`작성자`})}),_jsx(_components.td,{children:`”{작성자 이름} 작성” 형태로 표시`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`수정일`})}),_jsx(_components.td,{children:`마지막 수정 시점 (상대 시간)`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`상단에서 `,_jsx(_components.strong,{children:`전체 / 내 플로우`}),`로 목록을 좁히거나 `,_jsx(_components.strong,{children:`플로우 검색`}),`으로 이름을 걸러낼 수 있습니다.\n카드 우측 상단의 `,_jsx(_components.strong,{children:`⋯`}),` 메뉴에서는 `,_jsx(_components.strong,{children:`복제`}),`와 `,_jsx(_components.strong,{children:`삭제`}),`, 그리고 `,_jsx(_components.strong,{children:`활성 / 비활성 전환`}),`을 할 수 있습니다.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`비활성 플로우는 채팅 모델 목록과 웹훅 호출 양쪽에서 모두 막힙니다.`}),` 잠시 쓰지 않을 플로우는 삭제 대신 비활성으로 두면 구성을 보존한 채 사용만 중단할 수 있습니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`플로우-생성`,children:`플로우 생성`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`새 플로우 만들기`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 > 플로우`}),`에서 우측 상단의 `,_jsx(_components.strong,{children:`+ 새 플로우`}),` 버튼을 클릭합니다.`]}),_jsx(Frame,{caption:`새 플로우 만들기 진입 후`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-create-top.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=1785c4281044c56f0cfe45963865bff1`,alt:`플로우 생성`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/flows-create-top.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-create-top.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=5c64f587d3bb3e4c8750945bb80730fc 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-create-top.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=3a1589b76c31a86a200b21210784b805 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-create-top.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=e64df86bacd1bd66de877b3f9e4020f2 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-create-top.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=f265cde637942da53bfc3a0ee3f7b82a 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-create-top.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=5d4f923e42f2315857709f054f658fde 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-create-top.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=48d3c5567528730ee08402845a2e1c8b 2500w`})}),_jsx(_components.p,{children:`좌측 패널에서 기본 정보를 입력합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`플로우 이름 입력`})}),_jsx(_components.td,{children:`플로우 표시 이름`}),_jsx(_components.td,{children:`”문서 분석 플로우”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`플로우 ID`})}),_jsx(_components.td,{children:`영문 소문자·숫자로 시작하는 2~50자 식별자`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`doc-analysis`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`설명 입력`})}),_jsx(_components.td,{children:`플로우 용도`}),_jsx(_components.td,{children:`”문서를 요약하고 핵심 내용을 추출합니다”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`상태 지속`})}),_jsx(_components.td,{children:`실행 간 대화 상태 유지 여부 (기본 켜짐)`}),_jsx(_components.td,{children:`켜짐`})]})]})]}),_jsxs(_components.p,{children:[`입력하는 동안 플로우 ID의 `,_jsx(_components.strong,{children:`중복 여부가 실시간으로 확인`}),`됩니다 — 사용 가능하면 초록 체크, 이미 쓰이는 값이면 빨간 X와 함께 “이미 사용 중인 플로우 ID입니다”가 표시됩니다.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`플로우 ID는 생성 후 변경할 수 없습니다. 화면 안내는 소문자·숫자·하이픈을 안내하지만 언더스코어(`,_jsx(_components.code,{children:`_`}),`)도 허용됩니다 (`,_jsx(_components.code,{children:`^[a-z0-9][a-z0-9_-]*$`}),`).`]})})]}),_jsxs(Step,{title:`템플릿으로 시작하거나, 빈 캔버스에서 시작`,children:[_jsxs(_components.p,{children:[`새 플로우의 빈 캔버스에는 `,_jsx(_components.strong,{children:`템플릿으로 시작`}),` 갤러리가 먼저 뜹니다. 카드를 고르면 노드와 연결이 배치된 상태로 시작합니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`템플릿`}),_jsx(_components.th,{children:`내용`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`간단한 LLM 응답`})}),_jsx(_components.td,{children:`단일 모델 호출로 바로 답변`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`가드레일 에이전트 답변`})}),_jsx(_components.td,{children:`가드레일 검사 → 통과 시 에이전트 답변`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`의도 라우팅`})}),_jsx(_components.td,{children:`질문 / 요청 / 그 외로 라우팅해 서로 다른 프롬프트의 모델로 분기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`병렬 모델 비교`})}),_jsx(_components.td,{children:`같은 입력을 두 모델에 병렬로 보내고 결과 병합`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지식베이스 Q\u0026A`})}),_jsx(_components.td,{children:`지식베이스 검색 후 그 컨텍스트로 답변`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`요약 파이프라인`})}),_jsx(_components.td,{children:`모델로 요약한 뒤 변환 템플릿으로 포맷`})]})]})]}),_jsxs(_components.p,{children:[`갤러리 우측 상단의 `,_jsx(_components.strong,{children:`처음부터 만들기`}),`(✕)를 누르면 갤러리가 닫히고 빈 캔버스에서 직접 만들 수 있습니다.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`템플릿은 `,_jsx(_components.strong,{children:`뼈대만`}),` 배치합니다. 모델·에이전트·지식베이스 같은 리소스는 각 노드를 클릭해 직접 골라야 실행됩니다.`]})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`템플릿을 고르면 상태 지속 토글이 꺼집니다.`}),` 템플릿이 플로우 구성을 통째로 교체하기 때문입니다. 대화 문맥을 유지할 플로우라면 템플릿을 고른 뒤 `,_jsx(_components.strong,{children:`상태 지속`}),`을 다시 켜세요.`]})})]}),_jsxs(Step,{title:`노드 배치`,children:[_jsxs(_components.p,{children:[`좌측 `,_jsx(_components.strong,{children:`노드`}),` 패널에서 원하는 노드를 캔버스로 `,_jsx(_components.strong,{children:`드래그`}),`하거나, 노드를 `,_jsx(_components.strong,{children:`클릭`}),`해 캔버스 중앙에 배치합니다.\n노드가 많아지면 패널 상단의 `,_jsx(_components.strong,{children:`노드 검색`}),` 칸으로 걸러내세요.`]}),_jsx(Frame,{caption:`패널에서 드래그된 노드는 사용자가 놓은 자리에, 클릭한 노드는 캔버스 중앙에 배치됩니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-canvas-detail.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=d87f8ee692d2f69a5a059c0953a689d4`,alt:`플로우 캔버스`,\"data-og-width\":`2936`,width:`2936`,\"data-og-height\":`1660`,height:`1660`,\"data-path\":`images/workspace/flows-canvas-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-canvas-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=bec593d40752fef4dca69576bd528963 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-canvas-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=2a5de5c373d32eeb519ba1eb4a6df58c 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-canvas-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=32270a85d74eeed84c733d4746b9f143 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-canvas-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=158d7adb3403827afb3da99d84fa50ee 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-canvas-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=6c5ceff1850ca10475639d454455893b 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-canvas-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=8c8af30ec24ec2e029e7159ff864d387 2500w`})})]}),_jsxs(Step,{title:`노드 연결`,children:[_jsxs(_components.p,{children:[`노드의 `,_jsx(_components.strong,{children:`출력 핸들(우측 점)`}),` 을 드래그하여 다음 노드의 `,_jsx(_components.strong,{children:`입력 핸들(좌측 점)`}),` 에 연결합니다.\n데이터는 `,_jsx(_components.strong,{children:`왼쪽에서 오른쪽(Left → Right)`}),` 방향으로 흐릅니다.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`핸들 위치: `,_jsx(_components.strong,{children:`좌측`}),` = 입력, `,_jsx(_components.strong,{children:`우측`}),` = 출력입니다.\n조건·라우터·가드레일·승인 게이트처럼 갈라지는 노드는 `,_jsx(_components.strong,{children:`우측에 출력 핸들이 여러 개 세로로`}),` 쌓여 있습니다.\n시작 노드에는 입력 핸들이 없고, 출력 노드에는 출력 핸들이 없습니다.`]})})]}),_jsxs(Step,{title:`노드 설정`,children:[_jsxs(_components.p,{children:[`노드를 클릭하면 오른쪽에 `,_jsx(_components.strong,{children:`설정 패널`}),`이 나타납니다.\n에이전트 노드라면 실행할 에이전트를 선택하고, 모델 노드라면 LLM 모델과 시스템/사용자 프롬프트를 설정합니다.\n패널 왼쪽 경계를 드래그하면 패널 너비를 조절할 수 있습니다.`]}),_jsxs(Columns,{cols:2,children:[_jsx(Frame,{caption:`에이전트 노드 설정`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=0bf3d413ad4d848cd7632a81f4a23430`,alt:`노드 설정 패널 1`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/flows-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=ac19c4d58d004dac2333c63daed41712 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=0e92ea03663cfdc13d663404c42d27b1 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=3af7fe817701d8d60c957cb88c9615b2 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=8f0545ca4c5929b9284000d905fc6b43 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=eafa0d7f0917d5d204cfa1b52603937f 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=db0328100219c81460b0071a625d8e1c 2500w`})}),_jsx(Frame,{caption:`모델 노드 설정`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail-2.png?fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=d58612b187bc1a9285a782a5a690d41b`,alt:`노드 설정 패널 2`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/flows-detail-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=07b07f28d12f2d90b16fe0894a1763e1 280w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=04d8fe68f5dbf09a226bbb34432fc676 560w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=a3c2a5ab0ad9cf2f19bae564dda15043 840w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=7f7d68a8459802a82fefbde4ce349b4c 1100w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=d9bd3d96317d00e8b9aec639c068294c 1650w, https://mintcdn.com/cloocus/Y-4u5ua9FNOY1GZd/images/workspace/flows-detail-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Y-4u5ua9FNOY1GZd\u0026q=85\u0026s=1da19494917dc6252643c3c2c8c5ffd6 2500w`})})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`각 노드의 설정 항목은 `,_jsx(_components.a,{href:`/ko/workspace/flows-nodes`,children:`노드 레퍼런스`}),`에서 확인하세요.`]})})]}),_jsxs(Step,{title:`검증 후 저장`,children:[_jsxs(_components.p,{children:[`상단 툴바의 `,_jsx(_components.strong,{children:`검증`}),`과 `,_jsx(_components.strong,{children:`저장 및 생성`}),`은 별도 동작입니다.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`검증`}),` — 문제를 점검하고 오류가 있는 노드를 캔버스에서 빨간 링으로 표시합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`저장 및 생성`}),` — 플로우를 만들고 편집 화면으로 이동합니다. `,_jsx(_components.strong,{children:`저장 시 검증이 자동으로 실행되지는 않습니다`})]}),`\n`]}),_jsxs(_components.p,{children:[`툴바 왼쪽 플로우 이름 앞의 `,_jsx(_components.strong,{children:`점`}),`이 검증 상태를 나타냅니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`점 색`}),_jsx(_components.th,{children:`의미`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`회색`}),_jsx(_components.td,{children:`마지막 편집 이후 미검증`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`초록`}),_jsx(_components.td,{children:`플로우가 유효합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`주황`}),_jsx(_components.td,{children:`검증 오류`})]})]})]}),_jsx(Note,{children:_jsx(_components.p,{children:`캔버스를 편집하면 점은 다시 회색으로 돌아갑니다 — 옛 검증 결과가 계속 초록으로 남아 오해를 주지 않게 하기 위한 동작입니다.`})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`초안-저장과-게시`,children:`초안 저장과 게시`}),`\n`,_jsxs(_components.p,{children:[`플로우를 `,_jsx(_components.strong,{children:`만든 뒤부터는 저장이 2단계`}),`입니다. 편집 화면의 저장은 초안에만 반영되고, `,_jsx(_components.strong,{children:`게시해야 실제로 실행되는 버전이 바뀝니다.`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`버튼`}),_jsx(_components.th,{children:`동작`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`초안 저장`})}),_jsxs(_components.td,{children:[`현재 캔버스를 초안으로 저장. `,_jsx(_components.strong,{children:`라이브 플로우는 그대로`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`게시`})}),_jsx(_components.td,{children:`초안을 라이브로 승격. 직전 라이브 버전은 버전 스냅샷으로 보관`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`미게시 초안이 있으면 `,_jsx(_components.strong,{children:`게시`}),` 버튼에 `,_jsx(_components.strong,{children:`미게시 초안`}),`을 뜻하는 주황 점이 붙고, 캔버스 위에 배너가 뜹니다.`]}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`초안 편집 중 — 게시하기 전까지 라이브 플로우는 변경되지 않습니다`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`배너 우측의 `,_jsx(_components.strong,{children:`초안 폐기`}),`를 누르면 “이 초안을 폐기하고 라이브 버전으로 되돌릴까요?” 확인 후 라이브 버전으로 캔버스를 되돌립니다.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`초안 저장만 하고 화면을 나가면 사용자에게는 아무것도 바뀌지 않습니다.`}),` 채팅과 웹훅은 계속 이전 게시본을 실행합니다. 변경을 실제로 적용하려면 반드시 `,_jsx(_components.strong,{children:`게시`}),`를 누르세요.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`플로우를 처음 만들 때는 이 단계가 없습니다.`}),` 생성 화면의 버튼은 `,_jsx(_components.strong,{children:`저장 및 생성`}),` 하나이며, 편집 화면으로 넘어간 뒤부터 초안 저장 / 게시로 나뉩니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`버전-되돌리기`,children:`버전 되돌리기`}),`\n`,_jsxs(_components.p,{children:[`게시할 때마다 직전 라이브 버전이 스냅샷으로 쌓입니다 (`,_jsx(_components.strong,{children:`최대 20개`}),`, 초과 시 오래된 것부터 삭제).`]}),`\n`,_jsxs(_components.p,{children:[`테스트 드로어의 `,_jsx(_components.strong,{children:`버전`}),` 탭에서 게시 이력을 확인하고 `,_jsx(_components.strong,{children:`복원`}),`을 누르면, 그 버전이 `,_jsx(_components.strong,{children:`초안으로`}),` 되돌아옵니다. 캔버스에서 확인한 뒤 `,_jsx(_components.strong,{children:`게시`}),`를 눌러야 실제 롤백이 확정됩니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`노드-타입`,children:`노드 타입`}),`\n`,_jsxs(_components.p,{children:[`에이전트 플로우는 총 `,_jsx(_components.strong,{children:`13종의 노드`}),`를 4개 카테고리로 제공합니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`카테고리`}),_jsx(_components.th,{children:`노드`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`일반`})}),_jsx(_components.td,{children:`시작, 출력`}),_jsx(_components.td,{children:`플로우 시작 / 종료`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`에이전트`})}),_jsx(_components.td,{children:`에이전트, 모델, 슈퍼바이저`}),_jsx(_components.td,{children:`에이전트 실행, 직접 LLM 호출, 워커 에이전트 조율`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`로직 \u0026 데이터`})}),_jsx(_components.td,{children:`조건, 라우터, 병합, 데이터 변환, 반복, 서브플로우`}),_jsx(_components.td,{children:`분기·라우팅·결합·변환·반복 처리·플로우 중첩`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`제어 \u0026 안전`})}),_jsx(_components.td,{children:`승인 게이트, 가드레일`}),_jsx(_components.td,{children:`사람의 승인 대기, 안전 필터`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`각 노드의 상세 설정은 `,_jsx(_components.a,{href:`/ko/workspace/flows-nodes`,children:`노드 레퍼런스`}),`에서 확인하세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`유효성-검증`,children:`유효성 검증`}),`\n`,_jsxs(_components.p,{children:[`상단 툴바의 `,_jsx(_components.strong,{children:`검증`}),` 버튼으로 점검합니다. 오류가 있으면 해당 노드가 캔버스에서 `,_jsx(_components.strong,{children:`빨간 링`}),`으로 표시됩니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`오류-—-고쳐야-실행됩니다`,children:`오류 — 고쳐야 실행됩니다`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`검증 항목`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`리소스 미선택`})}),_jsx(_components.td,{children:`에이전트 / 모델 / 가드레일 / 지식베이스 / 용어집 노드에 리소스 미지정`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`슈퍼바이저 설정 누락`})}),_jsx(_components.td,{children:`슈퍼바이저 모델 미선택 또는 워커 0개`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`서브플로우 설정 누락`})}),_jsxs(_components.td,{children:[`실행할 플로우 미선택, 또는 `,_jsx(_components.strong,{children:`자기 자신을 참조`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`반복 노드 모델 누락`})}),_jsx(_components.td,{children:`LLM 모드인데 모델 미선택`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`끊어진 연결`})}),_jsx(_components.td,{children:`삭제된 노드를 가리키는 잔여 연결선`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지원하지 않는 노드 유형`})}),_jsx(_components.td,{children:`빌더가 다루지 않는 타입 (가져오기한 레거시 플로우 등)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`탈출 없는 루프`})}),_jsx(_components.td,{children:`순환 경로에 밖으로 나가는 조건 분기가 없음`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`경고-—-실행은-됩니다`,children:`경고 — 실행은 됩니다`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`검증 항목`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`시작 노드 없음`})}),_jsx(_components.td,{children:`첫 번째 노드가 자동으로 진입점이 됩니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`출력 노드 없음`})}),_jsx(_components.td,{children:`말단 노드가 자동으로 플로우 끝에 연결됩니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`연결 안 된 노드`})}),_jsx(_components.td,{children:`어떤 노드와도 연결되지 않은 노드 (노드가 1개뿐인 플로우는 정상)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`루프 감지`})}),_jsx(_components.td,{children:`순환 경로가 있음`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`시작 / 출력 노드가 없어도 오류가 아닙니다.`}),` 암묵적 진입·종료가 지원되므로 경고로만 표시됩니다. 다만 의도를 분명히 하려면 두 노드를 명시하는 편이 좋습니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`루프는-정식-지원됩니다`,children:`루프는 정식 지원됩니다`}),`\n`,_jsxs(_components.p,{children:[`조건·라우터·가드레일 노드의 분기 중 하나가 루프 밖으로 나가면 안전한 루프로 간주해 `,_jsx(_components.strong,{children:`경고`}),`만 표시합니다. 밖으로 나가는 분기가 하나도 없을 때만 `,_jsx(_components.strong,{children:`오류`}),`입니다.`]}),`\n`,_jsxs(_components.p,{children:[`실행은 슈퍼스텝 상한(기본 50)으로 제한되며, 탈출 조건은 조건 노드에서 `,_jsx(_components.code,{children:`{Label.loop_count}`}),`를 `,_jsx(_components.strong,{children:`보다 큼`}),`과 조합해 겁니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`플로우-실행`,children:`플로우 실행`}),`\n`,_jsx(_components.p,{children:`플로우를 실행하는 경로는 세 가지입니다.`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`편집기에서 테스트`,id:`%ED%8E%B8%EC%A7%91%EA%B8%B0%EC%97%90%EC%84%9C-%ED%85%8C%EC%8A%A4%ED%8A%B8`,children:[_jsxs(_components.p,{children:[`툴바의 `,_jsx(_components.strong,{children:`테스트 실행`}),`을 누르면 캔버스 아래에 테스트 드로어가 열립니다. `,_jsx(_components.strong,{children:`저장하지 않은 현재 캔버스 그대로`}),` 실행되므로, 게시 전에 안전하게 확인할 수 있습니다.`]}),_jsx(_components.p,{children:`드로어는 세 탭으로 구성됩니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`탭`}),_jsx(_components.th,{children:`내용`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`테스트 실행`})}),_jsxs(_components.td,{children:[`테스트 입력을 넣고 `,_jsx(_components.strong,{children:`실행`}),`. 노드별 진행 상황과 최종 출력을 봅니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`실행 이력`})}),_jsx(_components.td,{children:`이 플로우의 실행 이력 (소유자·관리자는 전체, 공유 사용자는 자신의 실행만)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`버전`})}),_jsxs(_components.td,{children:[`게시 이력과 `,_jsx(_components.strong,{children:`복원`})]})]})]})]}),_jsxs(_components.p,{children:[`실행 중에는 노드별 상태(실행 중 / 완료 / 오류)가 `,_jsx(_components.strong,{children:`캔버스와 스텝 목록에 동시에`}),` 표시되고, 스텝을 클릭하면 그 노드의 출력 미리보기가 펼쳐집니다. KBSphere 에이전트를 쓰면 검색된 `,_jsx(_components.strong,{children:`출처 개수`}),`도 함께 표시됩니다.`]}),_jsx(_components.p,{children:`드로어 위쪽 경계를 드래그하면 높이를 조절할 수 있습니다.`}),_jsx(Note,{children:_jsxs(_components.p,{children:[`플로우에 `,_jsx(_components.strong,{children:`승인 게이트`}),`가 있으면 실행이 그 지점에서 멈추고 `,_jsx(_components.strong,{children:`승인 필요`}),` 카드가 뜹니다. 메모를 남기고 `,_jsx(_components.strong,{children:`승인`}),` 또는 `,_jsx(_components.strong,{children:`거부`}),`를 누르면 그 지점부터 실행이 이어집니다.`]})})]}),_jsxs(Tab,{title:`채팅에서 실행`,id:`%EC%B1%84%ED%8C%85%EC%97%90%EC%84%9C-%EC%8B%A4%ED%96%89`,children:[_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`새 채팅을 시작합니다`}),`\n`,_jsxs(_components.li,{children:[`모델 선택기에서 연결 타입 필터에 `,_jsx(_components.strong,{children:`플로우`}),`가 표시됩니다. 이를 선택합니다`]}),`\n`,_jsx(_components.li,{children:`원하는 플로우를 선택한 후 메시지를 입력합니다`}),`\n`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`플로우는 모델 선택기에서 별도의 탭이 아닌, `,_jsx(_components.strong,{children:`연결 타입(connection type) 필터`}),`로 노출됩니다. 이 필터는 사용 가능한 플로우가 하나라도 있을 때만 나타납니다.`]})}),_jsxs(_components.p,{children:[`채팅 실행은 대화 단위로 상태가 이어지므로, `,_jsx(_components.strong,{children:`상태 지속 토글과 무관하게`}),` 같은 대화 안에서는 문맥이 유지됩니다.`]})]}),_jsxs(Tab,{title:`웹훅으로 호출`,id:`%EC%9B%B9%ED%9B%85%EC%9C%BC%EB%A1%9C-%ED%98%B8%EC%B6%9C`,children:[_jsxs(_components.p,{children:[`편집 화면 좌측 패널 아래쪽에 `,_jsx(_components.strong,{children:`웹훅`}),` 엔드포인트가 표시됩니다. `,_jsx(_components.strong,{children:`URL 복사`}),`를 누르면 전체 주소가 복사됩니다.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST /api/v1/agent-flows/{플로우 ID}/invoke`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`요청 필드`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`input`})}),_jsx(_components.td,{children:`플로우에 전달할 입력 (필수)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stream`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),`면 SSE 스트림, 기본 `,_jsx(_components.code,{children:`false`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`session_id`})}),_jsx(_components.td,{children:`대화 세션 키. 주면 세션별 상태가 유지됩니다`})]})]})]}),_jsxs(_components.p,{children:[`기본 응답은 `,_jsx(_components.code,{children:`flow_id`}),` · `,_jsx(_components.code,{children:`session_id`}),` · `,_jsx(_components.code,{children:`output`}),` 을 담은 JSON입니다.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`API 키(`,_jsx(_components.code,{children:`Bearer sk-...`}),`)로도 호출할 수 있어 외부 시스템 연동에 쓸 수 있습니다. 호출자는 해당 플로우에 `,_jsx(_components.strong,{children:`읽기 권한`}),`이 있어야 하고, `,_jsx(_components.strong,{children:`비활성 플로우는 호출이 거부됩니다.`})]})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`상태-지속`,children:`상태 지속`}),`\n`,_jsxs(_components.p,{children:[`편집 화면 좌측의 `,_jsx(_components.strong,{children:`상태 지속`}),` 토글은 `,_jsx(_components.strong,{children:`실행 간 대화 상태를 유지`}),`할지 정합니다 (신규 플로우 기본 켜짐).`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`채팅 실행`}),` — 대화(chat) 단위로 자동 유지되므로 토글과 무관합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`웹훅·임베드·예약 작업 등 비채팅 실행`}),` — 이 토글이 켜져 있고 `,_jsx(_components.code,{children:`session_id`}),`를 넘겨야 세션별 상태가 이어집니다`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`ai로-플로우-만들기`,children:`AI로 플로우 만들기`}),`\n`,_jsxs(_components.p,{children:[`편집기 우측 하단의 보라색 `,_jsx(_components.strong,{children:`AI 어시스턴트`}),` 버튼을 누르면 대화형 빌더가 열립니다. 자연어로 원하는 플로우를 설명하면 AI가 노드와 연결을 생성해 캔버스에 바로 반영합니다.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`모델 선택`,children:_jsxs(_components.p,{children:[`패널 헤더의 셀렉터에서 빌더가 사용할 `,_jsx(_components.strong,{children:`모델을 고릅니다.`})]})}),_jsx(Step,{title:`의도 입력`,children:_jsx(_components.p,{children:`“고객 문의를 부서별로 분류하는 플로우 만들어줘”처럼 원하는 플로우를 설명합니다.\n처음 열면 예시 제안이 칩으로 떠 있으니 클릭해 바로 시작해도 됩니다.`})}),_jsxs(Step,{title:`AI 질문에 답변`,children:[_jsxs(_components.p,{children:[`AI가 가드레일 사용 여부, 라우팅 방식 등을 `,_jsx(_components.strong,{children:`버튼 형태`}),`로 되묻습니다. 원하는 옵션을 클릭하세요.`]}),_jsx(_components.p,{children:`예시:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`“가드레일을 사용할까요?” → `,_jsx(_components.strong,{children:`[개인정보보호]`}),` `,_jsx(_components.strong,{children:`[금칙어 차단]`}),` `,_jsx(_components.strong,{children:`[사용 안함]`})]}),`\n`,_jsxs(_components.li,{children:[`“어떤 라우팅 방식을 사용할까요?” → `,_jsx(_components.strong,{children:`[라우터]`}),` `,_jsx(_components.strong,{children:`[조건]`}),` `,_jsx(_components.strong,{children:`[직접 연결]`})]}),`\n`]})]}),_jsxs(Step,{title:`생성 및 반복 수정`,children:[_jsx(_components.p,{children:`충분한 정보가 모이면 노드와 연결이 캔버스에 배치됩니다. 이어서 대화하며 수정할 수 있습니다.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`“라우터 노드를 조건으로 바꿔줘”`}),`\n`,_jsx(_components.li,{children:`“에이전트 C를 중간에 추가해줘”`}),`\n`,_jsx(_components.li,{children:`“가드레일 노드를 제거해줘”`}),`\n`]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`처음부터 구체적으로 요청하면 되묻지 않고 바로 생성됩니다. 예: “PII 가드레일 → 감정 분석 라우터 → 긍정/부정별 에이전트로 분기하는 플로우 만들어줘”`})}),`\n`,_jsx(Heading,{level:`3`,id:`ai-빌더-특징`,children:`AI 빌더 특징`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`대화 히스토리 유지`}),` — 대화 기록이 플로우에 저장되어 나중에 다시 열면 이어서 수정 가능`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`기존 플로우 편집`}),` — 이미 만들어진 플로우에서 열면 현재 구조를 인식하고 수정 제안`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`실시간 캔버스 반영`}),` — 생성된 노드가 즉시 캔버스에 표시됨`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`패널 높이 조절`}),` — 상단 드래그 핸들로 크기 조절`]}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`AI 어시스턴트 버튼은 `,_jsx(_components.strong,{children:`플로우 쓰기 권한`}),`이 있는 사용자에게만 표시됩니다.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`AI가 만든 플로우도 수동으로 자유롭게 고칠 수 있습니다. AI로 뼈대를 잡고 세부 설정은 노드별로 직접 조정하는 것이 효과적입니다. 생성 결과는 `,_jsx(_components.strong,{children:`게시하기 전까지 초안`}),`이므로 부담 없이 시도해 보세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`내보내기-/-가져오기`,children:`내보내기 / 가져오기`}),`\n`,_jsxs(_components.p,{children:[`내보내기와 가져오기는 `,_jsx(_components.strong,{children:`플로우 편집기 상단 툴바`}),`에서 수행합니다.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`내보내기`,id:`%EB%82%B4%EB%B3%B4%EB%82%B4%EA%B8%B0`,children:_jsxs(_components.p,{children:[`툴바의 `,_jsx(_components.strong,{children:`내보내기`}),` 버튼을 클릭하면 JSON 파일로 다운로드됩니다.\n파일에는 플로우 이름, 설명, 노드 구성, 연결 정보가 포함됩니다.`]})}),_jsxs(Tab,{title:`가져오기`,id:`%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B8%B0`,children:[_jsxs(_components.p,{children:[`툴바의 `,_jsx(_components.strong,{children:`가져오기`}),` 버튼을 클릭하고 내보낸 JSON 파일을 업로드합니다.\n`,_jsx(_components.code,{children:`type: \"agent_flow\"`}),` 형식의 JSON 파일만 허용됩니다.`]}),_jsxs(Note,{children:[`가져온 플로우에서 참조하는 에이전트, 모델, 가드레일이 현재 환경에 존재해야 정상 실행됩니다. 먼저 `,_jsx(_components.strong,{children:`검증`}),`을 눌러 리소스 미선택 오류부터 확인하세요.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`활용-사례`,children:`활용 사례`}),`\n`,_jsxs(Accordion,{title:`예시 1: 문서 분석 플로우`,id:`1`,children:[_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[시작] → [에이전트: 문서 요약] → [에이전트: 핵심 추출] → [출력]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`사용자 입력을 문서 요약 에이전트가 처리한 후, 핵심 추출 에이전트가 요약 결과에서 주요 포인트를 정리합니다.`})]}),`\n`,_jsxs(Accordion,{title:`예시 2: 조건 분기 고객 지원`,id:`2`,children:[_jsx(CodeBlock,{numberOfLines:`8`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ┌─ 참 ──→ [에이전트: 기술지원] ─┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[시작] → [조건] ────────────────────────────→ [출력]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ 거짓 → [에이전트: 일반문의] ─┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`State 키: input`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`조건 유형: 포함`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`값: \"오류\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`사용자 입력에 “오류” 키워드가 포함되면 기술지원 에이전트로, 아니면 일반문의 에이전트로 분기합니다.`})]}),`\n`,_jsxs(Accordion,{title:`예시 3: 데이터 리포트 플로우`,id:`3`,children:[_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[시작] → [에이전트: DBSphere] → [데이터 변환] → [모델: 리포트 생성] → [출력]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`DBSphere 에이전트가 데이터를 조회하고, 데이터 변환 노드의 Jinja2 템플릿으로 결과를 정리한 후, 모델 노드가 최종 리포트를 작성합니다.`})]}),`\n`,_jsxs(Accordion,{title:`예시 4: 가드레일 적용 플로우`,id:`4`,children:[_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ┌─ 통과 → [에이전트: 질의응답] → [출력]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[시작] → [가드레일: PII 검사] ─┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ 차단 → [데이터 변환: 안내 문구] → [출력 (오류)]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`사용자 입력에 개인정보가 포함되면 차단하고, 안전한 입력만 에이전트로 전달합니다.\n차단 시 동작을 `,_jsx(_components.code,{children:`계속`}),`으로 설정하면 차단 정보를 데이터 변환 노드에서 가공하여 사용자에게 안내할 수 있습니다.`]})]}),`\n`,_jsxs(Accordion,{title:`예시 5: 승인이 필요한 발송 플로우`,id:`5`,children:[_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ┌─ 승인 → [에이전트: 발송] → [출력]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[시작] → [모델: 초안 작성] → [승인 게이트] ─┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ 거부 → [출력 (오류)]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`모델이 작성한 초안을 사람이 검토한 뒤에만 발송 단계로 넘깁니다.\n`,_jsx(_components.strong,{children:`거부 시 동작`}),`을 `,_jsx(_components.code,{children:`거부 브랜치로 진행`}),`으로 두면 거부 경로를 따로 설계할 수 있고, `,_jsx(_components.code,{children:`플로우 중단`}),`으로 두면 그 자리에서 끝납니다.`]})]}),`\n`,_jsxs(Accordion,{title:`예시 6: 항목별 병렬 처리`,id:`6`,children:[_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[시작] → [반복: LLM 모드] → [병합] → [출력]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`줄바꿈으로 구분된 목록이나 JSON 배열을 입력으로 받아, 반복 노드가 각 항목을 병렬로 LLM에 태우고 결과를 이어붙입니다.\n`,_jsx(_components.strong,{children:`동시 실행 수`}),`(1~8)와 `,_jsx(_components.strong,{children:`최대 항목 수`}),`로 부하를 제어합니다.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`접근-권한`,children:`접근 권한`}),`\n`,_jsx(_components.p,{children:`플로우에도 다른 워크스페이스 리소스와 동일한 접근 제어가 적용됩니다.`}),`\n`,_jsxs(_components.p,{children:[`플로우는 `,_jsx(_components.strong,{children:`생성할 때도 편집할 때도`}),` 화면 상단 툴바의 자물쇠 아이콘 `,_jsx(_components.strong,{children:`[접근]`}),` 버튼으로 접근 제어 모달을 엽니다 — 다른 리소스처럼 화면 안에 인라인 권한 영역이 있지 않습니다.`]}),`\n`,_jsxs(_components.p,{children:[`모달의 `,_jsx(_components.strong,{children:`접근 권한`}),` 셀렉터에서 공개 범위를 고릅니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`옵션`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`전체 사용자`})}),_jsx(_components.td,{children:`모든 사용자가 읽기 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지정된 그룹만`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`접근 가능한 그룹`}),`에 올린 그룹의 구성원만 사용 가능`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`그룹 표에 올라간 그룹은 그 자체로 읽기 권한이며, `,_jsx(_components.strong,{children:`편집 가능`}),` 열을 체크해야 쓰기까지 허용됩니다.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`새로 만든 플로우는 기본값이 전체 사용자 읽기 공개입니다.`}),` 채널과 함께 워크스페이스에서 몇 안 되는 예외입니다 — 범위를 좁히려면 만든 뒤 `,_jsx(_components.strong,{children:`접근 권한`}),`을 `,_jsx(_components.strong,{children:`지정된 그룹만`}),`으로 직접 바꿔야 합니다.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`전체 사용자`}),` 옵션은 `,_jsx(_components.strong,{children:`관리자에게만`}),` 표시됩니다. 일반 사용자에게는 `,_jsx(_components.strong,{children:`지정된 그룹만`}),` 하나만 보입니다.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`접근 제어 모달에서는 반드시 `,_jsx(_components.code,{children:`적용`}),`을 누르세요.`]}),` 그룹을 고르기만 하고 모달을 닫으면 변경이 반영되지 않습니다. 적용 후 화면의 `,_jsx(_components.strong,{children:`저장 및 생성`}),`(생성) 또는 `,_jsx(_components.strong,{children:`초안 저장 · 게시`}),`(편집)까지 눌러야 최종 저장됩니다.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`조직 단위는 이 화면에서 지정할 수 없습니다.`}),` 조직 단위로 열어주려면 관리자가 `,_jsx(_components.strong,{children:`그룹에 조직 단위를 연결`}),`해야 합니다 — 그러면 그 조직 소속 사용자가 해당 그룹의 구성원으로 취급됩니다. 자세한 내용은 `,_jsx(_components.a,{href:`/ko/collaboration/sharing-permissions`,children:`공유 및 권한`}),`을 참고하세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(Accordion,{title:`플로우 메뉴가 보이지 않습니다`,id:`%ED%94%8C%EB%A1%9C%EC%9A%B0-%ED%83%AD%EC%9D%80-%EC%84%B8-%EC%A1%B0%EA%B1%B4%EC%9D%B4-%EB%AA%A8%EB%91%90-%EC%B6%A9%EC%A1%B1%EB%8F%BC%EC%95%BC-%ED%91%9C%EC%8B%9C%EB%90%A9%EB%8B%88%EB%8B%A4.-agent_flow-%EB%9D%BC%EC%9D%B4%EC%84%A0%EC%8A%A4%EA%B0%80-%EB%B6%80%EC%97%AC%EB%90%9C-%ED%99%98%EA%B2%BD-%EA%B3%84%EC%A0%95%EC%97%90-%ED%94%8C%EB%A1%9C%EC%9A%B0-%EA%B6%8C%ED%95%9C(workspace.agent_flows)-%EC%A0%91%EC%86%8D-%EC%A3%BC%EC%86%8C%EA%B0%80-%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0-%EB%8C%80%EC%83%81-%ED%98%B8%EC%8A%A4%ED%8A%B8-%ED%94%8C%EB%A1%9C%EC%9A%B0%EB%8A%94-%EC%95%84%EC%A7%81-%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0-%EA%B8%B0%EB%8A%A5%EC%9D%B4%EB%9D%BC%2C-%EB%9D%BC%EC%9D%B4%EC%84%A0%EC%8A%A4%EC%99%80-%EA%B6%8C%ED%95%9C%EC%9D%B4-%EC%9E%88%EC%96%B4%EB%8F%84-%EC%9D%BC%EB%B0%98-%EC%9A%B4%EC%98%81-%EC%A3%BC%EC%86%8C%EC%97%90%EC%84%9C%EB%8A%94-%EB%A9%94%EB%89%B4%EA%B0%80-%EB%82%98%EC%98%A4%EC%A7%80-%EC%95%8A%EC%8A%B5%EB%8B%88%EB%8B%A4.-%EA%B4%80%EB%A6%AC%EC%9E%90%EC%97%90%EA%B2%8C-%ED%99%95%EC%9D%B8%EC%9D%84-%EC%9A%94%EC%B2%AD%ED%95%98%EC%84%B8%EC%9A%94.`,children:[_jsx(_components.p,{children:`플로우 탭은 세 조건이 모두 충족돼야 표시됩니다.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`agent_flow`}),` 라이선스`]}),`가 부여된 환경`]}),`\n`,_jsxs(_components.li,{children:[`계정에 `,_jsx(_components.strong,{children:`플로우 권한`}),`(`,_jsx(_components.code,{children:`workspace.agent_flows`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`접속 주소가 `,_jsx(_components.strong,{children:`미리보기 대상 호스트`})]}),`\n`]}),_jsx(_components.p,{children:`플로우는 아직 미리보기 기능이라, 라이선스와 권한이 있어도 일반 운영 주소에서는 메뉴가 나오지 않습니다. 관리자에게 확인을 요청하세요.`})]}),`\n`,_jsxs(Accordion,{title:`분명히 저장했는데 채팅에서는 예전대로 동작합니다`,id:`-1`,children:[_jsxs(_components.p,{children:[`편집 화면의 `,_jsx(_components.strong,{children:`초안 저장`}),`은 라이브 플로우를 바꾸지 않습니다. `,_jsx(_components.strong,{children:`게시`}),`를 눌러야 채팅과 웹훅에 반영됩니다.`]}),_jsxs(_components.p,{children:[`캔버스 위에 “초안 편집 중” 배너가 떠 있거나 `,_jsx(_components.strong,{children:`게시`}),` 버튼에 주황 점이 붙어 있다면 아직 미게시 상태입니다.`]})]}),`\n`,_jsx(Accordion,{title:`플로우에서 사용할 수 있는 에이전트는?`,id:`-2`,children:_jsx(_components.p,{children:`워크스페이스에 등록된 모든 에이전트를 사용할 수 있습니다.\n일반 모드, KBSphere(향상된 RAG), DBSphere(데이터베이스) 모드 모두 지원됩니다.`})}),`\n`,_jsxs(Accordion,{title:`플로우 실행 중 오류가 발생하면?`,id:`-3`,children:[_jsx(_components.p,{children:`기본 동작은 오류가 발생한 노드에서 실행이 멈추고 오류 메시지가 표시되는 것입니다.`}),_jsxs(_components.p,{children:[`노드별로 다르게 처리하려면 설정 패널 맨 아래 `,_jsx(_components.strong,{children:`오류 처리 / 재시도`}),` 섹션에서 `,_jsx(_components.strong,{children:`오류 발생 시`}),` 동작(`,_jsx(_components.code,{children:`플로우 중단`}),` / `,_jsx(_components.code,{children:`건너뛰고 계속`}),` / `,_jsx(_components.code,{children:`기본값 사용`}),`)과 `,_jsx(_components.strong,{children:`최대 재시도`}),`, `,_jsx(_components.strong,{children:`재시도 간격`}),`, `,_jsx(_components.strong,{children:`타임아웃`}),`을 지정하세요. 이 섹션은 시작 노드를 제외한 모든 노드에 있습니다.`]}),_jsx(Note,{children:`별도의 Error Handler 노드는 존재하지 않습니다.`})]}),`\n`,_jsxs(Accordion,{title:`같은 노드를 반복 실행할 수 있나요?`,id:`-4`,children:[_jsx(_components.p,{children:`두 가지 방법이 있습니다.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`반복 노드`}),` — 여러 항목을 한 번에 병렬 처리할 때 (동시 실행 수 1~8)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`루프 연결`}),` — 조건에 따라 이전 노드로 되돌아가는 순환 경로. 정식 지원되며, 조건·라우터·가드레일 분기 중 하나가 루프 밖으로 나가야 합니다`]}),`\n`]}),_jsxs(_components.p,{children:[`루프 실행은 슈퍼스텝 상한(기본 50)으로 제한되며, `,_jsx(_components.code,{children:`{Label.loop_count}`}),`를 `,_jsx(_components.strong,{children:`보다 큼`}),` 조건과 조합해 탈출 조건을 겁니다.`]})]}),`\n`,_jsxs(Accordion,{title:`하나의 플로우에 여러 에이전트를 연결할 수 있나요?`,id:`-5`,children:[_jsx(_components.p,{children:`네, 여러 에이전트를 순차적으로 연결하거나 조건·라우터 노드로 분기할 수 있습니다.\n각 에이전트의 출력이 다음 에이전트의 입력으로 자동 전달됩니다.`}),_jsxs(_components.p,{children:[`하나의 모델이 여러 에이전트에게 작업을 나눠 맡기고 결과를 종합하게 하려면 `,_jsx(_components.strong,{children:`슈퍼바이저 노드`}),`를 사용하세요.`]})]}),`\n`,_jsxs(Accordion,{title:`플로우의 실행 순서는?`,id:`-6`,children:[_jsx(_components.p,{children:`시작 노드에서 시작하여 연결된 노드를 순서대로 따라갑니다.\n조건 노드에서는 평가 결과에 따라 참 / 거짓 경로로 분기하고, 라우터 노드에서는 매칭되는 라우트로 분기합니다.\n병합 노드에서는 여러 병렬 경로가 합류합니다.`}),_jsx(_components.p,{children:`시작 노드가 없으면 첫 번째 노드가, 출력 노드가 없으면 말단 노드가 자동으로 진입점·종료점이 됩니다.`})]}),`\n`,_jsxs(Accordion,{title:`이전 버전으로 되돌리려면?`,id:`-7`,children:[_jsxs(_components.p,{children:[`테스트 드로어의 `,_jsx(_components.strong,{children:`버전`}),` 탭에서 게시 이력을 확인하고 `,_jsx(_components.strong,{children:`복원`}),`을 누릅니다.\n복원은 그 버전을 `,_jsx(_components.strong,{children:`초안으로`}),` 되돌리는 것이므로, 캔버스에서 확인한 뒤 `,_jsx(_components.strong,{children:`게시`}),`를 눌러야 롤백이 확정됩니다.`]}),_jsx(_components.p,{children:`보관되는 스냅샷은 최대 20개입니다.`})]}),`\n`,_jsx(Accordion,{title:`플로우를 다른 환경으로 이동하려면?`,id:`-8`,children:_jsxs(_components.p,{children:[`편집기 상단 툴바의 `,_jsx(_components.strong,{children:`내보내기`}),`로 JSON 파일을 받고, 대상 환경의 편집기에서 `,_jsx(_components.strong,{children:`가져오기`}),`로 올립니다.\n참조하는 에이전트, 모델, 가드레일이 대상 환경에도 존재해야 하므로 가져온 뒤 `,_jsx(_components.strong,{children:`검증`}),`으로 확인하세요.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`다음-단계`,children:`다음 단계`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`노드 레퍼런스`,icon:`diagram-project`,href:`/ko/workspace/flows-nodes`,children:_jsx(_components.p,{children:`13종 노드의 설정과 State 키를 확인합니다`})}),_jsx(Card,{title:`에이전트 생성`,icon:`robot`,href:`/ko/workspace/agents`,children:_jsx(_components.p,{children:`플로우에서 사용할 에이전트를 구성합니다`})}),_jsx(Card,{title:`가드레일 설정`,icon:`shield`,href:`/ko/workspace/guardrails`,children:_jsx(_components.p,{children:`플로우 내에서 안전한 응답을 위한 필터를 구성합니다`})}),_jsx(Card,{title:`공유 및 권한`,icon:`users`,href:`/ko/collaboration/sharing-permissions`,children:_jsx(_components.p,{children:`접근 제어 모달의 사용법을 확인합니다`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"에이전트 플로우","description":"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더","href":"/ko/workspace/flows"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"플로우 vs 단일 에이전트","slug":"플로우-vs-단일-에이전트","depth":2,"children":[]},{"title":"플로우 목록","slug":"플로우-목록","depth":2,"children":[]},{"title":"플로우 생성","slug":"플로우-생성","depth":2,"children":[]},{"title":"초안 저장과 게시","slug":"초안-저장과-게시","depth":2,"children":[{"title":"버전 되돌리기","slug":"버전-되돌리기","depth":3,"children":[]}]},{"title":"노드 타입","slug":"노드-타입","depth":2,"children":[]},{"title":"유효성 검증","slug":"유효성-검증","depth":2,"children":[{"title":"오류 — 고쳐야 실행됩니다","slug":"오류-—-고쳐야-실행됩니다","depth":3,"children":[]},{"title":"경고 — 실행은 됩니다","slug":"경고-—-실행은-됩니다","depth":3,"children":[]},{"title":"루프는 정식 지원됩니다","slug":"루프는-정식-지원됩니다","depth":3,"children":[]}]},{"title":"플로우 실행","slug":"플로우-실행","depth":2,"children":[{"title":"상태 지속","slug":"상태-지속","depth":3,"children":[]}]},{"title":"AI로 플로우 만들기","slug":"ai로-플로우-만들기","depth":2,"children":[{"title":"AI 빌더 특징","slug":"ai-빌더-특징","depth":3,"children":[]}]},{"title":"내보내기 / 가져오기","slug":"내보내기-/-가져오기","depth":2,"children":[]},{"title":"활용 사례","slug":"활용-사례","depth":2,"children":[]},{"title":"접근 권한","slug":"접근-권한","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"다음 단계","slug":"다음-단계","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"에이전트 플로우 - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/flows","matchLevel":0},"en":{"href":"/en/workspace/flows","matchLevel":1}}},"lastModified":"2026-08-21T06:01:59.172Z","originalFileLocation":"ko/workspace/flows.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"에이전트 플로우 - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/ko/workspace/flows\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8\u0026amp;title=%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8+%ED%94%8C%EB%A1%9C%EC%9A%B0\u0026amp;description=%EB%A9%80%ED%8B%B0+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8+%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C%EC%9A%B0%EB%A5%BC+%EC%8B%9C%EA%B0%81%EC%A0%81%EC%9C%BC%EB%A1%9C+%EA%B5%AC%EC%84%B1%ED%95%98%EA%B3%A0+%EC%8B%A4%ED%96%89%ED%95%98%EB%8A%94+%ED%94%8C%EB%A1%9C%EC%9A%B0+%EB%B9%8C%EB%8D%94\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=c963dd7be212d5787b4a149870765e07d722b995fdb50d80f81984393c98a63c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"에이전트 플로우 - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=AI+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8\u0026amp;title=%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8+%ED%94%8C%EB%A1%9C%EC%9A%B0\u0026amp;description=%EB%A9%80%ED%8B%B0+%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8+%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C%EC%9A%B0%EB%A5%BC+%EC%8B%9C%EA%B0%81%EC%A0%81%EC%9C%BC%EB%A1%9C+%EA%B5%AC%EC%84%B1%ED%95%98%EA%B3%A0+%EC%8B%A4%ED%96%89%ED%95%98%EB%8A%94+%ED%94%8C%EB%A1%9C%EC%9A%B0+%EB%B9%8C%EB%8D%94\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=c963dd7be212d5787b4a149870765e07d722b995fdb50d80f81984393c98a63c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/ko/workspace/flows\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/workspace/flows.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/flows\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/flows\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/flows\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/flows#webpage\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/flows\",\"name\":\"에이전트 플로우\",\"description\":\"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더\",\"dateModified\":\"2026-08-21T06:01:59.172Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/flows#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/flows#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI 에이전트\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"에이전트 플로우\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/flows\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/ko/workspace/flows#article\",\"headline\":\"에이전트 플로우\",\"name\":\"에이전트 플로우\",\"description\":\"멀티 에이전트 워크플로우를 시각적으로 구성하고 실행하는 플로우 빌더\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/flows\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/flows#webpage\"},\"dateModified\":\"2026-08-21T06:01:59.172Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/workspace/flows.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"시작하기","icon":"rocket","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"채팅","icon":"comments","pages":[{"title":"채팅","href":"/ko/chat/overview"}]},{"tab":"워크스페이스","icon":"briefcase","groups":[{"group":"워크스페이스","pages":[{"title":"워크스페이스 개요","href":"/ko/workspace/overview"}]},{"group":"AI 에이전트","pages":[{"title":"에이전트","description":"지식기반, 도구, 가드레일을 결합한 맞춤형 AI 어시스턴트 생성 및 관리","href":"/ko/workspace/agents"},{"title":"에이전트 플로우","href":"/ko/workspace/flows"},{"title":"플로우 노드 레퍼런스","description":"에이전트 플로우 캔버스에서 사용 가능한 13종 노드의 설정·동작·State 키 참조 가이드","href":"/ko/workspace/flows-nodes"}]},{"group":"지식 \u0026 데이터","pages":[{"title":"지식기반","href":"/ko/workspace/knowledge"},{"title":"동적 필터 상세 가이드","href":"/ko/workspace/knowledge-filters"},{"title":"지식 그래프","href":"/ko/workspace/knowledge-graph"},{"title":"데이터베이스","href":"/ko/workspace/database"},{"title":"용어집","href":"/ko/workspace/glossary"}]},{"group":"안전","pages":[{"title":"가드레일","href":"/ko/workspace/guardrails"}]},{"group":"커스터마이징","pages":[{"title":"프롬프트","href":"/ko/workspace/prompts"},{"title":"스킬","href":"/ko/workspace/skills"},{"title":"도구","href":"/ko/workspace/tools"},{"title":"마켓플레이스","href":"/ko/workspace/marketplace"},{"title":"태그","href":"/ko/workspace/tags"}]}]},{"tab":"협업","icon":"users","pages":[{"title":"협업","href":"/ko/collaboration/overview"}]},{"tab":"자동화","icon":"clock","pages":[{"title":"자동화","href":"/ko/automation/overview"}]},{"tab":"관리자","icon":"gear","pages":[{"title":"관리자","href":"/ko/admin/overview"}]},{"tab":"모니터링","icon":"chart-line","pages":[{"title":"모니터링","href":"/ko/monitoring/overview"}]},{"tab":"운영 · 지원","icon":"screwdriver-wrench","pages":[{"title":"운영 · 지원","href":"/ko/admin/deployment-checklist"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/workspace/flows"}]}]},"basePath":"","title":"에이전트 플로우 - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}