변수란?
각 노드는 실행 결과를 내보내고, 후속 노드는 이를 참조해 데이터를 주고받습니다. 변수 참조는 Mustache 스타일({{...}})을 사용합니다.
변수 삽입
프롬프트나 파라미터 입력창에서 변수 삽입 드롭다운을 열면:
- 직접 입력 그룹 — 고정값을 직접 입력
- 노드별 그룹 — 앞선 노드의 출력 변수를 노드 별명 아래에서 선택
- 반복/루프 내부에서는 루프 변수 그룹이 추가로 나타납니다
변수는 노드에 붙인 이름(별명) 으로 표시되므로, id를 외울 필요 없이 찾아 선택할 수 있습니다.
변수 참조 문법
참조는 {{<노드id>.<필드>}} 형식입니다. 노드 id는 추가 시 자동으로 만들어집니다(llm_1, kb_1, classifier_1 등).
| 패턴 | 의미 |
|---|---|
{{start.question}} | 시작 노드에서 정의한 question 입력값 |
{{llm_1.text}} | LLM 노드의 답변 텍스트 |
{{kb_1.result}} | 지식검색 노드의 검색 결과 |
{{tool_1.result}} | 도구 호출 결과 |
{{classifier_1.class_id}} | 질문분류기가 고른 분류 |
{{web_1.results}} | 웹검색 결과 목록 |
{{agent_1.output}} | 에이전트 노드의 출력 |
{{iteration_1.current}} | 반복 노드 내 현재 아이템 |
{{loop_1.index}} | 루프의 현재 회차 |
{{web_1.results[0].url}} | 배열/중첩 필드 접근 ([인덱스] 사용) |
시스템 변수
날짜·시각이 필요할 때는 노드 id 없이 바로 쓸 수 있는 시스템 변수를 제공합니다.
| 패턴 | 의미 |
|---|---|
{{sys.today}} | 오늘 날짜 |
{{sys.now}} | 현재 시각 |
{{sys.date:%Y-%m-%d}} | 지정한 형식의 날짜/시각 |
{{sys.timestamp}} | Unix 타임스탬프 |
노드별 출력 필드
| 노드 | 출력 필드 |
|---|---|
| 시작 (start) | 정의한 입력 이름 그대로 ({{start.question}} 등) |
| LLM (llm) | .text |
| 지식검색 (knowledge_retrieval) | .result |
| 도구 (tool) | .result |
| 에이전트 (agent) | .output |
| 웹검색 (web_search) | .results (목록) · .text (합쳐진 텍스트) |
| 질문분류기 (question_classifier) | .class_id |
| 노트 (note) | .note_id · .content |
| 반복/루프 (iteration/loop) | .output |
반복 · 루프 변수
반복(iteration) 노드 안의 본문에서는 배열 컨텍스트 변수를 사용할 수 있습니다. (노드 id는 실제 id로 대체됩니다)
- 현재 아이템 —
{{iteration_1.current}} - 현재 인덱스 (0, 1, 2, ...) —
{{iteration_1.index}}
루프(loop) 노드 안에서도 같은 형식({{loop_1.index}} 등)을 사용합니다.
예시 (각 아이템을 처리하는 LLM 노드):
다음 항목을 요약해 줘:
{{iteration_1.current}}
자주 쓰이는 패턴
노드를 선택하면 우측 설정 패널에서 프롬프트에 변수를 직접 삽입할 수 있습니다.
사용자 입력을 LLM에 전달
시작 노드에 question (텍스트) 입력을 정의하고, LLM 노드의 사용자 프롬프트에 {{start.question}} 를 삽입합니다.
지식 검색 결과를 LLM 컨텍스트로
지식검색 노드의 쿼리에 {{start.question}} 을 넣고, LLM 노드의 프롬프트에 {{kb_1.result}} 를 참조해 "다음 문서를 참고해 답변해 줘" 형태로 구성합니다.
반복으로 여러 아이템 처리
시작 노드에 배열 입력 items 를 정의하고, 반복 노드의 반복 대상을 {{start.items}} 로 지정합니다. 본문의 LLM 노드에서는 {{iteration_1.current}} 로 현재 아이템을 참조합니다.