> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 파일

> PDF, Word, 텍스트, CSV, 이미지 파일을 업로드해 지식 베이스에 문서로 추가합니다.

# 파일

파일 문서는 로컬에 있는 문서나 이미지를 직접 업로드해 지식 베이스에 추가합니다. 사내 매뉴얼, 제품 카탈로그, 정책 문서처럼 웹에 공개되지 않은 자료를 에이전트가 바로 활용할 수 있게 해줍니다.

<img src="https://mintcdn.com/fleek/KJGN9YLDWG16egk5/images/screens/knowledge/knowledge-file.jpg?fit=max&auto=format&n=KJGN9YLDWG16egk5&q=85&s=b70d05582be006f91346b1e237a7ea82" alt="파일 문서 추가 다이얼로그" style={{ borderRadius: "0.5rem" }} width="1920" height="1080" data-path="images/screens/knowledge/knowledge-file.jpg" />

## 추가 방법

지식 베이스 상세 페이지의 **추가** 드롭다운에서 **파일**을 선택하면 다이얼로그가 열리고 **파일 업로드** 영역이 표시됩니다.

* 파일 업로드 영역을 클릭해 파일 선택기를 열거나, 파일을 직접 **드래그 앤 드롭**으로 끌어다 놓을 수 있습니다.
* 지원되지 않는 형식의 파일은 선택되지 않습니다.
* 선택한 파일은 목록 형태로 표시되며, 하단의 **확인** 버튼을 누르면 업로드와 파싱이 시작됩니다.

## 지원 형식

| 형식       | 확장자                     | 비고                                                     |
| -------- | ----------------------- | ------------------------------------------------------ |
| PDF      | `.pdf`                  | 텍스트 기반 PDF 권장. 스캔 이미지 PDF는 OCR 정확도에 따라 품질이 달라질 수 있습니다. |
| Word     | `.doc`, `.docx`         | Microsoft Word 문서                                      |
| 텍스트      | `.txt`                  | 일반 텍스트 파일                                              |
| Markdown | `.md`                   | 명확한 단락 구분으로 검색 정확도가 높습니다.                              |
| CSV      | `.csv`                  | 쉼표로 구분된 표 형태 데이터                                       |
| 이미지      | `.png`, `.jpg`, `.jpeg` | OCR로 텍스트를 추출해 활용합니다.                                   |

## 제약 사항

| 항목                | 값     |
| ----------------- | ----- |
| 파일당 최대 크기         | 10 MB |
| 한 번에 업로드 가능한 파일 수 | 5개    |
| 한 번의 업로드 총 용량 합계  | 10 MB |

<Note>
  Markdown(`.md`) 형식은 단락 구분이 명확해 청크 분할과 검색 정확도가 가장 높습니다. 가능하면 Markdown으로 변환해 업로드하는 것을 권장합니다.
</Note>

<Warning>
  이미지 파일(`.png`, `.jpg`, `.jpeg`)은 OCR로 텍스트를 추출합니다. 해상도가 낮거나 손글씨가 포함된 이미지는 추출 정확도가 떨어질 수 있습니다.
</Warning>

## 관련 문서

* [지식 베이스 개요](/docs/build/knowledge/overview)
* [웹페이지](/docs/build/knowledge/webpage)
* [텍스트](/docs/build/knowledge/text)

***

<Accordion title="연관 검색어">
  파일 업로드, file upload, PDF, DOCX, CSV, OCR, 지식 베이스 파일, 파일 형식
</Accordion>