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

# 파일 커넥터 (CSV · JSON · Excel)

> CSV · JSON · Excel 파일을 업로드해 데이터 소스로 등록합니다.

## 개요

파일 커넥터는 CSV · JSON · Excel 파일을 업로드해 데이터 소스로 등록합니다.
CSV·JSON은 브라우저에서 직접 파싱하고, Excel은 워크북을 파싱합니다.
직접 업로드는 **최대 10MB**까지 가능하며, 원본 파일은 등록 시 소스로 보관됩니다.

<Info>
  이 화면은 **관리자(Manager) 이상**(owner·manager)만 접근할 수 있습니다. 메뉴 가시성 `manage`.
</Info>

## 형식별 단계

파일 마법사의 단계는 형식에 따라 동적으로 달라집니다.

<Tabs>
  <Tab title="CSV">
    데이터 뷰 · 필터링 → 데이터 매핑 → 등록
  </Tab>

  <Tab title="Excel">
    **시트 · 영역** → 데이터 뷰 · 필터링 → 데이터 매핑 → 등록

    시트를 선택하고, 시작 셀에서 끝 셀까지 드래그해 데이터 영역(사각형)을 지정합니다. 지정하지 않으면 전체 시트를 사용합니다.
  </Tab>

  <Tab title="JSON">
    **키 선택** → 데이터 뷰 · 필터링 → 데이터 매핑 → 등록

    `json_path`를 드릴다운해 대상 위치를 선택합니다. **배열**을 고르면 데이터 뷰로 넘어가고, **단일 객체**를 고르면 한 건으로 매핑합니다.
  </Tab>
</Tabs>

## 데이터 뷰 · 필터링

<Steps>
  <Step title="파일 업로드">
    파일을 드래그하거나 클릭해 선택합니다(단일 파일, 최대 10MB).
  </Step>

  <Step title="제목줄 선택">
    첫 6행 중에서 컬럼명이 될 제목줄을 고릅니다. 제목이 없으면 **"제목 없음"** 을 눌러 표에서 컬럼명을 직접 지정합니다.
  </Step>

  <Step title="필터 설정 (선택)">
    조건에 맞는 행만 사용하도록 필터를 추가합니다. 여러 조건은 모두 만족(AND)하는 행만 사용됩니다.
  </Step>

  <Step title="컬럼 편집">
    상위 100행 미리보기를 보며 컬럼명을 편집하고, 사용할 컬럼을 포함/제외로 토글합니다.
  </Step>
</Steps>

이후 [공용 마법사](/agent/data-sources#공용-마법사-4단계)의 **데이터 매핑**과 **등록** 단계를 거쳐 완료합니다.

## 원본 보관 · 보안

<Note>
  원본 파일은 소스로 보관되고, 설정(컬럼 · 타입 · 필터 · 매핑)만 저장됩니다.
  데이터는 복사하지 않고, 읽을 때 이 설정을 적용해 파생합니다.
</Note>

<Warning>
  데이터소스를 수정해도 원본 파일은 그대로 유지되며, 설정만 변경됩니다.
</Warning>