Skip to main content
추출 노드는 사용자와의 대화에서 중요한 정보를 추출하여 동적변수로 저장하는 노드입니다. 대화 노드와 달리 에이전트가 사용자에게 직접 말하지 않고, 오직 변수 추출 작업만 수행합니다.
추출 노드는 항상 사용자 응답을 건너뜁니다. 에이전트가 별도의 발화를 하지 않고 즉시 변수를 추출한 뒤 다음 노드로 이동합니다.

​
언제 사용하나요

  • 고객이 말한 이름, 전화번호, 주소 등 정형 정보를 변수로 저장할 때
  • 한국어 음성을 정규화된 데이터 형식으로 변환해야 할 때 (예: “시월 십칠일” → “2025-10-17”)
  • 추출한 변수를 이후 조건 노드나 API 노드에서 참조해야 할 때
  • 여러 항목을 한 번에 추출해야 할 때 (예: 상품명 + 배송일시 + 배송장소)

​
추출 프롬프트

동적변수 추출을 돕기 위한 프롬프트를 입력할 수 있습니다. 이 프롬프트는 에이전트에게 어떤 데이터를 어떻게 추출해야 하는지 안내하는 역할을 합니다. 추출 노드는 동적 프롬프트만 지원합니다.
복잡한 동적변수 추출 시에는 프롬프트에 구체적인 추출 규칙과 예시를 포함하면 정확도가 향상됩니다.

​
변수 정의

추출하고자 하는 변수를 정의합니다. 각 변수에는 다음 항목을 설정합니다:
항목설명
변수명추출할 데이터의 식별자입니다 (예: customer_name, inquiry_type)
타입추출할 데이터의 타입을 선택합니다: string(문자열), number(숫자), boolean(참/거짓)
설명변수에 대한 설명을 입력합니다. LLM이 어떤 값을 추출해야 하는지 이해하는 데 도움이 됩니다.
추출된 변수는 이후 다른 노드에서 {{변수명}} 형식으로 참조할 수 있습니다. 예를 들어, {{customer_name}} 또는 {{inquiry_type}}과 같이 추출된 변수를 다른 노드의 프롬프트에서 활용할 수 있습니다.

​
노드별 LLM 오버라이드

이 노드에서 다른 LLM 모델을 사용할 수 있습니다. 글로벌 설정의 기본 모델 대신 추출 작업에 더 적합한 모델을 지정할 수 있습니다.

​
노드 흐름

동적변수 추출 노드는 다음과 같은 순서로 작동합니다:
  1. 사용자의 입력이나 이전 대화 내용 분석
  2. 지정된 변수에 대한 동적변수 추출
  3. 변수 저장 및 다음 노드로 이동

​
실제 사용 예시

​
성함 + 전화번호 추출

고객이 말한 이름과 전화번호를 정규화하여 추출합니다. 추출 프롬프트: 
고객이 말한 성함과 전화번호를 추출하세요.
- 전화번호는 한국어 발음을 숫자로 변환합니다.
  예: "공일공 이삼사오 육칠팔구" → "01023456789"
- 성함은 한글 그대로 추출합니다.
변수 정의:
변수명타입설명
customer_namestring고객 성함
phone_numberstring고객 전화번호 (숫자만)

​
상품명 추출

고객이 주문하려는 상품명을 추출합니다. 추출 프롬프트: 
고객이 주문하려는 상품명을 추출하세요.
불필요한 조사나 어미를 제거하고 상품명만 추출합니다.
예: "근조화환이요" → "근조화환"
변수 정의:
변수명타입설명
product_namestring주문 상품명

​
배송일시 추출

고객이 말한 날짜와 시간을 정규화된 형식으로 변환합니다. 추출 프롬프트: 
고객이 말한 배송 날짜와 시간을 추출하세요.
- 날짜는 YYYY-MM-DD 형식으로 변환합니다.
  예: "시월 십칠일" → "2025-10-17"
- 시간은 HH:MM 형식으로 변환합니다.
  예: "열두시 반" → "12:30"
변수 정의:
변수명타입설명
delivery_datestring배송 날짜 (YYYY-MM-DD)
delivery_timestring배송 시간 (HH:MM)

​
배송장소 추출

고객이 말한 주소를 그대로 추출합니다. 추출 프롬프트: 
고객이 말한 배송 주소를 추출하세요.
조사나 어미를 제거하고 주소만 추출합니다.
예: "강남구 도산대로 208 101호요" → "강남구 도산대로 208 101호"
변수 정의:
변수명타입설명
delivery_addressstring배송 주소

​
전화번호 DTMF 추출

고객이 키패드로 입력한 전화번호를 추출합니다. 추출 프롬프트: 
고객이 DTMF로 입력한 전화번호를 추출하세요.
010 + 8자리 숫자 형식의 총 11자리 전화번호입니다.
변수 정의:
변수명타입설명
dtmf_phonestringDTMF 입력 전화번호 (11자리)
한국어 음성 인식에서 숫자 변환이 필요한 경우, 추출 프롬프트에 변환 규칙과 예시를 반드시 포함하세요. LLM의 추출 정확도가 크게 향상됩니다.

​
관련 문서

노드 개요

플로우 에이전트의 노드 타입과 추가 방법을 확인하세요.

동적 변수

추출한 변수를 활용하는 방법을 알아보세요.

조건 노드

추출한 변수로 대화 흐름을 분기하는 방법을 확인하세요.
추출 노드, extraction node, 변수 추출, 정보 추출, 동적변수, 정규화, entity extraction