> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/resources-context/files.md).

# 파일

이 문서에서는 **리소스** 의 **파일** 기능을 설명합니다. **파일**에서는 사양서, 설계 문서, 이미지, PDF, 동영상, JSON 데이터 파일, HTML 파일, Office 파일 등 워크스페이스에서 사용하는 파일을 업로드하여 관리할 수 있습니다. Google Drive에서 공유한 파일도 업로드한 파일과 함께 프로젝트 파일 목록에 표시됩니다. 업로드된 텍스트 기반 파일(Markdown, 텍스트, JSON 등)은 AI에 의해 인덱싱되어 AI 어시스턴트나 워크플로 실행 시 참조됩니다. 이미지, PDF, 동영상, Office 파일, Google Drive에서 공유한 파일도 채팅, 워크플로, 스페이스에서 선택해 사용할 수 있습니다. Markdown 파일은 읽기 쉬운 문서 보기로, HTML 파일은 브라우저 미리보기로, CSV / TSV 파일은 표 형태로, PDF와 동영상은 파일 상세 페이지에서 미리 볼 수 있습니다.

## 파일 업로드하기

1. 워크스페이스 페이지에서 **리소스**를 선택하십시오.
2. **파일** 탭을 선택하십시오.
3. **파일 업로드**를 클릭하십시오.
4. 다음 중 한 가지 방법으로 파일을 선택하십시오.
   * **파일 선택**: 개별 파일을 선택하여 업로드합니다.
   * **폴더 선택**: 폴더 안의 파일을 한꺼번에 업로드합니다.
   * 대화 상자에 드래그 앤 드롭합니다.
5. 필요에 따라 **레이블**을 설정하십시오.
6. **파일 업로드**를 클릭하십시오.

{% hint style="info" %}
기존 파일과 같은 이름의 파일을 업로드하면 해당 파일의 새 버전으로 처리됩니다.
{% endhint %}

{% hint style="info" %}
Google Drive 파일 선택기에서 파일을 추가할 때 이미 Google에 로그인했는데도 다시 로그인을 요구한다면, google.com의 서드파티 쿠키를 허용한 뒤 다시 시도하십시오. 파일 선택기는 삽입된 Google 프레임 안에서 동작합니다.
{% endhint %}

스페이스 안의 **파일** 도 같은 추가 흐름을 사용합니다. 새 파일은 업로드하고, 이미 워크스페이스에 있는 파일이나 Google Drive 파일은 링크해서 추가할 수 있습니다.

## 지원하는 파일 형식

| 파일 형식        | 확장자                                                                        | 상한 크기  |
| ------------ | -------------------------------------------------------------------------- | ------ |
| Markdown·텍스트 | .md / .markdown / .txt                                                     | 20 MB  |
| JSON         | .json                                                                      | 20 MB  |
| HTML         | .html / .htm                                                               | 20 MB  |
| 이미지          | .jpg / .jpeg / .png                                                        | 10 MB  |
| PDF          | .pdf                                                                       | 50 MB  |
| 동영상          | .mp4 / .webm / .mov / .avi                                                 | 200 MB |
| Office       | .doc / .docx / .docm / .xls / .xlsx / .xlsm / .xlsb / .ppt / .pptx / .pptm | 20 MB  |

{% hint style="info" %}
JSON 파일은 [**대시보드**](/features-ko/dashboard/dashboard.md) 위젯의 데이터 소스로 사용할 수 있습니다. 파일 상세 페이지에서는 JSON 파일을 Excel 스프레드시트로 내보낼 수도 있습니다.
{% endhint %}

{% hint style="info" %}
Markdown 파일은 파일 상세 페이지에서 읽기 쉬운 문서 보기로 표시됩니다. HTML 파일도 같은 화면에서 바로 미리 볼 수 있고, CSV / TSV 파일은 표 형태로 표시됩니다. PDF는 뷰어 너비에 맞춰 표시되므로 큰 페이지도 더 확인하기 쉽습니다.
{% endhint %}

