선택기
목록에서 위치, 범위, 무작위 샘플, 규칙, 이름으로 항목 하나나 일부를 고르세요. 선택기는 고른 항목과 나머지를 두 출력으로 무료로 보냅니다.
선택기 노드는 목록에서 항목 하나나 여러 개를 고릅니다. 고르는 방법은 위치, 범위, 무작위, 필드에 대한 규칙, 이름 중에서 선택합니다. 선택기는 고른 항목을 선택됨 출력으로, 나머지 모든 항목을 나머지 출력으로 보냅니다. 즉시 실행되며, 모델을 호출하지 않고 크레딧도 들지 않습니다.
사용 시기
- 같은 선택을 여러 노드에 보낼 때. 선택기 하나가 여러 연결의 같은 설정을 대신합니다.
- 목록에서 무작위 항목 하나를 고르고, 나중에 시드로 같은 선택을 반복하고 싶을 때.
- 필드가 특정 값인 항목을 원할 때. 예를 들어 이름이
hero인 캐릭터나 점수가 15 이상인 모든 항목입니다. - 고르지 않은 항목을 나머지 출력으로 다른 곳에 보내고 싶을 때.
- 다른 노드의 숫자로 짧은 목록을 순환하고 싶을 때.
빠른 시작
노드 추가
캔버스에서 Tab을 누르고 자동화 › 목록 및 일괄 처리 › 선택기를 선택하세요.
모드 선택
설정 패널을 열고 모드를 고른 다음 그 필드를 채우세요. 각 모드는 아래에서 설명합니다.
출력 연결 후 실행
선택됨을 다음 노드에 연결하고, 다른 항목이 필요하면 나머지를 다른 분기에 연결하세요. 실행한 뒤에는 패널의 마지막 실행 아래에 “선택 2개 · 나머지 3개”처럼 개수가 표시됩니다.
입력과 출력
| 입력 또는 출력 | 받거나 보내는 것 | 기능 |
|---|---|---|
| 목록 | 텍스트, 이미지, 동영상, 오디오, JSON 항목의 목록 | 항목을 고를 목록입니다. 여러 노드를 연결하면 연결한 순서대로 목록이 이어집니다. |
| 선택됨 | 목록 | 모드가 고른 항목을 원래 목록의 순서대로 보냅니다. 항목 하나를 고르는 모드는 항목이 하나인 목록을 보냅니다. |
| 나머지 | 목록 | 고르지 않은 모든 항목을 원래 순서대로 보냅니다. |
선택기는 항상 연결된 목록 전체를 다룹니다. 개별 연결에서도 항목마다가 아니라 한 번만 실행됩니다.
선택됨과 나머지를 합치면 항상 모든 입력 항목이 되며, 두 곳에 모두 들어가는 항목은 없습니다. 선택기는 값이 아니라 위치로 나누므로 중복 항목도 올바른 쪽으로 갑니다. 예를 들어 a, b, a, c에서 2부터 3까지의 범위를 고르면 선택됨은 b, a, 나머지는 a, c입니다.
모드
| 모드 | 필드 | 고르는 수 | 예 |
|---|---|---|---|
| 항목(단일 인덱스) | 인덱스 | 1개 | a, b, c, d에서 인덱스 last-1은 c를 고릅니다. |
| 범위(시작/끝/간격) | 시작, 끝, 간격 | 여러 개 | a, b, c, d, e에서 2부터 4까지는 b, c, d를 고릅니다. |
| 목록(쉼표 구분 식) | 표현식 | 여러 개 | a, b, c, d, e에서 식 1, 3, 5는 a, c, e를 고릅니다. |
| 무작위(시드 지정) | 시드(선택 사항), 개수 | 개수만큼 | a, b, c, d에서 시드 42와 개수 2는 항상 같은 두 항목을 고릅니다. |
| 나머지(인덱스로 순환) | 나누는 수 | 1개 | a, b, c에서 나누는 수 5는 c를 고릅니다. |
| 조건(필터) | 필드, 연산자, 값, 일치 항목, 대소문자 구분 | 1개 또는 일치하는 모든 항목 | score 필드가 있는 항목에서 score 이상 15로 정하고 일치 항목을 전체로 설정하면 점수가 15 이상인 모든 항목을 고릅니다. |
| 이름 키(조회) | 필드, 값 | 0개 또는 1개 | name 필드가 있는 캐릭터에서 name = hero는 hero를 고릅니다. |
항목
인덱스는 1부터 셉니다. 3 같은 숫자를 쓰거나, last와 last-1, last-2 등으로 끝에서부터 세세요. 목록 끝을 넘는 인덱스는 가장 가까운 유효한 항목을 사용합니다. 읽을 수 없는 인덱스는 첫 번째 항목을 사용합니다.
범위
시작과 끝은 모두 범위에 포함되며 1부터 셉니다. 음수 간격은 큰 시작에서 작은 끝으로 거꾸로 진행합니다. 고른 항목은 원래 목록의 순서를 유지합니다. a, b, c, d에서 last부터 1까지 간격 -2는 b, d를 고릅니다. 간격 0은 1로 처리됩니다. 앞으로 진행하는 범위에 음수 간격을 쓰거나, 뒤로 진행하는 범위에 양수 간격을 쓰면 아무것도 고르지 않습니다.
목록
표현식은 단일 위치와 범위를 쉼표로 구분해 섞어 씁니다. 예를 들면 1, 3..5, last입니다. 어떤 순서로 쓰든 고른 항목은 원래 목록의 순서를 유지하며, 두 번 쓴 위치는 한 번만 고릅니다. 다른 예로는 1..5, 한 항목씩 건너뛰어 고르는 1..10:2, 마지막을 뺀 모든 항목을 고르는 1..last-1이 있습니다. 읽을 수 없는 부분이 있으면 노드는 모든 항목을 고릅니다.
무작위
개수는 뽑을 항목의 수이며 기본값은 1입니다. 각 항목은 최대 한 번만 뽑히며, 목록보다 큰 개수는 목록 전체를 고릅니다. 시드가 있으면 같은 시드와 같은 목록은 항상 같은 선택을 만듭니다. 시드가 없으면 실행할 때마다 다시 뽑습니다.
나머지(인덱스로 순환)
이 모드는 나누는 수를 목록의 길이로 나누어 항목 하나를 고릅니다. 나머지가 0부터 센 위치입니다. 예를 들어 항목이 3개인 목록에서 나누는 수 5는 나머지 2를 남기며, 이는 세 번째 항목입니다. 다른 노드에서 오는 바뀌는 숫자로 짧은 목록을 순환할 때 사용하세요. 나누는 수가 숫자가 아니면 첫 번째 항목을 사용합니다.
조건
조건 모드는 필드가 테스트를 통과한 항목을 남깁니다. 항목 전체를 테스트하려면 필드를 비워 두세요. 연산자로는 다음과 같음, 다음과 같지 않음, 다음보다 큼, 다음보다 작음, 이상, 이하, 다음을 포함을 고를 수 있습니다. 다음을 포함하지 않음, 다음으로 시작, 다음으로 끝남, 다음 정규식과 일치, 존재함, 존재하지 않음도 고를 수 있습니다. 일치 항목을 첫 번째로 설정하면 선택기는 첫 번째 일치 항목만 고르고, 전체로 설정하면 일치하는 모든 항목을 고릅니다. 아무것과도 일치하지 않는 규칙은 모든 항목을 나머지 출력으로 보냅니다.
이름 키
이름 키는 이름으로 조회하기 위한 조건 모드의 간단한 형태입니다. 필드가 값과 같은 첫 번째 항목을 고릅니다. 일치하는 항목이 없으면 선택됨은 비어 있고 모든 항목이 나머지 출력으로 갑니다.
다른 노드의 값 사용
네 필드는 {CharacterName}처럼 다른 노드의 레이블을 중괄호로 감싸 받을 수 있습니다. 선택기가 실행되면 중괄호 부분이 그 노드의 값으로 바뀝니다.
| 필드 | 모드 | 주요 용도 |
|---|---|---|
| 나누는 수 | 나머지(인덱스로 순환) | 다른 노드의 숫자로 목록을 순환합니다. |
| 값 | 조건 | 각 항목을 다른 노드의 출력과 비교합니다. |
| 값 | 이름 키 | {CharacterName}처럼 다른 노드가 지정한 이름의 항목을 조회합니다. |
| 시드 | 무작위 | {Project}처럼 다른 노드에 따라 무작위 선택이 정해지게 합니다. |
다른 모든 필드는 입력한 그대로 읽힙니다. 자세한 내용은 프롬프트 변수를 참고하세요.
설정이 잘못되었을 때
선택기는 설정 때문에 워크플로를 멈추지 않습니다. 문제마다 안전한 결과가 정해져 있습니다.
| 경우 | 결과 |
|---|---|
| 목록이 연결되지 않았거나 목록이 비어 있음 | 선택됨과 나머지가 모두 비어 있습니다. 노드는 오류 없이 완료됩니다. |
| 읽을 수 없는 인덱스 | 첫 번째 항목. |
| 목록 끝을 넘는 인덱스 | 가장 가까운 유효한 항목. |
| 숫자가 아닌 나누는 수 | 첫 번째 항목. |
| 목록보다 큰 개수 | 목록 전체. |
| 아무것과도 일치하지 않는 조건 또는 이름 키 | 선택됨은 비어 있고, 나머지에 모든 항목이 들어갑니다. |
노드는 예상하지 못한 오류가 생겼을 때만 실패하며, 그때 오류 메시지를 표시합니다.
선택기와 연결 설정 중 선택
모든 연결도 항목 모드나 개별과 묶음의 범위 탭과 목록 탭으로 항목을 고를 수 있습니다. 둘은 위치를 같은 방식으로 셉니다. 연결에서는 항목이 고른 순서대로 유지됩니다. last부터 1까지 간격 -1은 목록을 뒤집고, 두 번 쓴 위치는 두 번 전달됩니다.
| 연결 설정을 사용할 때 | 선택기 노드를 사용할 때 |
|---|---|
| 다음 노드 하나에 위치, 범위, 목록으로 간단히 고르면 될 때 | 같은 선택을 다음 노드 여러 개에 보낼 때 |
| 선택을 캔버스에서 숨기고 싶을 때 | 선택이 중요해서 레이블이 붙은 노드로 보여 줄 만할 때 |
| 항목, 범위, 목록만으로 충분할 때 | 무작위, 나머지(인덱스로 순환), 조건, 이름 키가 필요할 때 |
| 출력 하나로 충분할 때 | 다른 항목을 나머지 출력으로 받고 싶을 때 |
모든 연결 모드는 목록과 일괄 처리를 참고하세요.
크레딧
선택기는 모든 에디션에서 무료입니다.
팁
- 고른 항목마다 다음 노드를 실행하세요. 선택됨은 항상 목록을 보냅니다. 고른 항목마다 다음 노드를 한 번씩 실행하려면 선택됨에서 나가는 연결을 개별로 설정하세요.
- 개수를 확인하세요. 마지막 실행에는 선택됨과 나머지로 간 항목 수가 표시되며, 규칙을 테스트하는 가장 빠른 방법입니다.
- 여러 개를 거르고, 하나를 고르세요. 여러 조건과 일치하는 모든 항목을 남기려면 목록 필터를 사용하세요. 항목 하나나 일부 구간을 고르려면 선택기를 사용하세요.
자주 묻는 질문
선택기 노드와 연결의 항목 모드는 무엇이 다른가요?
연결의 항목, 범위, 목록 선택은 다음 노드 하나를 위한 간단한 선택이며 캔버스에 보이지 않습니다. 선택기 노드는 선택을 레이블이 붙은 노드로 보여 주고 여러 노드에 보낼 수 있습니다. 고르지 않은 항목을 “나머지” 출력으로 보내며, 무작위, 나머지(인덱스로 순환), 조건, 이름 키 모드도 제공합니다.
무작위 선택을 똑같이 반복할 수 있나요?
네. 시드를 입력하세요. 같은 시드와 같은 목록은 항상 같은 선택을 만듭니다. 실행할 때마다 새로 무작위로 고르려면 시드를 비워 두세요.
선택기 설정이 잘못되면 어떻게 되나요?
워크플로는 계속 실행됩니다. 잘못된 인덱스는 첫 번째 항목을 사용합니다. 목록 끝을 넘는 인덱스는 가장 가까운 항목을 사용하고, 아무것과도 일치하지 않는 규칙은 모든 항목을 “나머지” 출력으로 보냅니다.
선택기 노드에 크레딧이 드나요?
아니요. 선택기는 모든 에디션에서 무료입니다. 즉시 실행되며 모델을 호출하지 않습니다.
고른 항목마다 다음 노드를 한 번씩 실행하려면 어떻게 하나요?
“선택됨” 출력에서 나가는 연결을 “개별”로 설정하세요. 그러면 다음 노드가 고른 항목마다 한 번씩 실행됩니다.
관련 문서
목록
목록 필터
필드 추출
라우터
목록과 일괄 처리
최종 업데이트