왜 워크플로우가 필요한가
업무에는 반복이 있습니다. 매주 재고를 확인하고, 부족한 상품을 찾아 공급사를 비교하고, 발주서를 만들고, 승인을 받고, 결과를 보고하는 일. 한 번 하면 1시간이지만, 매주 하면 연간 52시간입니다.
기존 자동화 도구는 이 문제를 해결하려고 했지만, 개발 지식이나 복잡한 설정을 요구했습니다. 드래그앤드롭으로 블록을 연결하더라도, API 인증, 데이터 변환, 조건 분기, 반복 처리를 직접 구성해야 했습니다.
wiiiv의 워크플로우는 다릅니다. 하고 싶은 일을 대화로 설명하면, AI가 실행 가능한 워크플로우를 설계합니다. 로그인부터 발주 승인, 이메일 발송까지 모든 단계를 AI가 구성하고, 사용자는 확인만 하면 됩니다.
기존 워크플로우 도구와 무엇이 다른가
기존 도구의 한계
Zapier, Make, n8n 같은 도구는 "트리거 + 액션" 모델을 사용합니다. 사용자가 각 단계를 수동으로 선택하고, 필드를 매핑하고, 인증을 설정합니다. 조건 분기나 반복 처리가 들어가면 복잡도가 급격히 올라갑니다.
wiiiv의 접근
- 대화로 입력: "SkyMall 베스트셀러와 저재고 상품을 조회해서, 공급사 성과를 확인한 뒤 발주하고 이메일로 보내줘"라고 하면 끝
- AI 설계: 인증 → API 호출 → 데이터 조인 → 반복(공급사 조회/성과 확인/발주 생성/승인) → 보고서 → 이메일까지 전체 흐름을 자동 구성
- Governed 실행: 각 단계마다 실행 기록과 검증이 남아, 무엇이 어떻게 실행되었는지 투명하게 추적 가능
- 재사용: 한번 만든 워크플로우는 버튼 한 번으로 재실행하거나, 팀원과 공유하거나, API로 외부에서 호출 가능
노드 맵 읽는 법
워크플로우를 만들면 노드 맵이 생성됩니다. 각 노드는 하나의 작업 단계이고, 위에서 아래로 순서대로 실행됩니다. 아래는 실제로 생성된 "공급사 발주 감사 및 이메일 보고서" 워크플로우의 노드 맵입니다.
if 모두-거래-이력-있음 → proceed to create_normal_notice step
노드 맵 상단 바
- 뷰 전환: 노드 맵(그래프), 상세 목록(텍스트), 컨텍스트(설계 이유) 중 선택
- API 태그: 이 워크플로우가 외부 API를 호출하는지 표시
- 서비스 배지: 연동하는 외부 시스템 (SkyMall, SkyStock, Report, Email 등)
- 해시와 노드 수: 워크플로우 고유 식별자(#f23323ef)와 총 노드 개수(10 nodes)
노드 카드 구조
각 노드 카드에는 번호(#1), 서비스 아이콘, 노드 이름, 타입 배지(ACT, COMMAND, DECIDE 등), 서비스 배지(SkyMall, Email 등)가 표시됩니다. 본문에는 이 단계가 무엇을 하는지에 대한 설명이, 하단에는 입출력 변수가 표시됩니다.
노드를 클릭하면 뒷면으로 뒤집혀 API URL, 헤더, 바디, 힌트 등 기술 상세를 확인할 수 있습니다.
노드 타입
wiiiv 워크플로우는 7가지 노드 타입으로 구성됩니다. 각 타입은 배경색과 좌측 컬러 라인으로 구분됩니다.
위 외에 Input(사용자 입력), Command(Python 스크립트 실행) 타입이 있습니다. Command는 복수의 데이터를 조인하거나 복잡한 계산이 필요할 때 AI가 Python 코드를 생성해 실행합니다.
노드 사이의 연결
노드들은 변수를 통해 연결됩니다. 이전 노드의 Output이 다음 노드의 Input이 됩니다. 예를 들어, #1 fetch-skymall-best-sellers의 Output인 best_sellers가 #4 select-target-products의 Input으로 전달됩니다.
두 가지 실행 방식
wiiiv 워크플로우는 두 가지 방식으로 실행할 수 있습니다. 설정 화면의 "워크플로우 실행 방식"에서 선택합니다.
- 각 노드가 Python 스크립트로 변환되어 직접 실행됩니다
- LLM 호출 없이 동작하므로 실행 속도가 빠릅니다
- 동일 입력에 항상 동일 결과를 보장합니다
- 판단이 필요한 곳에서만 최소한의 LLM을 호출합니다 (
llm.decide(),llm.generate()) - 대부분의 워크플로우에 적합합니다
- HLW 엔진이 노드별로 LLM을 호출하며 실행합니다
- 실행 결과에 대한 상세한 해석과 로그를 제공합니다
- 예상치 못한 상황에도 유연하게 대응합니다
- 보고서 작성, 분석 등 판단이 필요한 작업에 적합합니다
- P 라인보다 실행 시간과 비용이 더 소요됩니다
채팅으로 워크플로우 만들기
워크플로우를 만드는 가장 자연스러운 방법은 채팅에서 원하는 작업을 설명하는 것입니다.

skymall-bestseller-lowstock-procurement-and-email
v1.0 · 13 nodes
SkyMall 베스트셀러 상위 20개와 재고 30개 이하 상품을 조회하고, SkyStock에서 CRITICAL 재고 알림을 조회한 뒤, 잘 팔리면서 재고가 부족한 상품만 추려 해당 상품의 공급사 및 공급사 성과를 확인한다. 이후 조건에 맞는 상품에 대해 발주를 생성하고 승인한 뒤, 전체 처리 결과를 이메일로 발송한다.
AI가 노드 맵을 생성하면, 채팅 안에서 바로 확인할 수 있습니다. "실행해줘"라고 말하면 저장과 동시에 실행됩니다.
좋은 요청 작성법
- 구체적으로: "상품 조회해줘"보다 "SkyMall에서 재고 30개 이하 상품을 조회해줘"
- 결과까지: 조회 후 처리 방법(보고서, 이메일, 발주)까지 설명
- 조건 명시: "잘 팔리면서 재고 부족한 상품"처럼 판단 기준 제시
- 다중 시스템: 여러 시스템을 연동할 때는 각 시스템에서 할 일을 명시 ("SkyMall에서 조회하고, SkyStock에서도 확인")
워크플로우 실행하기
1. 워크플로우 페이지에서 실행
Workflows 페이지에서 워크플로우를 선택한 뒤, 우측 상단의 ▶ Execute 버튼을 누릅니다. Input 노드가 있으면 값을 입력하는 화면이 먼저 나타납니다.
2. 채팅에서 실행
"skymall-bestseller-lowstock 워크플로우 실행해줘"라고 말하면, 대화 안에서 바로 실행됩니다.
3. API로 실행
워크플로우 상세 화면의 API 탭에서 엔드포인트와 curl 예시를 확인할 수 있습니다.
4. 예약 실행 (CRON)
워크플로우 상세 화면의 CRON 탭에서 반복 실행 일정을 설정합니다. CRON 표현식을 직접 입력하거나, "매주 월요일 9시"처럼 대화로 입력하면 자동 변환됩니다.
워크플로우 목록과 관리
Workflows 페이지 좌측에 프로젝트에 속한 모든 워크플로우가 목록으로 표시됩니다.
필터
- All: 프로젝트의 모든 워크플로우
- Mine: 내가 만든 워크플로우만
- Shared: 팀원에게 공유된 워크플로우만
- Auto: 채팅에서 AI가 자동 생성한 워크플로우만
우클릭 메뉴
워크플로우 목록에서 항목을 우클릭하면 다음 동작을 사용할 수 있습니다.
- 채팅에서 편집: 채팅 화면으로 이동해 대화로 워크플로우를 수정
- 실행: 즉시 실행
- 복제: 워크플로우 사본 생성
- 이름 변경: 워크플로우 이름 수정
- 색상 지정: 분류용 색상 태그 설정 (7가지 색상)
- 공유/비공개 전환: PRIVATE ↔ PROJECT(팀 공유)
- 내보내기: .hlw.json 파일로 다운로드
- 삭제: 영구 삭제 (확인 대화상자 표시)
워크플로우 수정하기
만들어진 워크플로우를 수정하는 방법은 채팅에서 편집하는 것입니다. 컨텍스트 메뉴에서 "채팅에서 편집"을 선택하면, 해당 워크플로우가 로드된 채팅 세션이 열립니다.

변경 사항:
• #2 fetch-skymall-low-stock: threshold 30 → 20
• #13 send-email-report → send-slack-alert: Email → Slack #inventory-alerts
• 서비스 배지: Email → Slack
나머지 11개 노드는 그대로 유지됩니다. 적용할까요?
대화로 변경을 요청하면 AI가 필요한 노드만 수정하고 나머지는 유지합니다. 여러 변경을 한 번에 요청할 수도 있습니다.
재사용과 확장
SubWorkflow 호출
자주 쓰는 작업(예: SkyMall 인증 + 토큰 추출)을 별도 워크플로우로 만들어두면, 다른 워크플로우에서 SubWorkflow 노드로 호출할 수 있습니다.
복제 후 변형
기존 워크플로우를 복제한 다음, 채팅에서 일부만 수정하면 빠르게 변형을 만들 수 있습니다.
API 연동
모든 워크플로우는 고유한 API 엔드포인트를 가집니다. 외부 시스템이나 스크립트에서 워크플로우를 프로그래밍 방식으로 호출할 수 있습니다.
공유
PRIVATE → PROJECT로 전환하면 같은 프로젝트의 팀원들도 워크플로우를 실행할 수 있습니다.
업로드/내보내기
.hlw.json 파일로 내보내기/업로드할 수 있어, 프로젝트 간 워크플로우 이동이 가능합니다.
실무 활용 팁
워크플로우 이름
AI가 자동 생성하지만, 대상-동작-결과 패턴이 나중에 찾기 쉽습니다. 예: skymall-bestseller-lowstock-procurement-and-email
onError 정책
각 노드에는 실패 시 동작이 설정됩니다. retry:2(2회 재시도), skip(건너뛰기), abort(중단). AI가 노드 성격에 맞게 자동으로 설정하지만, 채팅에서 변경할 수도 있습니다.
노드 맵 확대/축소
노드 맵 우측 상단의 - 100% + 컨트롤로 조절합니다. 우측 하단 미니맵으로 전체 구조를 조감할 수 있습니다.
컨텍스트 뷰
노드 맵 상단의 💡(전구) 탭을 누르면, AI가 이 워크플로우를 왜 이렇게 설계했는지 설명하는 Genesis Context를 확인할 수 있습니다. 목적, 핵심 결정, 수정 시 주의사항이 기록되어 있습니다.