# 라우터

> 워크플로를 이름이 붙은 경로 하나 이상으로 보내세요. 경로를 직접 고르거나, 여러 경로를 한꺼번에 켜거나, 들어오는 데이터의 조건으로 정할 수 있습니다.

Source: https://nodaro.ai/ko/docs/nodes/automate/router

**라우터** 노드는 워크플로를 이름이 붙은 경로 하나 이상으로 보냅니다. 입력은 활성화된 모든 경로로 그대로 전달되며, 비활성 경로의 노드는 건너뜁니다. **라디오** 모드에서는 활성 경로를 직접 고르고, **체크박스** 모드에서는 여러 경로를 한꺼번에 활성화하며, **조건부** 모드에서는 들어오는 데이터의 조건이 정하게 합니다. 이 노드는 무료입니다.

- Found in: Automate › Logic & Data
- Output: data
- API type: `router`

## 사용 시기
- [동영상 크기 조정](https://nodaro.ai/docs/nodes/video/resize-video)으로 만든 9:16 릴스와 1:1 게시물처럼, 두 파이프라인 사이를 아무것도 연결 해제하지 않고 전환합니다.
- 활성 경로 두 개로, 같은 이미지에서 동영상과 섬네일을 한 번의 실행으로 만듭니다.
- 데이터에 필요할 때만 단계를 실행합니다. 예를 들어 `language`가 `en`이면 더빙 분기를 건너뜁니다.
- 여러 경로를 한꺼번에 활성화해 A/B 변형을 시험합니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab 키를 누르고 **자동화 › 로직 및 데이터 › 라우터**를 선택하세요.

### 입력 연결
넘길 값을 **입력** 입력에 연결하세요. 예를 들어 [동영상 생성](https://nodaro.ai/docs/nodes/video/generate-video)의 결과를 연결합니다. 텍스트, JSON, 이미지, 동영상, 오디오를 받습니다.

### 경로 구성
설정 패널을 열고 **모드**를 고르세요. 경로 이름을 바꾸고, 경로를 더 만들려면 **경로 추가**를 클릭하세요. 모든 경로에는 노드 오른쪽에 자체 출력이 있습니다.

### 분기 연결
각 경로의 출력을 해당 분기의 첫 번째 노드에 연결하세요.

### 활성 경로를 고르고 실행
**라디오**와 **체크박스** 모드에서는 노드나 설정 패널에서 경로를 클릭해 활성화하거나 비활성화하세요. **실행**을 클릭하세요. 활성 경로에 있는 분기만 실행됩니다.

Workflow: 라디오 모드의 라우터가 동영상을 릴스 분기로 보냅니다. 경로를 바꾸기 전까지 게시물 분기는 건너뜁니다.

- 동영상 생성 → 라우터 (입력)
- 라우터 → 동영상 크기 조정 (릴스)
- 라우터 → 동영상 크기 조정 (게시물)

## 입력과 출력
| 입력 또는 출력 | 받거나 보내는 것 | 하는 일 |
| --- | --- | --- |
| **입력** | 텍스트, JSON, 이미지, 동영상, 오디오 | 경로로 보낼 값입니다. |
| **변수** | 모든 노드의 출력 | <strong>조건부(규칙 기반)</strong> 모드에서 조건이 읽을 수 있는 값입니다. |
| 경로마다 출력 하나 | 같은 값 | 활성 경로는 입력을 그대로 넘깁니다. 비활성 경로는 아무것도 보내지 않습니다. |

## 설정
| 설정 | 하는 일 |
| --- | --- |
| **모드** | 기본값인 <strong>라디오(하나만 활성화)</strong>는 정확히 경로 하나만 활성 상태로 유지합니다. <strong>체크박스(자유롭게 조합)</strong>는 경로를 몇 개든 활성화할 수 있습니다. <strong>조건부(규칙 기반)</strong>는 실행할 때 들어오는 데이터로 정합니다. |
| **경로** | 이름이 붙은 경로입니다. 새 라우터에는 **경로 A**와 **경로 B**가 있습니다. 경로 이름을 바꾸면 캔버스에서 출력의 레이블이 바뀌며, 이름은 레이블일 뿐입니다. **경로 추가**로 최대 10개까지 늘릴 수 있습니다. 라디오와 체크박스 모드에는 경로가 2개 이상 필요하며, 조건부 모드는 1개로도 작동합니다. |

여러 경로가 활성화된 상태에서 **체크박스**에서 **라디오**로 바꾸면, 첫 번째 활성 경로만 활성 상태로 남습니다. 활성 경로가 없으면 노드에 **없음** 배지가 표시됩니다.

## 조건부 모드
**조건부(규칙 기반)** 모드에서는 데이터가 정합니다. 패널의 <strong>업스트림 샘플(첫 번째 항목)</strong>에 들어오는 첫 번째 항목이 표시되므로, 그 필드를 확인할 수 있습니다.

1. **조건 그룹** 아래의 각 그룹에는 조건이 하나 이상 있습니다. 조건은 필드, 연산자, 값으로 이루어집니다. 조건을 더 추가하려면 **조건 추가**를 클릭하고, **AND**나 **OR**를 골라 조합하세요.
2. **활성화할 경로** 아래에서, 그룹의 조건을 통과했을 때 그룹이 활성화할 경로를 체크하세요.
3. 규칙을 하나 더 만들려면 **그룹 추가**를 클릭하세요. 처음 조건부 모드로 바꾸면, 패널이 첫 번째 경로를 활성화하는 그룹 하나로 시작합니다.

조건은 [목록 필터](https://nodaro.ai/docs/nodes/automate/filter-list)의 조건과 같은 방식으로 작동하며, 연산자와 **마지막 실행 이후** 같은 날짜 바로 가기도 같습니다.

조건의 값은 다른 노드의 출력을 읽을 수 있습니다. 그 노드를 **변수** 입력에 연결하고, `{Topic}`처럼 그 노드의 레이블을 중괄호로 감싸 값에 쓰세요. 그 노드 출력의 앞뒤 공백은 무시되므로, 텍스트 생성 - 모든 LLM의 답변이 줄바꿈으로 끝나도 필드와 같다고 판단됩니다.

그룹이 합쳐지는 방식은 다음과 같습니다.

- 일치하는 그룹이 하나 이상 활성화한 경로가 실행됩니다. 여러 그룹이 활성화한 경로도 한 번만 실행됩니다.
- 일치하는 그룹이 없으면 모든 경로가 비활성 상태로 남고, 라우터 뒤의 노드를 건너뜁니다.
- 그룹이 없는 라우터는 어떤 경로도 활성화하지 않습니다.

입력은 JSON이거나 JSON으로 읽히는 텍스트여야 합니다. 스크래핑한 데이터의 필드로 경로를 정하려면 [웹 스크래핑](https://nodaro.ai/docs/nodes/automate/web-scrape)을 직접 연결하세요. 데이터의 일부로 경로를 정하려면 **출력 유형**을 **JSON**으로 설정한 [필드 추출](https://nodaro.ai/docs/nodes/automate/extract-field)을 거치게 하세요.

## 크레딧
라우터는 무료입니다. 건너뛴 분기는 노드가 실행되지 않으므로 비용이 들지 않습니다.

## 팁
- **다시 연결하지 않고 전환하세요.** 두 분기를 모두 연결해 두고 라디오 모드에서 경로를 바꾸세요. 워크플로가 두 버전 모두에 대해 준비된 상태로 유지됩니다.
- **경로에 이름을 붙이세요.** “릴스”나 “더빙”이라는 경로가 캔버스에서 “경로 A”보다 알아보기 쉽습니다.
- **빈 경로를 끄기 스위치로 쓰세요.** 뒤에 노드가 없는 경로는 아무 일도 하지 않으므로, “끄기”라는 라디오 경로가 분기 전체를 멈춥니다.

## 자주 묻는 질문

### 다시 연결하지 않고 워크플로의 두 버전을 오가려면 어떻게 하나요?

버전마다 경로가 하나씩 있는 라디오 모드의 라우터를 추가하고, 각 경로를 해당 분기에 연결하세요. 실행하기 전에 경로를 고르세요. 그 분기만 실행되고, 다른 경로의 노드는 건너뜁니다.

### 라우터로 여러 분기를 한꺼번에 실행할 수 있나요?

네. 체크박스 모드에서는 경로를 원하는 대로 조합해 활성화할 수 있으며, 활성화된 모든 경로가 같은 실행에서 실행됩니다.

### 조건부 모드는 어떤 경로를 실행할지 어떻게 정하나요?

조건 그룹이 들어오는 JSON의 필드를 검사합니다. 그룹의 조건을 통과하면, 그 그룹은 “활성화할 경로”에서 체크한 경로를 활성화합니다. 일치하는 모든 그룹의 결과가 합쳐지며, 일치하는 그룹이 없으면 어떤 경로도 실행되지 않습니다.

### 비활성 경로에 있는 노드는 어떻게 되나요?

건너뛰며, 그 뒤에 오는 노드도 건너뜁니다. 뒤에 노드가 없는 경로는 아무 일도 하지 않습니다.

### 라우터 노드에 크레딧이 드나요?

아니요. 라우터는 무료입니다. 어떤 분기를 실행할지만 정합니다.