워크플로우
워크플로우는 챗봇이 메시지에 응답할 때 거치는 단계를 노드와 연결선으로 직접 설계하는 방식입니다. 한 번의 LLM 호출만으로 끝내기 어려운 분류·분기·가드레일·도구 호출을 한 흐름 안에 묶어, 같은 챗봇으로도 훨씬 정교한 동작을 만들 수 있습니다.
개요
| 항목 | 동작 |
|---|---|
| 기본 모드 | 챗봇 (단일 LLM 호출) |
| 전환 위치 | 동작 편집 탭 → 실행 방식 → 워크플로우 선택 |
| 에디터 경로 | /dashboard/studio/{chatbot_id}/workflow |
| 노드 유형 | 7개 (시작/끝/에이전트/분류/조건 분기/가드레일/메모) |
| 저장 단위 | 임시 저장(자동) + 명시적 게시(라이브 반영) |
| 권한 | 편집(Editor) 권한 이상 |
시작하기
- 스튜디오 챗봇 상세 화면에서 동작 편집 탭을 엽니다.
- 실행 모드 섹션에서 워크플로우를 선택합니다.
- 선택 즉시 표시되는 편집기 열기 버튼을 누르면 전용 워크플로우 에디터로 이동합니다.
- 처음 전환하면 Start → Agent 두 노드가 자동으로 배치·연결된 상태로 시작합니다. Agent에는 챗봇의 시스템 모델과 시스템 프롬프트가 미리 채워져 있어, 그대로 저장만 해도 채팅 모드와 동일한 동작을 수행합니다. 이후 좌측 노드 추가 패널에서 노드를 끌어다 놓아 흐름을 확장합니다.
활용하기
노드 유형
워크플로우 에디터에서 추가할 수 있는 노드는 다음 7가지입니다.
| 노드 | 역할 |
|---|---|
| 시작 (Start) | 워크플로우의 진입점. 별도로 설정할 항목은 없고, 테넌트 기본 가드레일(PII 차단·마스킹, 파일 업로드 차단)이 어떤 상태로 적용 중인지 인스펙터에 읽기 전용으로 표시 |
| 에이전트 (Agent) | LLM 호출 단계. 프롬프트, 모델, 심층 사고, 채팅 기록 포함 여부, 참조할 지식 파일, 출력 모드(텍스트 또는 JSON), 사용할 도구를 지정 |
| 분류 (Classify) | 사용자 메시지를 미리 정해 둔 여러 카테고리 중 하나로 분류하고, 카테고리마다 다른 경로로 흐름을 보냄. 분류에 쓸 모델과 카테고리 목록을 정하고, 필요하면 분류 지침이나 예시를 추가해 정확도를 높일 수 있음 |
| 조건 분기 (If-Else) | 직접 정의한 조건식으로 분기. 분기는 위에서 아래로 평가하고 가장 먼저 일치한 경로로 흐르며, 어느 것에도 해당하지 않으면 묵시적 Else 경로로 흐름 |
| 가드레일 (Guardrail) | 흐름 중간에 배치하는 안전 검사. PII 차단·마스킹과 금칙어 체크를 켤 수 있고, 검사 통과(Pass) / 검출(Fail) 두 출구로 흐름을 분기 |
| 메모 (Note) | 실행에는 영향이 없는 주석. 흐름 의도를 설명할 때 사용 |
| 끝 (End) | 워크플로우의 종료 지점. 사용자에게 보낼 응답 템플릿(예: 요청을 접수했습니다. 분류: {{input.parsed.category}})을 지정하거나, 분기별로 어디서 끝났는지 라벨링하고 싶을 때 명시적으로 추가 |
좌측 노드 추가 패널의 항목을 캔버스로 드래그해 배치합니다.
노드 연결과 분기
노드의 출력 포트를 다른 노드의 입력 포트로 끌어서 연결선을 만듭니다. 분기 노드(분류·조건 분기)는 출력 포트가 여러 개이며, 각 연결선에 라벨을 달 수 있어 흐름을 한눈에 읽을 수 있습니다.
| 단축 동작 | 설명 |
|---|---|
| 자동 정렬 | 캔버스의 노드를 보기 좋게 재배치 |
| 실행 취소 / 다시 실행 | 최근 변경 되돌리기 |
| 캔버스 잠금 | 실수로 위치가 바뀌지 않도록 편집 잠금 |
| 유효성 경고 | 미연결 포트·필수 필드 누락 등이 있으면 노드와 상단 배너에 경고 표시 |
임시 저장과 게시
| 단계 | 동작 |
|---|---|
| 임시 저장 | 편집을 멈추는 즉시 작업 사본(working copy)에 자동 저장. 다른 사용자에게는 보이지 않음 |
| 게시 (Publish) | 상단의 게시 버튼을 누르면 확인 모달이 한 번 뜬 뒤, 작업 사본이 라이브 버전으로 승격 |
게시할 때마다 버전 기록에 새 항목이 추가됩니다. 사용자에게 응답하는 흐름은 가장 최근에 게시한 버전이 사용됩니다.
테스트 채팅
에디터 우측 상단에는 ✏️(편집) / 💬(테스트 채팅) 두 아이콘으로 이루어진 토글이 있습니다. 💬를 누르면 우측 인스펙터 패널이 테스트 채팅 패널로 바뀌고, ✏️를 다시 누르면 인스펙터로 돌아옵니다.
테스트 채팅은 항상 아직 게시하지 않은 임시 저장본(초안) 으로 응답하므로, 라이브 사용자에게 영향을 주지 않고 변경을 검증할 수 있습니다. 패널 상단에 초안 테스트 배지가 함께 표시되어 응답이 라이브가 아님을 명확히 알려 줍니다.
테스트 채팅 결과에는 워크플로우 실행이 어느 분기로 흘러갔는지(분류·조건 분기 결정 라벨)도 함께 표시됩니다.
워크플로우 편집과 게시는 편집 권한(Editor) 이상에서만 가능합니다. 권한 구성은 공유 (헤더 팝오버)에서 확인할 수 있습니다.
실행 방식을 워크플로우 → 챗봇으로 다시 전환하면, 워크플로우 라이브 버전은 그대로 보존되지만 응답에는 사용되지 않습니다. 워크플로우 자체는 사라지지 않으므로 언제든 다시 워크플로우 모드로 복귀할 수 있습니다.
마지막 수정 날짜: Jun 23, 2026