# 그룹

> 노드를 그룹 프레임에 끌어다 놓아 캔버스를 정리하세요. 색상으로 구역을 표시하고, 그룹의 출력으로 멤버의 결과를 유형별로 넘길 수 있습니다.

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

**그룹** 노드는 캔버스에서 관련된 노드를 정리하는 프레임입니다. 노드를 프레임 안으로 끌어다 놓으면 프레임과 함께 움직입니다. 프레임에 색상을 입혀 “레퍼런스”나 “생성” 같은 이름 있는 구역을 표시하세요. 그룹에는 멤버의 결과 유형마다 출력이 하나씩 있으므로, 멤버의 텍스트, 이미지, 동영상, 오디오를 한꺼번에 넘길 수도 있습니다. 무료입니다.

- Found in: Automate › Canvas
- Output: data
- API type: `group`

## 사용 시기
- 큰 워크플로를 이름과 색상이 있는 구역으로 나눕니다.
- 관련된 노드를 캔버스에서 옮길 때 함께 움직이게 합니다.
- 프레임 안에 있는 여러 이미지 노드의 그림을 [이미지 콜라주](https://nodaro.ai/docs/nodes/image/image-collage) 하나로 보냅니다. 예를 들어 [Telegram 게시물](https://nodaro.ai/docs/nodes/publish/telegram-post)로 그림 한 장을 게시할 때 씁니다.
- 여러 [텍스트](https://nodaro.ai/docs/nodes/automate/text) 노드의 텍스트를 목록 하나로 모아 [목록 병합](https://nodaro.ai/docs/nodes/automate/merge-lists)에 넘깁니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab 키를 누르고 **자동화 › 캔버스 › 그룹**을 선택하세요. 프레임을 선택하고 가장자리를 끌어 크기를 조정하세요. 빈 프레임에는 “여기에 노드를 놓으세요”라고 표시됩니다.

### 노드 끌어다 놓기
노드를 끌어서 70% 이상이 프레임 안에 들어간 상태에서 놓으세요. 노드가 멤버가 되어 그룹과 함께 움직입니다.

### 이름과 색상 지정
그룹의 레이블을 더블클릭해 이름을 바꾸세요. 그룹을 선택하면 위쪽에 색상 막대가 나타나며, 여기서 색상을 고르세요.

### 출력 사용
어떤 유형의 멤버가 프레임 안에 들어오는 즉시 그룹에 그 유형의 출력이 나타납니다. 다른 출력과 똑같이 연결하세요.

Workflow: 그룹의 이미지 출력이 멤버 세 개의 그림을 이미지 콜라주에 넘기고, 콜라주가 Telegram에 게시됩니다.

- 그룹 → 이미지 콜라주 (이미지)
- 이미지 콜라주 → Telegram 게시물

## 멤버
- **들어가기.** 노드를 놓는 순간 노드의 70% 이상이 프레임 안에 있으면 멤버가 됩니다.
- **나가기.** 멤버를 끌어 30% 넘게 프레임 밖으로 나가면 그룹에서 빠집니다.
- **함께 움직이기.** 그룹을 끌면 멤버도 함께 움직입니다.

## 출력
그룹에는 멤버의 결과 유형마다 출력이 하나씩 있습니다. **텍스트**, **이미지**, **동영상**, **오디오**입니다. 아무것도 실행하기 전이라도, 그 유형의 멤버가 프레임 안에 들어오는 즉시 출력이 나타납니다.

- 각 출력은 그 유형의 멤버 결과를 목록으로 보냅니다. 예를 들어 그룹 안에 [텍스트](https://nodaro.ai/docs/nodes/automate/text) 노드 3개와 [이미지 생성](https://nodaro.ai/docs/nodes/image/generate-image) 1개가 있으면, 항목 3개가 든 텍스트 출력과 항목 1개가 든 이미지 출력이 생깁니다.
- 각 출력은 [수집](https://nodaro.ai/docs/nodes/automate/collect)의 출력처럼 유형을 유지합니다. **이미지** 출력은 이미지 입력에, **동영상** 출력은 동영상 입력에 연결되는 식입니다.
- 목록은 이미지 콜라주나 목록 병합처럼 항목 여러 개를 쓰는 노드에 알맞습니다. 값 하나만 받는 입력에는 첫 번째 항목만 전달됩니다.

주된 결과가 텍스트, 이미지, 동영상, 오디오인 멤버만 포함됩니다. 그룹은 [목록](https://nodaro.ai/docs/nodes/automate/list)이나 목록 병합처럼 출력이 여러 개인 멤버와, [조명](https://nodaro.ai/docs/nodes/creative-controls/lighting)이나 [프레이밍](https://nodaro.ai/docs/nodes/creative-controls/framing) 같은 피커를 건너뜁니다. 이런 노드에는 [수집](https://nodaro.ai/docs/nodes/automate/collect)을 사용하세요.

## 색상
그룹을 선택하면 위쪽에 색상 막대가 나타납니다. 스티커 메모와 같은 색상에 **색상 없음**이 더해져 있습니다.

| 선택 | 그룹의 모양 |
| --- | --- |
| **색상 없음**(기본값) | 차분한 회색 프레임이며, 위쪽에 작은 캡션이 붙습니다. |
| 색상 | 프레임에 색조가 입혀지고, 레이블이 프레임 위쪽에 같은 색상의 배너로 바뀝니다. |

배너는 그룹의 높이에 맞춰 커지므로, 워크플로 전체를 보려고 축소해도 제목을 읽을 수 있습니다. 색상은 시각적 요소일 뿐이며, 멤버, 출력, 워크플로의 실행 방식은 바뀌지 않습니다.

## 크레딧
그룹은 무료입니다. 실행되는 단계가 아니라 캔버스 위의 프레임입니다.

## 팁
- **용도별로 색을 칠하세요.** 예를 들어 청록색 “레퍼런스” 구역이 분홍색 “생성” 구역으로 이어지면, 워크플로의 흐름을 한눈에 볼 수 있습니다.
- **구역을 설명하세요.** 그룹 안이나 옆에 [스티커 메모](https://nodaro.ai/docs/nodes/automate/sticky-note)를 두어 그 구역이 하는 일을 적으세요.
- **순서가 중요하면 수집을 고르세요.** 그룹의 멤버는 캔버스에서 놓인 위치로 정해집니다. 명시적인 연결과 직접 정한 순서가 필요하면 [수집](https://nodaro.ai/docs/nodes/automate/collect)을 사용하세요.
- **재사용하려면 하위 워크플로를 고르세요.** 그룹은 캔버스 하나를 정리합니다. 노드 묶음을 다른 워크플로에서 재사용하려면 [하위 워크플로](https://nodaro.ai/docs/nodes/automate/sub-workflow)로 만드세요.

## 자주 묻는 질문

### 노드를 그룹에 넣으려면 어떻게 하나요?

노드를 끌어서 70% 이상이 그룹 프레임 안에 들어간 상태에서 놓으세요. 그룹에서 빼려면 노드의 30% 넘게 프레임 밖으로 나갈 때까지 끄세요.

### 그룹의 출력은 무엇을 보내나요?

그룹에는 멤버의 결과 유형인 텍스트, 이미지, 동영상, 오디오마다 출력이 하나씩 있습니다. 각 출력은 그 유형의 멤버 결과를 목록으로 보냅니다. 예를 들어 텍스트 노드 3개와 이미지 생성 1개가 있으면, 항목 3개가 든 텍스트 출력과 항목 1개가 든 이미지 출력이 생깁니다.

### 그룹의 색상에 따라 작동 방식이 달라지나요?

아니요. 색상은 프레임의 모양만 바꿉니다. 멤버, 출력, 워크플로의 실행 방식은 바뀌지 않습니다.

### 그룹 안에 있는 노드가 출력에서 빠진 이유는 무엇인가요?

그룹은 목록이나 목록 병합처럼 출력이 여러 개인 노드와, 조명이나 프레이밍 같은 피커를 건너뜁니다. 이런 노드의 결과를 모으려면 수집 노드에 연결하세요.

### 그룹 노드에 크레딧이 드나요?

아니요. 그룹은 실행되는 단계가 아니라 캔버스 위의 프레임이며, 무료입니다.
