정의 #
모든 결과가 출력될 때까지 배열 요소에 대해 동일한 작업을 순차적으로 수행하여 작업 배치 프로세서 역할을 합니다. 반복 노드는 일반적으로 배열 변수와 함께 작동합니다.예를 들어, 긴 텍스트 번역을 처리할 때 모든 콘텐츠를 LLM 노드에 직접 입력하면 단일 대화 제한에 도달할 수 있습니다. 이 문제를 해결하기 위해 업스트림 노드는 먼저 긴 텍스트를 여러 개의 청크로 분할한 다음, 반복 노드를 사용하여 일괄 번역을 수행하여 단일 LLM 대화의 메시지 제한을 피합니다.
기능 설명 #
반복 노드를 사용하려면 입력 값을 목록 객체로 포맷해야 합니다. 이 노드는 반복 시작 노드부터 배열 변수의 모든 요소를 순차적으로 처리하며, 각 요소에 동일한 처리 단계를 적용합니다. 각 처리 주기를 반복이라고 하며, 최종 출력으로 마무리됩니다.반복 노드는 입력 변수 , 반복 워크플로 , 출력 변수라는 세 가지 핵심 구성 요소로 구성됩니다 .입력 변수: 배열 유형 데이터만 허용합니다.반복 워크플로: 반복 노드 내에서 작업 순서를 조정하기 위해 여러 워크플로 노드를 지원합니다.출력 변수: 배열 변수( Array[List])만 출력합니다.
시나리오 #
예제 1: 긴 기사 반복 생성기 #
- 시작 노드 에 스토리 제목과 개요를 입력합니다 .
- LLM을 사용하여 사용자 입력으로부터 완전한 콘텐츠를 생성하려면 자막 및 개요 생성 노드를 사용하세요 .
- 자막 및 개요 추출 노드를 사용하여 전체 콘텐츠를 배열 형식으로 변환합니다.
- 반복 노드를 사용하여 LLM 노드를 래핑 하고 여러 반복을 통해 각 장의 콘텐츠를 생성합니다.
- 반복 노드 내부에 직접 답변 노드를 추가하여 각 반복 후에 스트리밍 출력을 얻습니다.
자세한 구성 단계
- 시작 노드 에서 스토리 제목(title)과 개요(outline)를 구성합니다 .
- ‘자막 및 개요 생성’ 노드를 사용하여 스토리 제목과 개요를 완전한 텍스트로 변환합니다.
- ‘자막 및 개요 추출’ 노드를 사용하여 스토리 텍스트를 배열(Array) 구조로 변환합니다. 추출할 매개변수는
sections이고 매개변수 유형은 입니다Array[Object].
매개변수 추출의 효율성은 모델의 추론 능력과 제공된 지침에 따라 달라집니다. 추론 능력이 더 뛰어난 모델을 사용하고 지침 에 예시를 추가하면 매개변수 추출 결과를 개선할 수 있습니다.
- 배열 형식의 스토리 개요를 반복 노드의 입력으로 사용하고 LLM 노드를 사용하여 반복 노드 내에서 이를 처리합니다 .
LLM 노드에서 입력 변수를 구성합니다 GenerateOverallOutline/output.Iteration/item
반복을 위한 내장 변수: items[object]및 index[number].items[object]각 반복에 대한 입력 항목을 나타냅니다.index[number]현재 반복 라운드를 나타냅니다.
- 반복 노드 내부에 직접 응답 노드를 구성하여 각 반복 후 스트리밍 출력을 얻습니다.
- 디버깅과 미리보기가 완료되었습니다.
예 2: 긴 기사 반복 생성기(또 다른 배열) #
- 시작 노드 에 스토리 제목과 개요를 입력합니다 .
- LLM 노드를 사용하여 기사의 하위 제목과 해당 내용을 생성합니다.
- 코드 노드를 사용하여 전체 내용을 배열 형식으로 변환합니다.
- 반복 노드를 사용하여 LLM 노드를 래핑 하고 여러 반복을 통해 각 장의 콘텐츠를 생성합니다.
- 템플릿 변환 노드를 사용하여 반복 노드의 문자열 배열 출력을 다시 문자열로 변환합니다.
- 마지막으로, 변환된 문자열을 직접 출력하기 위해 직접 응답 노드를 추가합니다.
고급 기능 #
병렬 모드 #
반복 노드는 병렬 처리를 지원하여 활성화 시 실행 효율성이 향상됩니다.
아래는 반복 노드에서 병렬 실행과 순차 실행을 비교한 것입니다.
병렬 모드는 최대 10개의 동시 반복을 지원합니다. 10개 이상의 작업을 처리할 때 처음 10개 요소는 동시에 실행되고, 나머지 작업은 초기 배치가 완료된 후 처리됩니다.
잠재적인 오류를 방지하려면 반복 노드 내에 직접 답변, 변수 할당 또는 도구 노드를 배치하지 마세요.
- 오류 응답 방법
반복 노드는 여러 작업을 처리하며, 요소 처리 중에 오류가 발생할 수 있습니다. 단일 오류로 인해 모든 작업이 중단되는 것을 방지하려면 다음과 같이 오류 응답 방법을 구성하세요 .
- 종료 : 예외가 감지되면 반복 노드를 종료하고 오류 메시지를 출력합니다.
- 오류 발생 시 계속 : 오류 메시지를 무시하고 나머지 요소 처리를 계속합니다. 출력에는 성공 결과가 포함되고 오류의 경우 null 값이 포함됩니다.
- 비정상 출력 제거 : 오류 메시지를 무시하고 나머지 요소 처리를 계속합니다. 출력에는 성공 결과만 포함됩니다.
입력 변수와 출력 변수는 일대일 대응 관계를 유지합니다. 예를 들면 다음과 같습니다.
- 입력: [1, 2, 3]
- 출력: [결과-1, 결과-2, 결과-3]
오류 처리 예:
- 오류가 발생해도 계속 진행 : [result-1, null, result-3]
- 비정상 출력 제거 : [result-1, result-3]
참조 #
배열 형식의 콘텐츠를 얻는 방법 #
배열 변수는 다음 노드를 반복 노드 입력으로 생성할 수 있습니다.
배열을 텍스트로 변환하는 방법 #
반복 노드의 출력 변수가 배열 형식이므로 직접 출력할 수 없습니다. 간단한 단계를 통해 배열을 다시 텍스트로 변환할 수 있습니다.코드 노드를 사용하여 변환
코드 예:복사AI에게 물어보세요
def main(articleSections: list):
data = articleSections
return {
"result": "/n".join(data)
}
템플릿 노드를 사용하여 변환
코드 예:복사AI에게 물어보세요
{{ articleSections | join("/n") }}
