User Input Node (사용자 입력 노드)

Chat node (챗 노드) 그룹

개요

사용자 입력 노드는 챗봇 인터페이스를 통해 인터랙티브한 사용자 입력을 가능하게 하며, 일반적으로 사용자로부터 질의나 LLM 프롬프트를 받는 데 사용됩니다. 이 노드는 텍스트 전용, 파일 업로드, 또는 텍스트와 파일 업로드 결합을 포함한 여러 입력 모드를 지원하여 유연한 사용자 상호작용 처리가 가능합니다.

설명

이 노드는 챗봇 또는 HyperFlow Control API를 사용하는 맞춤형 앱에서 인터랙티브한 입력 인터페이스를 생성하며, 사용자가 입력을 제공할 때까지 흐름 실행을 일시 중지합니다.

설정에 따라 텍스트 입력, 파일 업로드 또는 둘 다 입력 받을 수 있습니다. 이 노드는 사전 설정된 프롬프트 버튼도 지원하며, 이는 플로우그래프의 이전 단계에서 동적으로 구성되어 사용자에게 가이드된 응답 선택지를 제공할 수 있습니다. 최종 사용자에게는 선택된 모드에 따라 적절한 입력 UI가 표시됩니다. 일반적으로는 텍스트 입력 필드(➡️)와/또는 파일 업로드 버튼(📎)이 함께 나타납니다.

주요 기능

다양한 입력 모드: 텍스트 전용, 파일 전용, 또는 텍스트와 파일을 함께 입력받는 모드를 선택할 수 있습니다.
프롬프트 버튼: 클릭 가능한 추천 문구 버튼을 표시하여 사용자 입력을 유도할 수 있습니다.
파일 업로드 지원: 파일 형식 및 크기 제한을 설정하고, 다양한 유형의 파일을 처리할 수 있습니다.
입력 가이드 문구(플레이스홀더): 입력 필드에 안내 문구를 표시하여 사용자가 어떤 정보를 입력해야 하는지 명확히 전달할 수 있습니다.
저장소 관리: 업로드된 파일의 저장 공간 사용량을 자동으로 추적하고 관리합니다.
태그 기반 정리: 파일에 태그를 지정하여 후속 처리나 검색 시 활용할 수 있도록 구성할 수 있습니다.

사용 가이드라인

기본 설정

입력 모드 선택
- 텍스트 입력, 파일 업로드, 텍스트 + 파일 업로드 중 하나를 선택합니다.
- 파일 업로드를 사용하는 경우, 허용할 파일 형식을 MIME 타입으로 지정할 수 있습니다.
- 추후 이용 및 관리를 위해 파일 태그를 설정할 수 있습니다.
프롬프트 설정
- 사용자 입력 필드에 플레이스홀더 문구를 지정하여 입력 가이드를 제공합니다.
- promptButtons 입력을 연결하여 클릭 가능한 프롬프트 버튼을 표시할 수 있습니다.
- 노트 필드를 활용해 추가적인 설명이나 맥락을 전달할 수 있습니다.
출력 처리 설계
- 선택한 입력 모드에 따라 다양한 출력 유형이 발생할 수 있으므로, 후속 노드에서 텍스트 입력 또는 파일 콘텐츠를 적절히 처리하도록 구성합니다.

고급 설정

파일 형식 제한: 보안 또는 워크플로우 목적에 따라 특정 MIME 타입만 허용할 수 있습니다.
커스텀 태그 지정: 업로드된 파일에 적용할 조직/분류용 태그를 사전에 정의할 수 있습니다.
프롬프트 버튼 디자인: 대화 흐름에 적합한 버튼을 설계하여 사용자 선택지를 명확히 제시할 수 있습니다.
선택적 업로드 흐름 구성: 텍스트와 파일을 동시에 받을 수 있는 상황에 맞춰 입력 흐름을 설계할 수 있습니다.

워크플로우 패턴

텍스트 입력 기반 기본 대화 흐름

User Input (Text mode) → LLM Chat → Response Display

#해석
사용자 입력 (텍스트 모드) → LLM 챗 → 답변 표기

사용자가 텍스트를 입력하면, LLM이 이를 기반으로 응답을 생성하고 출력합니다.

문서 기반 분석 흐름

User Input (Optional upload + text) → Content Processing → Knowledge Extraction → LLM Analysis

#해석
사용자 입력 (선택적 업로드 + 텍스트) → 콘텐츠 처리 → 지식 추출 → LLM 분석

