다크 모드
워크플로우 노드 레퍼런스
워크플로우 노드는 입력을 받고, 데이터를 처리하고, 실행 흐름을 제어해 최종 결과를 만드는 구성 요소입니다. 이 문서는 각 노드의 설정, 입력과 출력, 연결 제약을 설명합니다.
노드 선택 기준
시작과 종료
| 노드 | 사용 시점 |
|---|---|
| Input | 워크플로우를 호출할 때 받을 입력 필드와 검증 규칙을 정의합니다. |
| Output | 여러 노드의 결과를 최종 응답 객체로 조립합니다. |
AI와 외부 연동
| 노드 | 사용 시점 |
|---|---|
| LLM | 모델로 텍스트 또는 구조화된 데이터를 생성합니다. |
| Tool | MCP 도구나 Studio에 등록된 도구를 실행합니다. |
| Retriever | Knowledge Base 컬렉션에서 관련 문서를 검색합니다. |
| HTTP | 외부 API, 웹훅, 웹 서비스를 호출합니다. |
데이터 처리와 분기
| 노드 | 사용 시점 |
|---|---|
| Template | 텍스트와 이전 노드 값을 조합해 문서나 메시지를 만듭니다. |
| Code | JavaScript 또는 Python으로 계산과 복잡한 변환을 수행합니다. |
| Transform | 코드를 쓰지 않고 필드 이름과 데이터 구조를 바꿉니다. |
| Condition | 조건에 따라 실행 경로를 분기합니다. |
반복과 흐름 제어
| 노드 | 사용 시점 |
|---|---|
| Iteration | 배열의 각 항목을 독립적으로 처리하고 결과를 모읍니다. |
| Loop | 이전 회차의 상태를 다음 회차로 전달하며 반복합니다. |
| Variable Assigner | Loop가 소유한 변수를 갱신합니다. |
| Exit Loop | 실행 중인 Loop를 즉시 종료합니다. |
캔버스 문서화
| 노드 | 사용 시점 |
|---|---|
| Note | 실행에 영향을 주지 않는 설명과 주석을 캔버스에 남깁니다. |
공통 개념
실행 흐름과 데이터 참조
노드를 연결한 선은 실행 순서를 정의합니다. 설정 입력란에서 /를 입력하면 현재 위치에서 참조할 수 있는 이전 노드의 출력 필드를 선택할 수 있습니다.
실행 순서상 아직 도달할 수 없는 노드, 다른 컨테이너에 속한 노드, 출력 스키마에 없는 필드는 참조할 수 없습니다.
출력 스키마
출력 스키마는 다음 노드가 참조할 수 있는 필드와 타입을 정의합니다. LLM과 Code처럼 구조화된 결과를 만드는 노드는 스키마를 정확히 정의해야 다음 단계에서 안정적으로 필드를 선택할 수 있습니다.
노드 이름
Note를 제외한 노드 이름은 워크플로우 안에서 고유해야 합니다. 이름은 변수 선택 목록과 실행 이력에 표시되므로 역할이 드러나도록 작성하세요.
루트와 컨테이너
- 루트 워크플로우에는 Input과 Output이 각각 하나씩 있어야 합니다.
- Iteration과 Loop 내부 노드는 컨테이너 밖의 실행선과 직접 연결할 수 없습니다.
- Iteration이나 Loop 안에 다른 Iteration 또는 Loop를 중첩할 수 없습니다.
- 컨테이너 내부의 모든 노드는 시작점에서 도달할 수 있어야 하며 순환 연결을 만들 수 없습니다.
노드 추가
- 왼쪽 툴바의 노드 추가에서 일반 노드를 캔버스 중앙에 추가할 수 있습니다.
- 노드의
+버튼을 사용하면 현재 노드 다음에 연결된 새 노드를 추가합니다. - Note는 일반 실행 노드와 분리되어 있으므로 왼쪽 툴바의 메모 추가를 사용합니다.
- Loop와 Iteration의 시작점에서는 해당 컨테이너가 허용하는 내부 노드만 선택할 수 있습니다.
실행 상태 확인
테스트 실행 중인 노드는 파란색, 성공한 노드는 초록색, 실패한 노드는 빨간색으로 표시됩니다. Loop가 실행 중이면 컨테이너 헤더에서 현재 루프 카운트를 확인할 수 있습니다. 자세한 입출력과 오류는 실행 패널의 노드별 이력에서 확인하세요.