<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="definition">정의</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>모든 결과가 출력될 때까지 배열 요소에 대해 동일한 작업을 순차적으로 수행하여 작업 배치 프로세서 역할을 합니다. 반복 노드는 일반적으로 배열 변수와 함께 작동합니다.예를 들어, 긴 텍스트 번역을 처리할 때 모든 콘텐츠를 LLM 노드에 직접 입력하면 단일 대화 제한에 도달할 수 있습니다. 이 문제를 해결하기 위해 업스트림 노드는 먼저 긴 텍스트를 여러 개의 청크로 분할한 다음, 반복 노드를 사용하여 일괄 번역을 수행하여 단일 LLM 대화의 메시지 제한을 피합니다.</p>
<!-- /wp:paragraph -->

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

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="functional-description"><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#functional-description">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#functional-description"></a>기능 설명</h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>반복 노드를 사용하려면 입력 값을 목록 객체로 포맷해야 합니다. 이 노드는 반복 시작 노드부터 배열 변수의 모든 요소를 순차적으로 처리하며, 각 요소에 동일한 처리 단계를 적용합니다. 각 처리 주기를 반복이라고 하며, 최종 출력으로 마무리됩니다.반복 노드는 <strong>입력 변수</strong> , <strong>반복 워크플로</strong> , <strong>출력 변수라는</strong> 세 가지 핵심 구성 요소로 구성됩니다 .</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>입력 변수:</strong> 배열 유형 데이터만 허용합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>반복 워크플로:</strong> 반복 노드 내에서 작업 순서를 조정하기 위해 여러 워크플로 노드를 지원합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>출력 변수:</strong> 배열 변수( <code>Array[List]</code>)만 출력합니다.</p>
<!-- /wp:paragraph -->

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

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="scenarios"><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#scenarios">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#scenarios"></a>시나리오</h3>
<!-- /wp:heading -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="example-1%3a-long-article-iteration-generator"><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#example-1%3A-long-article-iteration-generator">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#example-1%3A-long-article-iteration-generator"></a><strong>예제 1: 긴 기사 반복 생성기</strong></h4>
<!-- /wp:heading -->

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

<!-- wp:list {"ordered":true} -->
<ol class="wp-block-list"><!-- wp:list-item -->
<li><strong>시작 노드</strong>&nbsp;에 스토리 제목과 개요를 입력합니다&nbsp;.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>LLM을 사용하여 사용자 입력으로부터 완전한 콘텐츠를 생성하려면 <strong>부제 및 개요 생성(<strong>Generate Subtitles and Outlines</strong></strong>)<strong> 노드를</strong> 사용하세요 .</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>부제 및 개요 추출 노드를</strong> 사용하여 전체 콘텐츠를 배열 형식으로 변환합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>반복 노드를</strong> 사용하여 <strong>LLM 노드를</strong> 감싸고 여러 반복을 통해 각 장의 콘텐츠를 생성합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>반복 노드 내부에&nbsp;<strong>직접 답변 노드를</strong>&nbsp;추가하여 각 반복 후에 스트리밍 출력을 얻습니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:paragraph -->
<p><strong>자세한 구성 단계</strong></p>
<!-- /wp:paragraph -->

<!-- wp:list {"ordered":true} -->
<ol class="wp-block-list"><!-- wp:list-item -->
<li><strong>시작 노드</strong>&nbsp;에서 스토리 제목(title)과 개요(outline)를 구성합니다&nbsp;.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

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