사용자가 문서와 함께 분석 요청을 입력하면, 문서를 처리한 후 관련 정보를 추출하고 LLM 분석을 진행합니다.

프롬프트 버튼을 활용한 유도형 대화 흐름

Previous Node → Data Transform (create prompt buttons) → User Input → Response Logic

#해석
이전 노드 → 데이터 변환 (프롬프트 버튼 생성) → 사용자 입력 → 응답 처리 로직

이전 단계에서 생성된 버튼을 통해 사용자의 선택을 유도하고, 그에 따라 후속 응답을 처리합니다.

파일 처리 파이프라인

User Input (File upload) → Content Segmentation → Vector DB Storage → Confirmation

#해석
사용자 입력 (파일 업로드) → 콘텐츠 분할 → 벡터 DB 저장 → 확인

파일만 입력받아 내부에서 분할, 벡터 저장, 사용자 확인의 흐름으로 이어지는 구조입니다.

이럴 때 사용하세요

인터랙티브 챗봇 구축: 사용자로부터 자연어 입력을 받는 대화형 인터페이스가 필요한 경우
문서 분석 시스템: 사용자가 문서를 업로드하고 그에 대한 처리를 요청하는 경우
유도형 질의 시스템: 버튼을 통해 추천 질문을 제시하고 선택지를 제공하고자 할 때
다단계 대화 수집: 사용자로부터 설명과 함께 파일을 입력받는 상황
지식 베이스 구축: 사용자가 문서를 제출하여 지식 추출에 활용하는 경우
양식(폼) 입력 방식: 정형화된 정보를 대화 방식으로 수집할 때

이렇게 사용하세요

명확한 안내 문구 제공: 입력 필드에 적절한 플레이스홀더를 설정해 사용자가 혼란 없이 입력할 수 있도록 합니다.
적절한 파일 형식 제한: 워크플로우에 필요하지 않은 파일 형식은 제한해 보안과 처리 안정성을 높입니다.
프롬프트 버튼 적극 활용: 추천 질문을 버튼 형태로 제시해 사용자의 탐색 경험을 향상시킬 수 있습니다.
에러 처리 설계: 유효하지 않은 업로드나 입력 오류에 대비해 예외 흐름을 구성합니다.
저장소 용량 관리: 대용량 파일 업로드를 허용하는 경우에는 저장소 사용량을 반드시 모니터링해야 합니다.
문맥 유지 설계: 사용자가 업로드한 파일에 대해 설명이 필요한 경우, 텍스트 + 업로드 모드를 함께 사용하는 것이 좋습니다.

파라미터

속성명	타입	설명	필수
`Mode`	`choice`	입력 방식 선택 (텍스트 입력 / 파일 업로드 / 텍스트 + 파일 업로드)	O
`Prompt`	`text`	사용자 텍스트 입력 (텍스트 또는 혼합 입력 모드에서 사용)	X
`Prompt placeholder`	`text`	입력 필드에 표시할 가이드 문구	X
`File type`	`choice`	업로드 가능한 파일의 MIME 타입 (예: application/pdf, image/* 등)	O (업로드 모드인 경우)
`Tags`	`text`	파일 업로드 시 적용할 태그 (쉼표로 구분)	X
`Notes`	`text`	업로드에 대한 추가 설명 또는 문맥	X
`Uploaded files`	`files`	업로드된 파일 배열 (시스템에서 자동 입력)	X

입력값

속성명	타입	설명
`Prompt buttons`	`promptButtons`또는 `text`	사용자에게 보여줄 프리셋 질문 옵션. 여러 줄 텍스트 또는 JSON 배열 형식으로 구성 가능. 버튼 기반 대화 흐름에 활용됩니다.

출력값

속성명	타입	설명
`User input`	`text`	사용자가 입력한 텍스트 (텍스트 입력 모드에서 생성)
`Uploaded content`	`content`	사용자가 업로드한 파일 콘텐츠 (ImportSetValue 형식)
`Upload type`	`text`	업로드된 파일의 MIME 타입

구현 상세

사용자 입력 노드는 다단계 입력 처리 방식을 따릅니다.

1. 준비 단계

연결된 promptButtons 입력을 수집합니다.
적절한 파라미터 명세를 생성합니다.
플레이스홀더 텍스트를 적용합니다.
UI에 입력 컨트롤을 표시합니다.

2. 입력 수집

텍스트 입력의 경우, 사용자가 입력한 텍스트를 수집합니다.
파일 업로드의 경우, uploadContent API 엔드포인트를 통해 파일을 수신합니다.
저장소 할당량 관리를 위한 기록을 생성합니다.