Skip to main content

​
노드

노드는 플로우 에이전트의 기본 구성 요소입니다. 각 노드는 사용자에게 응답하기 위해 에이전트가 취하는 단계를 나타내며, 특정 로직, 작업 또는 대화 목적을 달성합니다. 각 노드는 전환 조건이 포함된 에지를 가지며, 언제 어떤 노드로 전환할지 결정합니다. 워크플로우를 개별 노드로 분리하고 각 노드의 성능을 조정하면 대화 흐름을 세밀하게 제어할 수 있습니다.

​
노드 타입

vox.ai는 여러 타입의 노드를 제공합니다:

시작 노드

플로우 에이전트의 대화 진입점입니다. 모든 플로우에 자동으로 생성되며, 대화 시작 방식을 설정합니다.

대화 노드

사용자와의 대화를 처리하는 기본 노드입니다. 사용자 입력을 수신하고 적절한 응답을 생성합니다.

API 노드

외부 API를 호출하여 데이터를 가져오거나 전송합니다.

추출 노드

대화 내용에서 중요한 정보를 추출하여 변수로 저장합니다.

조건 노드

변수 값에 따라 다른 노드로 자동 분기합니다.

도구 노드

에이전트에 등록된 외부 도구를 실행합니다.

통화 전환 노드

통화를 다른 전화번호로 전환합니다.

에이전트 전환 노드

대화를 다른 에이전트로 전환합니다.

종료 노드

대화를 종료하는 노드입니다. 대화가 이 노드에 도달하면 세션이 종료됩니다.

​
노드 추가하기

1

노드 타입 선택

화면 아래 플로팅 패널에서 추가하려는 노드 타입을 선택합니다. 노드를 클릭하면 캔버스에 추가됩니다.
2

노드 구성

노드를 클릭하여 선택한 다음, 오른쪽 패널에서 설정을 확인하고 노드 내부에 지시사항을 입력합니다. 각 노드 타입별 자세한 프롬프트 작성 방법은 해당 노드 가이드를 참조하세요.
각 노드에는 고유한 설정이 있으므로, 노드 타입에 맞는 적절한 구성이 중요합니다.
3

전환 조건 추가

노드 하단 부분에서 전환 조건을 추가하고 설정합니다. 전환 조건 추가에 대한 자세한 내용은 전환 조건 추가를 참조하세요.
4

노드 연결

전환 조건 우측의 원형 부분을 드래그하여 다른 노드와 연결하는 선을 그립니다. 이렇게 하면 노드 간의 흐름이 생성됩니다.
시작 노드에서 최소한 하나의 노드로 연결해야 대화 흐름이 시작될 수 있습니다.

​
프롬프트 예시

다음은 간단한 대화 노드 프롬프트의 예시입니다: 
# 인사 노드

## 지시사항
사용자에게 인사하고 이름을 물어보세요. 친절하고 전문적인 톤을 유지하세요.

## 응답 예시
"전화주셔서 감사합니다. 복스에이아이 세일즈 에이전트 신유진입니다. 무엇을 도와드릴까요?"

​
팁

노드 구성 시 참고할 팁입니다:
  • 명확한 지시사항 - 각 노드에 명확하고 구체적인 지시사항을 제공하세요. 노드의 목적과 예상되는 동작을 명확하게 설명하는 것이 중요합니다.
  • 적절한 노드 분리 - 복잡한 대화 로직은 여러 개의 작은 노드로 분리하는 것이 좋습니다. 이렇게 하면 각 노드가 특정 작업에 집중할 수 있어 성능이 향상됩니다.
  • 전환 조건 최적화 - 전환 조건은 구체적이고 명확해야 합니다. 모호한 조건은 예상치 못한 노드 전환을 초래할 수 있습니다.
  • 테스트 및 반복 - 노드를 추가한 후에는 여러 시나리오에서 테스트하고 필요에 따라 조정하세요.

​
FAQ

노드가 로직 처리를 수행하고 있는데 성능이 좋지 않거나(LLM이 환각 현상을 보이는 경우), 여러 작업을 동시에 처리하고 있다면 여러 개의 노드로 분리하는 것이 좋습니다. 각 노드가 하나의 명확한 목적을 가지도록 하세요.
마우스나 터치패드를 사용하는지에 따라 스크롤 휠이나 핀치 제스처를 사용하여 확대/축소할 수 있습니다. 캔버스 오른쪽 하단의 확대/축소 컨트롤을 사용하는 방법도 있습니다.
아니요, 원하는 만큼 많은 노드를 추가할 수 있습니다. 그러나 관리 용이성을 위해 대화 흐름을 논리적으로 구성하는 것이 좋습니다.
많은 노드를 추가한 후에는 캔버스가 복잡해질 수 있습니다. 화면 하단 플로팅 패널 우측에 있는 ‘정렬’ 버튼을 사용하여 노드를 자동으로 정리할 수 있습니다.

​
실제 플로우 예시

다음은 꽃배달 주문 관리 에이전트의 플로우를 단순화한 예시입니다. 여러 노드 타입이 어떻게 함께 작동하는지 보여줍니다.
노드타입역할
상담 시작대화 노드고객에게 인사하고 용건 확인
주문자 확인대화 노드성함과 전화번호를 요청하여 본인 확인
성함/전화번호 추출추출 노드고객이 말한 성함과 전화번호를 변수로 저장
주문 확인대화 노드현재 주문 내역을 안내하고 수정 여부 확인
수정 항목 분기조건 노드수정할 항목에 따라 해당 추출 노드로 분기
상품명/배송일시 추출추출 노드수정할 정보를 추출하여 변수에 저장
상담 종료종료 노드최종 확인 후 통화 종료
복잡한 플로우도 각 노드가 하나의 명확한 역할을 담당하도록 설계하면 관리와 디버깅이 쉬워집니다. 추출 → 조건 → 대화 순서로 연결하는 패턴을 기본으로 활용하세요.

​
다음 단계

노드 추가 방법을 이해했으니, 이제 각 노드 타입에 대해 자세히 알아보거나 노드 간 전환 조건을 설정하는 방법을 알아볼 수 있습니다.

시작 노드

플로우 에이전트의 진입점인 시작 노드에 대해 알아보세요.

전환 조건 추가

노드 간 전환 조건을 설정하는 방법을 알아보세요.
노드, node, 노드 타입, node type, 노드 추가, 플로우 노드, 노드 개요