<!-- wp:paragraph -->
<p>파일 리스트 변수는 문서 파일, 이미지, 오디오, 비디오 파일 등 여러 파일 유형을 동시에 업로드할 수 있도록 지원합니다. 애플리케이션 사용자가 파일을 업로드하면 모든 파일이 동일한 <code>Array[File]</code>배열 유형 변수 에 저장되므로 <strong>이후 개별 파일 처리에 적합하지 않습니다.</strong></p>
<!-- /wp:paragraph -->

<!-- wp:quote -->
<blockquote class="wp-block-quote"><!-- wp:paragraph -->
<p>데이터&nbsp;<code>Array</code>유형은 변수의 실제 값이 [1.mp3, 2.png, 3.doc]일 수 있음을 의미합니다. LLM은 이미지 파일이나 텍스트 콘텐츠와 같은 단일 값만 입력 변수로 읽을 수 있으며, 배열 변수를 직접 읽을 수는 없습니다.</p>
<!-- /wp:paragraph --></blockquote>
<!-- /wp:quote -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="node-functionality"><a href="https://docs.dify.ai/en/guides/workflow/node/list-operator#node-functionality">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/list-operator#node-functionality"></a>노드 기능</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>목록 연산자는 파일 형식 유형, 파일 이름, 크기와 같은 속성을 필터링하고 추출하여 다양한 형식의 파일을 해당 처리 노드에 전달하여 다양한 파일 처리 흐름을 정밀하게 제어할 수 있습니다.예를 들어, 사용자가 문서 파일과 이미지 파일을 동시에 업로드할 수 있는 애플리케이션에서 서로 다른 파일을 <strong>목록 작업 노드를</strong> 통해 정렬해야 하며 , 서로 다른 파일은 서로 다른 프로세스에 의해 처리되어야 합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":694,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-25-1024x419.png" alt="" class="wp-image-694"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p>리스트 연산 노드는 일반적으로 배열 변수에서 정보를 추출하여, 조건 설정을 통해 하위 노드에서 수용할 수 있는 변수 유형으로 변환하는 데 사용됩니다. 리스트 연산 노드의 구조는 입력 변수, 필터 조건, 정렬, 처음 N개 항목 가져오기, 그리고 출력 변수로 나뉩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":695,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-26-1024x685.png" alt="" class="wp-image-695"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p><strong>입력 변수</strong>목록 작업 노드는 다음 데이터 구조를 가진 변수만 허용합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>배열[문자열]</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>배열[숫자]</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>배열[파일]</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p><strong>필터 조건</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>필터 조건을 추가하여 입력 변수의 배열을 처리합니다. 배열의 조건을 충족하는 모든 배열 변수를 정렬합니다. 이는 변수의 속성을 필터링하는 것으로 이해할 수 있습니다.예: 파일에는 파일 이름, 파일 유형, 파일 크기 등 여러 차원의 속성이 포함될 수 있습니다. 필터 조건을 사용하면 배열 변수에서 특정 파일을 선택하고 추출하기 위한 스크리닝 조건을 설정할 수 있습니다.다음 변수 추출을 지원합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>유형: 이미지, 문서, 오디오, 비디오 유형을 포함한 파일 범주</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>크기: 파일 크기</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>이름: 파일 이름</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>url: URL을 통해 애플리케이션 사용자가 업로드한 파일을 참조합니다. 필터링을 위해 전체 URL을 입력할 수 있습니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>확장자: 파일 확장자</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>mime_type:&nbsp;<a href="https://datatracker.ietf.org/doc/html/rfc2046" target="_blank" rel="noreferrer noopener">MIME 유형은</a>&nbsp;파일 콘텐츠 유형을 식별하는 데 사용되는 표준화된 문자열입니다. 예: “text/html”은 HTML 문서를 나타냅니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>transfer_method: 파일 업로드 방법으로 로컬 업로드와 URL 업로드로 구분됨</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p><strong>정렬</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>파일 속성에 따른 정렬을 지원하여 입력 변수의 배열을 정렬하는 기능을 제공합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>오름차순(ASC): 기본 정렬 옵션으로, 작은 것부터 큰 것 순으로 정렬합니다. 문자와 텍스트는 알파벳순(A – Z)으로 정렬합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>내림차순(DESC): 큰 것부터 작은 것 순으로 정렬하며, 문자와 텍스트는 알파벳 역순(Z – A)으로 정렬합니다.</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p>이 옵션은 종종 출력 변수의 first_record 및 last_record와 함께 사용됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>첫 번째 N개 항목 가져오기</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>1~20 사이의 값을 선택할 수 있으며, 이는 배열 변수의 처음 n개 항목을 선택하는 데 사용됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>출력 변수</strong></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>모든 필터 조건을 충족하는 배열 요소입니다. 필터 조건, 정렬 및 제한 사항은 개별적으로 활성화할 수 있습니다. 동시에 활성화하면 모든 조건을 충족하는 배열 요소가 반환됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li>결과: 필터링 결과, 데이터 유형은 배열 변수입니다. 배열에 파일이 하나만 포함된 경우, 출력 변수에는 배열 요소가 하나만 포함됩니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>first_record: 필터링된 배열의 첫 번째 요소, 즉 result[0]</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>last_record: 필터링된 배열의 마지막 요소, 즉 result[array.length-1].</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="configuration-example"><a href="https://docs.dify.ai/en/guides/workflow/node/list-operator#configuration-example">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/list-operator#configuration-example"></a>구성 예</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>파일 상호작용 Q&amp;A 시나리오에서 애플리케이션 사용자는 문서 파일이나 이미지 파일을 동시에 업로드할 수 있습니다. LLM은 이미지 파일 인식 기능만 지원하며 문서 파일 읽기 기능은 지원하지 않습니다. 이 경우, 파일 변수 배열을 전처리하고 다양한 파일 유형을 해당 처리 노드로 전송하기 위해 리스트 작업 노드가 필요합니다. 오케스트레이션 단계는 다음과 같습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list {"ordered":true} -->
<ol class="wp-block-list"><!-- wp:list-item -->
<li>Features(특징) 기능을 활성화 하고 파일 형식에서 “이미지”와 “문서” 유형을 모두 선택하세요.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>두 개의 목록 작업 노드를 추가하고 “목록 연산자” 조건에서 각각 이미지와 문서 변수를 추출하도록 설정합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>문서 파일 변수를 추출하여 “Doc Extractor” 노드로 전달합니다. 이미지 파일 변수를 추출하여 “LLM” 노드로 전달합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>LLM 노드의 출력 변수를 채워서 마지막에 “답변” 노드를 추가합니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:image {"id":697,"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-28-1024x207.png" alt="" class="wp-image-697"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p>애플리케이션 사용자가 문서 파일과 이미지를 모두 업로드하면 문서 파일은 자동으로 문서 추출 노드로, 이미지 파일은 자동으로 LLM 노드로 전환되어 혼합된 파일의 공동 처리가 달성됩니다.</p>
<!-- /wp:paragraph -->