Skip to main content
Cloosphere 채팅에서는 파일을 첨부하여 AI에게 분석을 요청하거나, 지식기반(Knowledge Base)을 연동하여 문서 기반 답변을 받을 수 있습니다.

파일 첨부 방법

다양한 방법으로 파일을 채팅에 첨부할 수 있습니다.
파일을 채팅 영역으로 끌어다 놓으면 자동으로 업로드됩니다. 여러 파일을 동시에 드래그할 수 있습니다.

지원 파일 형식

카테고리형식
문서PDF, DOCX, PPTX, TXT, MD, HTML
스프레드시트XLSX, CSV
이미지PNG, JPG, GIF, WebP, AVIF
코드PY, JS, TS, Java, C++ 등
데이터JSON, XML, YAML

파일 크기 제한

파일 최대 크기는 관리자 설정(file.max_size)에 따라 달라집니다. 제한을 초과하는 파일은 “File size should not exceed X MB” 오류 메시지와 함께 업로드가 거부됩니다.

이미지 분석

이미지 파일(PNG, JPG, GIF, WebP, AVIF)을 첨부하면 Vision 모델이 내용을 분석합니다.
  • 차트/그래프: 데이터 포인트 추출 및 분석
  • 문서 이미지: OCR 기반 텍스트 추출
  • UI 디자인: 디자인 피드백 및 코드 변환
  • 오류 화면: 에러 메시지 분석 및 해결책 제안
  • 사진: 객체 인식, 장면 설명
선택된 모델이 Vision을 지원하지 않는 경우, 이미지 첨부 시 “Selected model(s) do not support image inputs” 오류가 표시됩니다.
설정에서 이미지 압축을 활성화하면 고해상도 이미지를 지정된 크기로 자동 압축하여 전송 속도와 토큰 효율을 높일 수 있습니다.

문서 기반 파일 처리

이미지가 아닌 파일(PDF, DOCX, 코드 파일 등)은 업로드 시 자동으로 텍스트가 추출됩니다.
1

파일 업로드

위 방법 중 하나로 파일을 첨부합니다. 업로드 중에는 “uploading” 상태가 표시됩니다.
2

텍스트 추출

서버에서 파일 내용을 자동 추출합니다. 추출 완료 후 “uploaded” 상태로 변경됩니다.
3

컨텍스트 활용

추출된 텍스트가 AI 대화의 컨텍스트로 포함되어, 파일 내용에 대한 질문이 가능합니다.

지식기반 연동 (RAG)

# 명령어로 지식기반 참조

입력창에서 #을 입력하면 사용 가능한 지식기반 목록이 나타납니다. 선택한 지식기반의 문서를 검색하여 답변에 활용합니다.
#인사규정 연차 신청 절차가 어떻게 되나요?

RAG 동작 방식

1

쿼리 분석

사용자 질문에서 검색 쿼리를 생성합니다.
2

벡터 검색

지식기반에 저장된 문서 청크(chunk)를 대상으로 벡터 유사도 검색을 수행합니다.
3

컨텍스트 구성

검색된 관련 문서 청크를 AI 프롬프트의 컨텍스트에 삽입합니다.
4

응답 생성

AI가 검색된 문서를 참고하여 답변을 생성하고, 인용 출처를 함께 제공합니다.

에이전트 기반 RAG

에이전트 모델에 지식기반이 연결된 경우, # 명령어 없이도 자동으로 지식기반을 검색합니다. 워크스페이스 > 에이전트 설정에서 지식기반을 연결할 수 있습니다.

인용 출처 표시

지식기반 검색이나 웹 검색을 참조한 응답에는 인용 출처가 표시됩니다.

인용 목록

응답 하단에 참조한 문서들이 목록으로 표시됩니다.
표시 정보설명
문서명원본 파일명 또는 URL
관련도검색 유사도 기반 관련성 표시 (설정에 따라 퍼센트 또는 거리 값)
문서 수해당 출처에서 참조한 청크 수

원문 확인

인용 항목을 클릭하면 원문 모달이 열려 검색된 문서 청크의 전체 내용을 확인할 수 있습니다.
1

인용 배지 클릭

응답 하단의 인용 영역에서 출처 항목을 클릭합니다.
2

원문 확인

모달에서 검색된 문서 청크의 전체 텍스트와 메타데이터를 확인합니다.
3

신뢰성 검증

원문을 통해 AI 응답의 정확성을 직접 검증할 수 있습니다.
URL 기반 출처(웹 검색 결과)는 클릭 시 원본 웹 페이지로 바로 이동합니다.

Chat Controls의 파일 관리

제어 패널(Chat Controls)의 Files 섹션에서 현재 대화에 첨부된 파일 목록을 확인하고 관리할 수 있습니다.
  • 각 파일 항목에서 파일명, 유형, 크기를 확인
  • X 버튼으로 개별 파일 제거
  • 파일 클릭으로 상세 정보 확인