> ## Documentation Index > Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt > Use this file to discover all available pages before exploring further. # 문서 업로드 > 지식에 파일 추가 — 드래그·드롭, URL 붙여넣기, 링크에서 임포트. 워크스페이스의 Knowledge 페이지는 전체 Foundry 파이프라인을 세팅하지 않고 Nora 에 문서를 넣는 가장 빠른 방법입니다. ## 업로드 방법 ### 드래그·드롭 문서 컬렉션 열기. 페이지 어디든 파일 드롭. 업로드는 백그라운드에서 실행 — 파일별 진행과 완료 상태 표시. 지원 포맷: * **텍스트**: `.txt`, `.md`, `.mdx`, `.rst`, `.tex` * **문서**: `.pdf`, `.docx`, `.doc`, `.pages`, `.rtf` * **웹**: `.html`, `.htm` * **데이터**: `.csv`, `.tsv`, `.xlsx`, `.json` * **프레젠테이션**: `.pptx`, `.key` * **이메일**: `.eml`, `.msg` * **코드**: `.js`, `.ts`, `.py`, `.go`, `.rs`, `.java`, `.rb`, `.php`, `.cpp`, `.c`, `.sql` 파일당 최대 100 MB. 더 큰 파일은 Foundry 파이프라인으로. ### URL 붙여넣기 **Import URL** 클릭 후 링크 붙여넣기. Nora 가 fetch 하고 읽기 좋은 콘텐츠 추출 (내비·광고·쿠키 배너 드롭) 후 문서로 추가. 지원: * 공개 웹페이지 (readability 추출). * 공개 Google Docs. * 공개 Notion 페이지. * 원시 파일 URL (응답의 파일 타입 사용). ### CLI 에서 ```bash theme={null} nora knowledge upload --collection nora knowledge upload-url --collection ``` 스크립트 벌크 업로드에 좋음. ## 업로드 후 1. **추출** — 파일에서 텍스트·표 끌어냄. 2. **중복 제거** — 컬렉션에 대한 콘텐츠 해시 체크. 동일 업로드는 스킵. 3. **청크** — 컬렉션의 기본 청커로 리트리벌 가능한 조각으로 분할. 4. **강화** — 임베딩, 자동 태깅, 엔티티 추출. 5. **인덱스** — 리트리벌 인덱스에 쓰임. 몇 초 안에 라이브. 문서 로우에서 상태 진행을 볼 수 있음 — `uploading → extracting → chunking → indexing → ready`. ## 컬렉션 기본값 설정 각 컬렉션은 기본 청커 설정과 기본 강화기를 가짐. **Collection settings → Ingest defaults** 에서 변경. 새 업로드는 현재 기본값 사용; 기존 청크는 **Reprocess** 를 누르지 않는 한 재처리되지 않음. ## 메타데이터 업로드 중 메타데이터 추가: * **Tags** — 자유 형식 또는 워크스페이스 태그 팔레트에서. * **Folder** — 컬렉션 안에서 정리. * **Source URL** — 문서가 원래 산 곳. 인용으로 표시. * **커스텀 필드** — 워크스페이스에서 정의한 필드. 메타데이터는 문서 로우에서 언제든 편집 — 청크 재처리 없이 즉시 반영. ## 벌크 업로드 100 개 이상 파일은 CLI 또는 Foundry 파이프라인. 웹 업로드는 한 번에 수십 개까지 괜찮지만 그 이상은 느려짐. ## 실패한 업로드 흔한 원인: * 암호화된 PDF — Nora 가 텍스트 추출 못 함. 먼저 해독. * 이미지 전용 PDF — 컬렉션 설정에서 OCR 활성화 (지연 추가, 작은 비용). * 100 MB 넘는 파일 — 분할 또는 파이프라인 사용. * 손상된 파일 — 추출기가 한 번 재시도 후 실패. 파일을 깔끔하게 재익스포트. 모든 실패는 문서 로우에 이유 표시, **details** 아래에 전체 로그.