Appearance
워크플로우 편집
워크플로우 탭은 모듈 그래프로 생성·처리 흐름을 만들고, 저장하고, 실행 결과를 관리하는 화면입니다. ComfyUI, NAI, Codex, LLM, 커스텀 노드 같은 작업을 노드로 이어 붙여 반복 가능한 파이프라인으로 씁니다.
위치
- 생성 페이지:
/generation?tab=workflows - 바로가기:
/graph→ 워크플로우 탭으로 이동
화면 구조
워크플로우 탭은 두 모드로 나뉩니다.
| 모드 | 용도 |
|---|---|
| Browse | 저장된 워크플로우 선택, 입력값 채우기, 실행, 결과 확인 |
| Editor | 노드 배치, 연결, 입력값 설정, 검증, 저장 |
왼쪽 목록에서 폴더와 워크플로우를 고르고, 오른쪽에서 실행기 또는 편집기를 사용합니다.
새 워크플로우 만들기
- 워크플로우 탭을 엽니다.
- 새 워크플로우 또는 편집 진입 버튼을 선택합니다.
- 캔버스 빈 곳을 우클릭하거나 상단의 모듈 추가 버튼을 누릅니다.
시스템,생성,커스텀 노드탭에서 노드를 고릅니다.- 노드 포트를 드래그해 다른 노드와 연결합니다.
- 필요한 입력값을 노드 Inspector에서 채웁니다.
- 검증 버튼으로 치명 이슈가 없는지 확인합니다.
- 저장 버튼을 누르고 이름, 설명, 저장 폴더를 확정합니다.
노드 추가 방식
빈 캔버스에서 추가
빈 곳을 우클릭하면 퀵 메뉴가 열립니다. 여기서 노드 추가 버튼을 누르면 모듈 목록이 뜹니다.
모듈 목록 탭:
시스템: 텍스트, 이미지, LLM 호출, 최종 결과 등 기본 모듈생성: NAI, ComfyUI, Codex 등 생성 계열 모듈커스텀 노드: 로컬 파일 기반 커스텀 노드
검색창으로 모듈 이름, 설명, 엔진 타입, 카테고리를 찾을 수 있습니다.
포트에서 추천 노드 추가
노드의 입력/출력 포트를 끌다가 빈 곳에 놓으면 연결 가능한 추천 노드가 뜹니다.
추천 기준:
- 같은 데이터 타입이면
exact - 문자열로 이어 받을 수 있으면
string-bridge - 맞지 않는 포트는 추천에서 제외
이 방식이 제일 빠릅니다. 엉뚱한 노드를 줄여주니까, 삽질 덜 합니다.
연결 규칙
- 출력 포트 → 입력 포트로 연결합니다.
- 입력 타입과 출력 타입이 맞아야 합니다.
- 이미 값이 직접 입력된 포트도 연결 상태에 따라 실행 입력으로 처리될 수 있습니다.
- 고급 출력 포트가 있는 노드는 퀵 메뉴에서 고급 출력 모드를 켤 수 있습니다.
연결이 꼬였을 때는 노드 퀵 메뉴에서 모든 연결 끊기를 쓰면 빠릅니다.
노드 편집
노드를 선택하면 퀵 메뉴와 Inspector를 사용할 수 있습니다.
주요 작업:
- 노드 라벨 변경
- 입력값 직접 설정
- 입력값 지우기
- 이미지 입력 선택
- 선택 노드 실행
- 강제 재실행
- 노드 복제
- 노드 삭제
- 연결 삭제
특수 입력 UI도 노드 종류에 맞춰 뜹니다.
- LLM 호출 노드: 등록된 LLM 제공자/기본 모델 선택
- LLM 프리셋 노드: 프리셋 타입과 이름 선택
- NAI 노드: 캐릭터 프롬프트, Vibe, 캐릭터 레퍼런스 입력
- Power LoRA 노드: LoRA 항목 배열 편집
- 일반 필드: 텍스트, 숫자, 불리언, JSON, 선택값 입력
캔버스 조작
| 동작 | 설명 |
|---|---|
| 노드 클릭 | 노드 선택, 퀵 메뉴 열기 |
| 노드 우클릭 | 노드 퀵 메뉴 열기 |
| 빈 곳 우클릭 | 노드 추가 메뉴 열기 |
| 엣지 클릭 | 연결 선택 |
Ctrl/Cmd + C | 선택한 노드/연결 복사 |
Ctrl/Cmd + V | 최근 위치 또는 캔버스 중앙에 붙여넣기 |
| 자동 정렬 | 현재 그래프를 보기 좋게 재배치 |
| 초기화 | 캔버스 초안 리셋 |
검증 상태 확인
편집기 상단의 검증 아이콘은 저장·실행 전에 볼 핵심 신호입니다.
| 상태 | 의미 |
|---|---|
| ready | 실행 가능한 상태 |
| warning | 저장은 가능하지만 실행 전 확인 필요 |
| critical | 실행을 막는 치명 이슈 있음 |
검증 항목을 클릭하면 해당 노드나 포트로 이동합니다. 필수 입력 누락, 연결 누락, 결과 노드 누락 같은 문제는 여기서 먼저 잡습니다.
저장
저장 모달에서 다음을 정합니다.
- 워크플로우 이름
- 설명
- 저장 폴더
- 새 자식 폴더 생성
- 디버그 모드
저장 조건:
- 노드가 최소 1개 있어야 합니다.
- 치명 검증 이슈가 있으면 먼저 정리합니다.
- 저장 후에는 목록에서 버전, 노드 수, 연결 수, 결과 수를 확인합니다.
디버그 모드
디버그 모드를 켜면 실행 로그, 텍스트 출력, 중간 아티팩트, Comfy 요청 스냅샷을 저장합니다.
추천 사용:
- 새 워크플로우를 처음 만들 때
- 특정 노드 결과를 확인해야 할 때
- ComfyUI 요청 JSON을 추적해야 할 때
끄는 게 좋은 경우:
- 대량 반복 실행
- 중간 산출물이 너무 많이 쌓일 때
- 최종 결과만 보관하면 충분할 때
실행
- Browse 모드에서 워크플로우를 선택합니다.
- 실행 입력 필드를 채웁니다.
- 검증 패널에서 치명 이슈가 없는지 확인합니다.
실행을 누릅니다.- 최근 결과와 실행 이력을 확인합니다.
워크플로우가 바뀌면 연결된 자동 실행이 workflow_changed 상태로 멈출 수 있습니다. 이 경우 예약작업 탭에서 다시 검토하고 켭니다.
결과 확인
실행 결과 패널에서 확인할 수 있는 것:
- 실행 목록
- 실행 상태
- 최종 결과
- 노드별 아티팩트
- 텍스트/중간 아티팩트
- 실패 메시지
- 재실행
- 실패 실행 재시도
- 실행 취소
최종 결과가 비어 있으면 최종 결과 노드를 추가하고 원하는 출력에 연결해야 합니다.
생성물 관리
워크플로우나 폴더를 선택하지 않은 Browse 화면에서는 생성물 관리 패널을 볼 수 있습니다.
탭:
| 탭 | 용도 |
|---|---|
| 생성 결과 | 이미지/비디오 같은 최종 생성물 관리 |
| 텍스트와 중간 아티팩트 | 로그, JSON, 중간 출력 확인 |
가능한 작업:
- 결과 선택
- 다운로드
- 감시 폴더로 복사
- 검색/필터
- 페이지 이동
- 삭제
삭제는 관리자 계정에서만 가능합니다. 페이지당 기본 표시 수는 50개입니다.
공개 워크플로우
공개 워크플로우는 로그인하지 않은 사용자에게 일부 실행/결과 화면을 제공할 수 있습니다. 공개 페이지로 열기 전에는 다음을 꼭 확인합니다.
- 공개 slug
- 노출할 marked field
- 큐 최대 요청 수
- 결과 표시 방식
- 아티팩트 디렉터리 정책
- 민감한 중간 출력 저장 여부
공개 페이지에는 내부 프롬프트, 토큰, 로컬 경로가 섞이지 않게 디버그 모드와 출력 노드를 특히 조심합니다.
좋은 워크플로우 기준
- 입력 노드가 명확합니다.
- 최종 결과 노드가 있습니다.
- 자주 바꾸는 값만 실행 입력으로 노출합니다.
- 중간 디버그 산출물과 최종 산출물을 구분합니다.
- 폴더 이름이 목적별로 정리되어 있습니다.
- 실패했을 때 어느 노드가 문제인지 바로 보입니다.
문제 해결
실행 버튼이 비활성화됨
- 검증 패널의 critical 이슈를 봅니다.
- 필수 입력값이 비었는지 확인합니다.
- 결과 노드 또는 연결이 누락됐는지 확인합니다.
원하는 노드가 추천에 안 나옴
- 포트 데이터 타입이 맞는지 확인합니다.
- 고급 출력 포트를 켜야 보이는 출력인지 확인합니다.
- 검색 탭에서 직접 찾아 추가합니다.
결과가 비어 있음
- 최종 결과 노드가 있는지 확인합니다.
- 최종 결과 노드가 실제 출력에 연결됐는지 확인합니다.
- 디버그 모드를 켜고 중간 아티팩트를 확인합니다.
자동 실행이 멈춤
워크플로우 구조가 바뀌면 자동 실행이 재검토 상태로 멈출 수 있습니다. 예약작업 탭에서 변경 내용을 확인한 뒤 다시 활성화합니다.