파일 첨부와 문서 작업
이미지·텍스트·PDF·Office 문서를 대화에 첨부하고, AI가 문서를 읽고 검색하고 수정하고 새로 만들게 합니다.
파일 첨부하기
두 가지 방법이 있습니다.
- 입력창의 + 메뉴에서 파일 추가를 선택합니다. 파일만 가능하며 폴더는 첨부할 수 없습니다.
- 대화 영역으로 파일을 끌어다 놓습니다.
입력창이 비활성화된 상태(모델 없음, 토큰 한도 소진, 폴더 유실)에서는 끌어다 놓기도 막힙니다.
제한
| 항목 | 값 |
|---|---|
| 파일당 크기 | 25MB 이하 |
| 문서 형식 | PDF, .docx, .xlsx, .pptx |
| 이미지·텍스트 | 지원 (이미지는 모델의 입력 형식에 따라) |
.hwp, .hwpx | 지원 |
거부되면 다음 안내가 표시됩니다.
- "지원되지 않는 파일 형식입니다."
- "25MB 이하 파일만 첨부할 수 있습니다."
첨부 파일이 처리되는 방식
| 형식 | 처리 |
|---|---|
| 이미지·텍스트 | 메시지에 직접 포함됩니다. |
| PDF, Word, Excel, PowerPoint | 호스트 서버에 업로드되어 앱 데이터 폴더의 첨부 폴더에 저장되고, 저장 경로가 AI에게 전달됩니다. AI는 그 경로를 도구로 읽습니다. |
- 업로드된 파일은 7일간 보관된 뒤 앱 시작 시 정리됩니다.
- 첨부 폴더는 권한 카드 없이 읽을 수 있습니다.
- 모델이 이미지 또는 PDF 입력을 지원하지 않으면, 해당 파트는 "읽을 수 없음" 안내로 바뀌어 AI에게 전달됩니다. 모델별 입력 형식(text / image / pdf)은 기관 모델 설정(파일 업로드 지원 여부)을 따릅니다.
문서 도구
AI는 문서 파일을 다루기 위해 전용 document_* 도구를 사용합니다. 일반 파일 읽기나 셸 명령으로는 이 형식을 읽을 수 없습니다. helpy-docs 스킬이 사용법을 안내합니다.
| 도구 | 역할 |
|---|---|
document_overview | 처음 보는 문서의 크기와 목차(개요)를 확인 |
document_read | 문서의 일부 읽기. 범위를 지정("3", "3-5"). 긴 문서는 나누어 읽습니다. |
document_search | 단어·이름이 나오는 위치(페이지·주소) 찾기 |
document_inspect | 요소의 주소와 현재 속성 확인 |
document_help | 형식별 편집 문법 안내, 디자인 규칙(skill:pptx, skill:word, skill:excel) |
document_edit | 문서 수정. 한 번에 여러 변경(ops)을 보내며, 하나라도 실패하면 아무것도 저장되지 않습니다. |
document_create | 새 문서 생성. 템플릿이나 다른 파일을 from으로 복사해 시작할 수 있습니다. |
document_vision | 헬피비전 도큐먼트 OCR. 스캔 PDF, 표, 차트, 수식을 구조째 읽습니다. |
번호는 모두 1부터 시작합니다(페이지, 슬라이드, 행, 블록).
읽기
document_overview로 큰 그림을 봅니다.- 찾는 내용이 있으면
document_search로 위치를 찾습니다. document_read로 필요한 부분만 읽습니다. 외형(스타일, 글꼴)이 중요하면 서식 있는 읽기 모드를 씁니다.
스캔된 페이지, 표, 차트가 필요하면 document_vision을 사용합니다. 이 도구는 파일을 엘리스 문서 서비스로 전송하고, 전체 PDF를 한 번에 처리하므로 느립니다(수십 초~수 분). 한 번 처리한 결과는 보관되어, 이후 pages 또는 labels(예: chart, table)로 즉시 일부만 다시 요청할 수 있습니다. PDF만 지원합니다.
수정
document_search나document_inspect로 정확한 위치를 찾습니다.document_edit로 해당 단계의 변경을 한 번에 보냅니다.- 변경한 부분을
document_read로 다시 읽어 확인합니다.
- 슬라이드에서 글자가 넘치거나 단어가 중간에 잘리거나 글자색이 배경에 묻히면,
document_edit이 "Fix before you finish"로 알려 줍니다. AI는 이를 고친 뒤 끝냅니다. - 위치 주소(
/body/p[4],/slide[3])는 요소를 추가·삭제하면 밀리므로 변경 후 다시 찾습니다. 가능하면 안정적인 id를 씁니다. - PDF는 페이지 단위로만 바꿀 수 있습니다(페이지 추출, 삭제, 회전).
- 비밀번호가 걸렸거나 읽기 전용인 문서는 작업하지 않고 사용자에게 알립니다.
새로 만들기
대형 문서(덱, 보고서, 스프레드시트 모델)는 먼저 document_help로 디자인 규칙을 불러온 뒤 document_create로 만듭니다. 팀 템플릿이 있으면 from으로 템플릿을 지정해 그 모양대로 시작하세요. 템플릿 파일은 바뀌지 않고 복사본이 만들어집니다.
문서 작업은 셸 명령(officecli, unzip, python 등)으로 하지 않도록 안내되어 있습니다. 셸로 하면 매번 권한 확인이 뜨고 필요도 없기 때문입니다.
사용 가능한 형식
| 형식 | 도구 지원 | 조건 |
|---|---|---|
.pdf | 읽기, 검색, OCR, 페이지 단위 편집 | PDF 처리 라이브러리가 앱에 포함되어 있을 때 |
.docx .xlsx .pptx | 읽기, 검색, 편집, 생성 | officecli가 앱에 포함되어 있을 때 |
.hwp .hwpx | 읽기, 검색, 편집, 생성 | 한글 처리 모듈(rhwp)이 앱에 포함되어 있을 때 |
문서 처리 백엔드가 없는 환경에서는 해당 도구와 helpy-docs 스킬이 아예 제공되지 않습니다.
완성된 파일 보여 주기
AI는 작업이 끝나면 present_files로 완성된 파일만 모아 파일 카드로 보여 줍니다(중간 파일 제외). 카드에는 미리보기와 파일열기가 있고, 모든 파일은 우측 패널의 대화 내 생성파일에서 볼 수 있습니다. 우측 패널