AI Forge

다크 모드

Template 노드 ​

Template 노드는 고정된 텍스트와 이전 노드의 출력값을 조합해 문서, 메시지, 보고서 같은 문자열을 만듭니다.

언제 사용하나요? ​

  • 이메일, 알림, 보고서처럼 일정한 형식의 텍스트를 만들 때
  • 여러 노드의 결과를 사람이 읽기 쉬운 문장으로 조합할 때
  • 생성형 모델 없이 결정적인 형식의 응답을 만들 때

입력 ​

템플릿 편집기에서 /를 입력해 현재 노드에서 접근할 수 있는 이전 노드의 출력 필드를 삽입합니다. 고정 텍스트와 변수 참조를 한 문서 안에서 함께 사용할 수 있습니다.

문자열과 숫자, 불리언은 텍스트로 삽입됩니다. 객체나 배열은 JSON 문자열로 직렬화되어 삽입됩니다.

주요 설정 ​

설정설명
템플릿텍스트와 변수 참조를 작성하는 문서 편집기입니다.
변수 참조/로 이전 노드의 출력 필드를 검색해 현재 커서 위치에 삽입합니다.

템플릿 형식은 편집기가 관리하는 TipTap 문서로 고정되어 있습니다. 빈 템플릿도 저장과 검증은 가능하며 실행 결과는 빈 문자열입니다.

출력 ​

완성된 텍스트는 다음 필드로 제공됩니다.

출력 경로타입설명
templatestring고정 텍스트와 변수 값을 치환한 최종 문자열입니다.

연결과 배치 제약 ​

  • 템플릿에서 선택할 수 있는 변수는 현재 실행 순서와 같은 범위에서 접근 가능한 이전 노드 출력입니다.
  • Template 노드는 일반 워크플로우와 Iteration, Loop 안에 배치할 수 있습니다.
  • Loop나 Iteration 안에 배치한 Template 노드는 컨테이너 밖 노드와 직접 연결할 수 없습니다.

예시 ​

다음과 같은 주문 안내 템플릿을 작성할 수 있습니다. /로 시작하는 부분은 편집기에서 해당 변수를 선택해 삽입합니다.

text
안녕하세요, /INPUT.customer_name 님.

주문 번호: /INPUT.order_id
처리 상태: /HTTP.response.statusText

/LLM.answer

실행하면 각 참조가 실제 값으로 바뀌고 전체 내용이 template 문자열로 반환됩니다.

주의사항 ​

  • Template은 조건 판단이나 데이터 가공을 하지 않습니다. 분기는 Condition, 계산과 파싱은 Code를 사용하세요.
  • 참조한 노드나 출력 필드를 삭제하면 변수를 해석할 수 없습니다. 워크플로우 구조를 바꾼 뒤 템플릿 참조를 확인하세요.
  • 값이 null, 빈 문자열, false, 0이면 치환 결과가 빈 문자열이 될 수 있습니다.
  • 템플릿을 비워 두어도 검증 오류가 발생하지 않으므로 게시 전에 실제 실행 결과를 확인하세요.

관련 노드 ​