Get Started
노드 사용법 익히기 - 루프(Loop) 노드
이 튜토리얼에서는 에이전트리아(Agentria) 의 루프(Loop) 노드 사용법을 안내합니다. 루프 노드는 Loop Condition에 입력한 조건식이 참(True)인 동안 연결된 노드들을 반복 실행합니다. 조건이 거짓(False)이 되면 pass 핀을 통해 다음 노드로 진행하고, 조건이 참인 동안은 loop 핀을 통해 이전 노드로 되돌아가 과정을 반복합니다. 최대 반복 횟수에 도달하면 조건과 무관하게 루프가 종료됩니다.
이 튜토리얼에서는 전역변수 num을 0에서 시작하여 값 설정(Set Value) 노드에서 1씩 증가시키고, num이 10에 도달하면 최종값을 반환하는 '+1 카운터' 워크플로를 완성합니다.
사전 준비
에이전트리아 캔버스 진입 방법은 🔗3단계 핵심 가이드를 참고하시기 바랍니다.
이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.
전역변수를 선언하고 초기값을 설정할 수 있습니다.
루프 노드의
Loop Condition과 최대 반복 횟수를 설정할 수 있습니다.pass핀과loop핀을 구분하여 엣지(Edge)를 연결할 수 있습니다.값 설정 노드로 전역변수 값을 업데이트할 수 있습니다.
워크플로 개요
전체 흐름: 시작 노드 → 값 설정 노드 → 반복 노드 →(pass)/(loop)→ 종료 노드
이 튜토리얼의 핵심은 루프 노드와 전역변수입니다.
루프 노드는 Loop Condition 조건식이 참인 동안 loop 핀을 통해 값 설정 노드로 되돌아가 반복합니다. 전역변수 num은 값 설정 노드에서 매 반복마다 1씩 증가하며, num이 10에 도달하면 조건이 거짓이 되어 pass 핀을 통해 종료 노드로 진행됩니다.
1단계: 어빌리티 생성
에이전트리아 캔버스에서 새 어빌리티(Ability)를 생성합니다.
2단계: 워크플로 배치 및 연결
캔버스에 아래 노드를 추가하고 이미지와 같이 배치합니다.
반복(Loop) 노드:+노드 추가(Add Node)→흐름 제어 노드카테고리에서 추가합니다.값 설정(Set Value) 노드:+노드 추가(Add Node)→데이터 노드카테고리에서 추가합니다.
배치가 완료되면 아래 순서로 엣지를 연결합니다.
시작 노드의 아웃핀(Out-Pin) →값 설정 노드의 인핀(In-Pin)값 설정 노드의 아웃핀 →반복 노드의 인핀반복 노드의 pass 핀 →종료 노드의 인핀반복 노드의 loop 핀 →값 설정 노드의 인핀
loop핀은 조건이 참인 동안 이전 노드로 되돌아가는 핀이고,pass핀은 조건이 거짓이 되어 루프를 빠져나가는 핀입니다.
3단계: 전역변수 탭 열기
캔버스 왼쪽 사이드 패널을 열고 전역변수 탭으로 진입합니다. +를 클릭하여 전역변수 추가를 시작합니다.
4단계: 전역변수 선언
아래와 같이 전역변수를 설정합니다.
항목 | 값 |
|---|---|
자료형 | Integer (정수) |
이름 |
|
기본값 |
|
num은 카운터의 시작값입니다. 이 튜토리얼에서는 전역변수 기본값(0)을 카운터 초기값으로 사용합니다.
5단계: 반복 노드 설정
반복 노드를 더블 클릭하여 노드 편집기(Node Editor)를 엽니다.
루프 노드는 아래 옵션을 제공합니다.
옵션 | 필수 여부 | 설명 |
|---|---|---|
| 필수 | 반복 지속 여부를 결정하는 조건식. 참(True)인 동안 |
| 필수 | 안전 제한값 (int, 기본값 10, 0보다 커야 함). 이 횟수에 도달하면 조건과 무관하게 루프 종료 |
Loop Condition 설정
Loop Condition 입력란에 다음 조건식을 입력합니다. 왼쪽 Ability Variables에 있는 num을 드래그 앤 드롭으로 가져와 조건식을 완성할 수 있습니다.
num < 10은 카운터 값이 10 미만인 동안 반복을 지속하는 조건입니다. num이 10에 도달하면 조건이 거짓이 되어 pass 핀을 통해 종료 노드로 진행합니다.
최대 반복 횟수 설정
최대 반복 횟수 입력란에 20을 입력합니다. 조건 충족 전에 20회에 도달하면 루프가 종료됩니다.
6단계: 값 설정 노드 설정
값 설정 노드를 더블 클릭하여 노드 편집기를 엽니다.
Set Value 영역에서 아래와 같이 식을 설정합니다. 왼쪽 Ability Variables에 있는 num을 드래그 앤 드롭으로 가져와 num + 1 식을 완성합니다.
항목 | 값 |
|---|---|
식(Expression) |
|
to |
|
이 설정을 통해 반복마다 전역변수 num 값이 1씩 증가합니다.
7단계: 시작 노드 확인
이 튜토리얼에서는 전역변수 기본값(0)을 카운터 초기값으로 사용하므로 시작 노드에 별도의 인풋(Input) 변수를 선언하지 않습니다. 시작 노드는 기본 상태 그대로 유지합니다.
8단계: 종료 노드 설정
종료 노드를 더블 클릭하여 노드 편집기를 엽니다.
아웃풋 영역(Output Section)에 아래 변수를 추가합니다.
변수명 | 타입 |
|---|---|
| Integer (정수) |
Ability Variables의 num을 드래그 앤 드롭으로 result에 바인딩합니다.
9단계: 어빌리티 테스트 실행
캔버스 오른쪽 하단의 테스트 실행 버튼을 클릭합니다. 테스트 실행 → 테스트 실행 → 실행 순서로 진행하면 전체 런테스트가 실행됩니다.
전역변수 num은 0부터 시작하여 반복 노드가 num < 10 조건을 확인하고 값 설정 노드에서 1씩 증가합니다. num이 10에 도달하면 조건이 거짓이 되어 pass 핀을 통해 종료 노드로 진행됩니다.
반복 | num (조건 확인 전) | 조건 (num < 10) | 결과 | num (연산 후) |
|---|---|---|---|---|
1회 | 0 | 참 (loop) | 값 설정 | 1 |
2회 | 1 | 참 (loop) | 값 설정 | 2 |
3회 | 2 | 참 (loop) | 값 설정 | 3 |
4회 | 3 | 참 (loop) | 값 설정 | 4 |
5회 | 4 | 참 (loop) | 값 설정 | 5 |
6회 | 5 | 참 (loop) | 값 설정 | 6 |
7회 | 6 | 참 (loop) | 값 설정 | 7 |
8회 | 7 | 참 (loop) | 값 설정 | 8 |
9회 | 8 | 참 (loop) | 값 설정 | 9 |
10회 | 9 | 참 (loop) | 값 설정 | 10 |
11회 | 10 | 거짓 (pass) | 종료 노드 | — |
최종 결과로 result: 10이 반환되는 것을 확인합니다.
10단계: 실행 결과 확인
테스트 실행창의 실행 모니터에서 각 노드의 실행 결과를 단계별로 확인할 수 있습니다.
다음 단계
🎉 축하합니다! 에이전트리아를 사용해 '+1 카운터' 워크플로를 완성했습니다.
루프 노드의 조건식과 최대 반복 횟수를 변경하거나, 값 설정 노드의 연산식을 교체하면 더 다양한 반복 워크플로를 구성할 수 있습니다.
에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.
당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.