<!-- wp:list {"ordered":true,"start":2} -->
<ol start="2" class="wp-block-list"><!-- wp:list-item -->
<li><strong>‘부제 및 개요 생성’ 노드를</strong> 사용하여 스토리 제목과 개요를 완전한 텍스트로 변환합니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:image {"id":720,"width":"840px","height":"auto","sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large is-resized"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-40-432x1024.png" alt="" class="wp-image-720" style="width:840px;height:auto"/></figure>
<!-- /wp:image -->

<!-- wp:list {"ordered":true,"start":3} -->
<ol start="3" class="wp-block-list"><!-- wp:list-item -->
<li><strong>‘부제 및 개요 추출’ 노드를</strong> 사용하여 스토리 텍스트를 배열(Array) 구조로 변환합니다. 추출할 매개변수는 <code>sections</code>이고 매개변수 유형은 <code>Array[Object]</code> 입니다 .</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

<!-- wp:image {"id":721,"width":"840px","height":"auto","sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large is-resized"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-41-563x1024.png" alt="" class="wp-image-721" style="width:840px;height:auto"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p>매개변수 추출의 효율성은 모델의 추론 능력과 제공된 지침에 따라 달라집니다. 추론 능력이 더 뛰어난 모델을 사용하고&nbsp;<strong>지침</strong>&nbsp;에 예시를 추가하면 매개변수 추출 결과를 개선할 수 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:list {"ordered":true,"start":4} -->
<ol start="4" class="wp-block-list"><!-- wp:list-item -->
<li>배열 형식의 스토리 개요를 반복 노드의 입력으로 사용하고&nbsp;<strong>LLM 노드를</strong>&nbsp;사용하여 반복 노드 내에서 이를 처리합니다 .</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

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

<!-- wp:paragraph -->
<p>LLM 노드에서 입력 변수 <code>GenerateOverallOutline/output</code> 와 <code>Iteration/item</code> 를 구성합니다</p>
<!-- /wp:paragraph -->

<!-- wp:image {"id":723,"width":"813px","height":"auto","sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large is-resized"><img src="http://192.168.101.245/wp-content/uploads/2025/09/image-43-448x1024.png" alt="" class="wp-image-723" style="width:813px;height:auto"/></figure>
<!-- /wp:image -->

<!-- wp:paragraph -->
<p></p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p></p>
<!-- /wp:paragraph -->

<!-- wp:list {"ordered":true,"start":5} -->
<ol start="5" class="wp-block-list"><!-- wp:list-item -->
<li><strong>반복 노드 내부에 직접 응답 노드를</strong>&nbsp;구성하여&nbsp;각 반복 후 스트리밍 출력을 얻습니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

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

<!-- wp:list {"ordered":true,"start":6} -->
<ol start="6" class="wp-block-list"><!-- wp:list-item -->
<li>디버깅과 미리보기를 완료합니다.</li>
<!-- /wp:list-item --></ol>
<!-- /wp:list -->

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

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="example-2%3a-long-article-iteration-generator-another-arrangement"><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#example-2%3A-long-article-iteration-generator-another-arrangement">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#example-2%3A-long-article-iteration-generator-another-arrangement"></a><strong>예 2: 긴 기사 반복 생성기(또 다른 배열)</strong></h4>
<!-- /wp:heading -->

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

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li><strong>시작 노드</strong>&nbsp;에 스토리 제목과 개요를 입력합니다&nbsp;.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>LLM 노드를</strong>&nbsp;사용하여&nbsp;기사의 하위 제목과 해당 내용을 생성합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>코드 노드를</strong>&nbsp;사용하여&nbsp;전체 내용을 배열 형식으로 변환합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>반복 노드를</strong> 사용하여 <strong>LLM 노드를</strong> 감싸고 여러 반복을 통해 각 장의 콘텐츠를 생성합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>템플릿 변환</strong>&nbsp;노드를 사용하여&nbsp;반복 노드의 문자열 배열 출력을 다시 문자열로 변환합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li>마지막으로,&nbsp;변환된 문자열을 직접 출력하기 위해&nbsp;<strong>직접 응답 노드를 추가합니다.</strong></li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

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

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading" id="advanced-feature"><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#advanced-feature">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#advanced-feature"></a>고급 기능</h3>
<!-- /wp:heading -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="parallel-mode"><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#parallel-mode">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#parallel-mode"></a>병렬 모드</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>반복 노드는 병렬 처리를 지원하여 활성화 시 실행 효율성이 향상됩니다.</p>
<!-- /wp:paragraph -->

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

<!-- wp:paragraph -->
<p>아래는 반복 노드에서 병렬 실행과 순차 실행을 비교한 것입니다.</p>
<!-- /wp:paragraph -->

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

<!-- wp:paragraph -->
<p>병렬 모드는 최대 10개의 동시 반복을 지원합니다. 10개 이상의 작업을 처리할 때 처음 10개 요소는 동시에 실행되고, 나머지 작업은 초기 배치가 완료된 후 처리됩니다.</p>
<!-- /wp:paragraph -->

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

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading" id="how-to-convert-an-array-to-text"><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#how-to-convert-an-array-to-text">​</a><a href="https://docs.dify.ai/en/guides/workflow/node/iteration#how-to-convert-an-array-to-text"></a>배열을 텍스트로 변환하는 방법</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>반복 노드의 출력 변수가 배열 형식이므로 직접 출력할 수 없습니다. 간단한 단계를 통해 배열을 다시 텍스트로 변환할 수 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p><strong>코드 노드를 사용하여 변환</strong></p>
<!-- /wp:paragraph -->

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

<!-- wp:paragraph -->
<p>코드 예:</p>
<!-- /wp:paragraph -->

<!-- wp:code -->
<pre class="wp-block-code"><code>def main(articleSections: list):
    data = articleSections
    return {
        "result": "/n".join(data)
    }
</code></pre>
<!-- /wp:code -->

<!-- wp:paragraph -->
<p><strong>템플릿 노드를 사용하여 변환</strong></p>
<!-- /wp:paragraph -->

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

<!-- wp:paragraph -->
<p>코드 예:</p>
<!-- /wp:paragraph -->

<!-- wp:code -->
<pre class="wp-block-code"><code>{{ articleSections | join("/n") }}
</code></pre>
<!-- /wp:code -->