Storm OpenAPI
  1. 지식
Storm OpenAPI
  • Welcome to STORM
    • STORM 소개
  • Quickstart
    • 시작하기
      • 계정 생성
      • 에이전트 생성
    • 주요 활용 시나리오
      • 문서 업로드
      • 워크플로우 설계
      • 테스트
      • 배포
      • 채널 연동
  • Feature Guide
    • 콘솔
      • 에이전트 관리
      • 대시보드
      • 권한 설정
    • 에이전트 템플릿
      • 지식 탐색
      • 캐릭터 대화
      • 상담기록 분석
      • 기사 작성
      • SQL문 작성
    • 에이전트 빌더
      • 지식
        • 문서
        • 폴더
        • 피드백
      • 워크플로우
        • 노드 설명
          • LLM
          • 검색(RAG)
          • API
          • IF ELSE
          • 변수 선언과 할당
          • 후처리
      • 테스트
      • 로그
      • 대시보드
    • 관리자 도구
      • 배포 관리
      • 채널 연동
      • 모델 파인튜닝
      • 학습 데이터 품질 관리
      • 기타 설정
      • Teams 채널 연동
  • Apis
    • 에이전트
      • 에이전트 조회
      • 에이전트 배포
      • 에이전트 배포 이력 조회
    • 버킷
      • 버킷 생성
      • 버킷 조회
    • 문서
      • 문서 학습 요청 by file
      • 문서 학습 요청 by url
      • 문서 조회
      • 문서 삭제
    • 채팅
      • 채팅 전송 (non-stream)
      • 채팅 전송 (stream)
      • 컨텍스트 검색
    • STORM Parse
      • /convert/md
  • Learn More
    • 자주 묻는 질문
    • 과금 플랜
  1. 지식

폴더

폴더#

폴더는 방대한 지식 데이터를 논리적으로 구조화하여 에이전트의 응답 정확성과 관련성을 높이는 핵심 기능입니다. 만약 1만개 이상의 다양한 문서를 학습시켜야한다면 폴더 기능을 활용해서 유사한 카테고리별로 폴더를 구분하여 관리해주세요.
Group 632962.png




image37.png
폴더를 구분하고 해당 폴더를 대표하는 폴더의 이름을 지정해놓는 것만으로 검색성능을 높일 수 있습니다.

폴더 활용 시나리오#

1. 많은 양의 문서를 더 효과적으로 검색하고 싶은 경우#

폴더를 명확히 구분한다면 매우 많은 양의 문서 사이에서도 더 정확한 정보를 검색해낼 수 있습니다. 단, 폴더의 이름을 폴더 내 문서들을 대표할 수 있는 키워드로 작성할 수 있도록 주의해야합니다.
예시: 유저의 질문이 “휴양시설 신청 방법”이라면 스톰 내부 검색 단계에서 “인사 가이드”라는 폴더를 더 우선시하여 검색

2. 컨텍스트 분리가 필요한 경우#

유사한 용어와 구조를 가진 문서들이 다른 맥락에서 사용될 때, 폴더 기능을 통해 정보 간 경계를 명확히 설정할 수 있습니다.
예시: 프랜차이즈 본사에서 각 지점별 정보 관리
각 지점(강남점, 역삼점, 선릉점 등)의 고유 정보(영업시간, 주차정보, 특별 메뉴)를 별도 폴더로 구성
에이전트는 사용자가 특정 지점에 관해 질문할 때 해당 지점 폴더의 정보만 참조하여 혼선 방지

3. 정보 접근 제어가 필요한 경우#

조직 내 역할과 권한에 따라 접근 가능한 정보를 제한하여 정보 보안을 강화합니다.
예시: 기업 내부 정보 접근 관리
'인사 정보', '재무 정보', '개발 문서', '전사 공통 정보' 등으로 폴더 구성
각 부서 직원은 자신의 업무 영역과 공통 정보에만 접근 권한을 부여받음
에이전트는 사용자의 권한에 맞는 폴더 내 정보만 참조하여 응답

4. 상품/서비스별 정보 분리가 필요한 경우#

다양한 상품이나 서비스 정보를 명확히 구분하여 정확한 응답을 제공합니다.
예시: 금융기관의 상품별 정보 관리
각 보험 상품, 투자 상품, 대출 상품별로 폴더 구성
고객이 가입한 특정 상품에 관한 질문 시, 에이전트는 해당 상품 폴더만 참조하여 정확한 정보 제공
상품 간 유사한 용어가 있더라도 맥락에 맞는 정확한 설명 가능
전문가 팁: 폴더 이름은 단순한 라벨이 아닌 내용을 직관적으로 나타내는 중요한 메타데이터입니다. 명확하고 구체적인 폴더명은 관리자뿐만 아니라 AI 에이전트의 컨텍스트 이해에도 도움을 줍니다. "문서1", "자료" 같은 모호한 이름 대신 "2024_인사정책", "고객응대_스크립트" 등 내용과 목적을 명확히 표현하는 명명 규칙을 사용하세요. 특히 우선탐색 폴더는 "공식_가이드라인", "최신_정책" 등 권위와 우선순위를 암시하는 이름을 부여하는 것이 효과적입니다.
전문가 팁: 폴더 구조를 설계할 때는 사용자의 질문 패턴과 정보 접근 요구사항을 고려하여 논리적인 구조를 갖추는 것이 중요합니다. 너무 세분화된 폴더 구조는 관리 복잡성을 증가시킬 수 있습니다.

우선탐색 옵션#

에이전트가 질문에 답변할 때 특정 폴더의 정보를 먼저 검색하도록 하는 Advanced 기능입니다.
이 기능은 유사한 내용이 여러 문서에 분산되어 있지만, 특정 문서의 정보가 더 신뢰할 수 있거나 우선시되어야 할 때 특히 유용합니다.
예를들어서 모든 영업 지점에서 적용되는 공통적인 지식이 포함된 문서가 있다면 해당 문서들을 하나의 폴더로 구분한 뒤에, 우선 탐색 폴더로 지정합니다. ex) 프랜차이즈명, 기본적인 응대 매뉴얼 등.
토글을 활성화 하여 우선 탐색 폴더로 지정할 수 있습니다.
Modified at 2025-10-17 08:39:55
Previous
문서
Next
피드백
Built with