{% hint style="info" %}
동영상 파일은 채팅과 워크플로에서 참조할 수 있으며, AI 어시스턴트의 **동영상 분석** 도구로 내용을 확인할 수 있습니다. MP4 같은 지원 동영상은 파일 상세 페이지에서도 바로 재생할 수 있습니다. 동영상 분석은 조직에서 Google 프로바이더를 사용할 수 있는 경우에 이용할 수 있습니다.
{% endhint %}

{% hint style="info" %}
Google Drive에서 공유한 파일은 채팅, 워크플로 프롬프트, 스페이스의 **파일**에서 사용하는 파일 브라우저에도 같은 방식으로 표시됩니다. Google 스프레드시트는 Google Drive 파일로 추가되며, 편집 권한으로 공유한 시트는 AI가 업데이트할 수 있고 그렇지 않은 경우 읽기 전용으로 유지됩니다.
{% endhint %}

## 파일 표시·검색하기

<figure><img src="/files/Qwz8SCI1al7eFRDvcM4w" alt="파일 목록 스크린샷"><figcaption><p>파일 목록</p></figcaption></figure>

* 화면 오른쪽 위에서 **목록** 표시와 **그리드** 표시를 전환할 수 있습니다.
* 검색 상자에서 파일 이름으로 검색할 수 있습니다.
* **현재 폴더**와 **모든 파일**을 전환하여 현재 폴더 안만 검색할지, 워크스페이스 전체를 검색할지 선택할 수 있습니다.
* **레이블**에서 하나 이상의 레이블로 좁힐 수 있습니다.

각 파일에는 파일 유형 아이콘, 파일 이름, 레이블, 인덱스 상태, 파일 크기, 형식, 수정 일시, 업로드한 사람 등이 표시됩니다. CSV / TSV 파일을 열면 파일 상세 페이지에서 표 미리보기를 확인할 수 있습니다.

Markdown 및 텍스트 파일 미리보기에서는 본문을 선택하거나 문단 옆 버튼에서 댓글 스레드를 시작할 수 있습니다. 파일 세부 정보 페이지의 댓글 패널에서 스레드와 답글을 확인할 수 있으며, 댓글이 있는 위치에는 마커가 표시됩니다. 원래 본문이 편집되었거나 더 이상 찾을 수 없으면 그 상태도 스레드에 표시됩니다.

## 파일 조작하기

각 파일의 메뉴에서 다음과 같은 작업을 실행할 수 있습니다.

* **버전 기록 확인**
* **새 버전 업로드**
* **버전 이름 변경**
* **이전 버전 복원**
* **다른 폴더로 이동**
* **레이블 편집**
* 텍스트 기반 파일의 **재색인**
* **다운로드**
* JSON 파일의 **Excel로 다운로드**
* **삭제**

버전 기록에서는 각 버전을 누가 만들었는지 확인할 수 있습니다. 워크플로가 생성한 버전에는 워크플로 이름과 실행 번호도 함께 표시되며, 파일 상세 페이지에서 관련 워크플로 실행을 열 수 있습니다. 워크플로 실행 중에 저장할 폴더를 따로 선택하지 않은 파일은 기본적으로 해당 워크플로의 **Artifacts** 폴더에 저장됩니다.

{% hint style="warning" %}
재색인은 인덱싱 대상인 텍스트 기반 파일(Markdown, 텍스트, JSON)만 지원합니다.
{% endhint %}

## 폴더 관리하기

화면 왼쪽의 폴더 트리를 사용하여 파일을 폴더 단위로 정리할 수 있습니다.

* **폴더 만들기**: **새 폴더**를 클릭합니다.
* **폴더 이동하기**: 드래그 앤 드롭하거나 폴더 메뉴에서 이동합니다.
* **폴더 다운로드하기**: 폴더 메뉴에서 ZIP 파일로 다운로드합니다.
* **폴더 삭제하기**: 폴더 메뉴에서 삭제합니다.

{% hint style="warning" %}
폴더를 삭제하면 그 폴더 안의 파일도 모두 삭제됩니다. 이 작업은 되돌릴 수 없습니다.
{% endhint %}

## 파일 일괄 조작하기

파일 목록에서 1개 이상 선택하면 일괄 작업 바가 표시됩니다.

* **레이블 추가**
* **이동**
* **다운로드**: 선택한 파일을 하나의 ZIP 파일로 다운로드합니다.
* **삭제**
* **선택 해제**