CLAWPOD ENGINEERING

CSV 첨부를 어디까지 읽었나요? 미리보기와 전체 검토 구분하기

ClawPod Cloud의 첨부 업로드·미리보기 기준을 구분하고, 긴 CSV의 필요한 구간을 요청·집계·검증하는 방법을 알아봅니다.

ClawPod Engineering · 5분 읽기
검토Editorial Review · Security Review
AI 생성 설명용 사진. 두꺼운 서류 묶음 위에서 몇 장만 펼쳐지고 청록색 탭이 보이는 모습입니다.
앞부분만 보이는 미리보기를 비유한 AI 생성 이미지이며 실제 제품 화면이 아닙니다.

CSV 파일이 미리보기에서 열렸다고 해서 마지막 행까지 확인한 것은 아닙니다. 이 글은 ClawPod Cloud의 Chat Room에서 자료를 주고받는 실무자를 위한 안내입니다. 파일을 올릴 수 있는 Room과 공유가 허용된 자료를 준비했다면, 미리보기로 확인할 범위와 별도로 내려받아 검토할 범위를 구분할 수 있습니다.

핵심은 세 가지입니다. 업로드 허용, Portal 미리보기, Agent의 파일 읽기·생성은 서로 다른 확인 항목입니다. 미리보기는 원본 전체 검토나 안전성 검사를 대신하지 않습니다. 검토 결과에는 파일명과 실제로 읽은 범위를 함께 남기세요.

크기 제한은 무엇을 제한하는지와 함께 읽으세요

아래 수치와 형식은 2026년 9월 27일 확인한 공식 Guide의 문서 기준입니다. 현재 사용 환경의 화면을 직접 시험한 결과는 아니므로, 문서와 실제 동작이 다르면 파일명·크기·형식·오류를 확인해 문의하세요.

대상 문서의 기준 의미
Chat Room 업로드 파일당 최대 50 MiB 미리보기 상한이나 전체 저장 용량이 아닙니다
텍스트 미리보기 1 MiB 초과 시 앞부분 256 KiB만 표시 파일의 마지막 부분까지 읽었다는 근거가 아닙니다
PDF 미리보기 10 MiB 이하 더 큰 PDF는 내려받아 확인합니다
Task·Milestone 첨부 파일당 최대 50 MiB Chat과 허용 형식 목록은 별도입니다

MiB와 KiB는 파일 크기의 단위입니다. 1 MiB는 1,048,576바이트이고 1 KiB는 1,024바이트입니다. Guide는 업로드 상한을 50 MiB로 적고 화면 표기는 50 MB라고 설명합니다. 팀 문서에는 단위를 생략하거나 두 값을 바꾸어 쓰지 말고 **“파일당 50 MiB, Guide가 설명하는 화면 표기는 50 MB”**라고 남기세요.

256 KiB는 행 수가 아닙니다. 같은 크기의 CSV라도 열 수와 글자 길이에 따라 보이는 행 수가 달라질 수 있습니다. 또한 이 수치는 Portal의 텍스트 미리보기에 관한 것입니다. Agent가 파일을 어느 도구로 얼마나 읽었는지, 어떤 내용을 분석했는지를 이 수치만으로 판단하지 마세요. 실제 읽기 범위는 별도로 보고받아 검증해야 합니다.

형식 이름보다 미리보기 조건을 확인하세요

MIME type은 파일의 종류를 나타내는 값입니다. Guide에 따르면 텍스트 미리보기는 저장된 MIME type이 text/plain, text/csv, text/markdown인 파일에 제공됩니다. Markdown 첨부가 어떤 글꼴이나 배치로 보이는지, HTML처럼 렌더링되는지는 이 안내에서 보장하지 않습니다.

Chat에서 허용하는 범주 확장자 문서에 안내된 열람 방식
이미지 .jpg, .jpeg, .png, .gif, .webp, .bmp 이미지 미리보기, 브라우저가 표시하지 못하면 다운로드
문서 .pdf, .docx, .xlsx, .pptx, .hwp, .hwpx PDF는 10 MiB 이하 미리보기, 나머지는 다운로드
텍스트 .txt, .text, .csv, .md, .markdown, .env, .log, .ini, .conf, .cfg, .properties 저장 MIME type에 따른 텍스트 미리보기, 1 MiB 초과 시 앞부분 256 KiB
데이터·설정 .json, .jsonl, .yaml, .yml, .toml 다운로드
HTML .html, .htm 다운로드, Chat 첨부의 HTML 실행·미리보기 미제공
동영상 .mp4 다운로드, Portal 내 재생 미제공
압축 파일 .zip 다운로드

따라서 XLSX가 미리보기로 열리지 않는다는 사실만으로 업로드 실패라고 단정하지 마세요. 허용 형식인지, 업로드가 성공했는지, 다운로드가 가능한지를 각각 확인합니다. 다운로드가 된다는 사실 역시 파일 전체를 검토했다거나 안전하다는 뜻은 아닙니다.

Task는 업무를 기록하는 항목이고 Milestone은 업무 묶음의 기준점입니다. 이 둘의 첨부는 JPEG·PNG·GIF·WebP·BMP, PDF·DOCX·XLSX·PPTX, TXT·CSV·Markdown, HWP·HWPX, ZIP의 기존 MIME 허용 목록을 사용합니다. Chat에서 허용하는 HTML·MP4·JSON·YAML 등의 추가 형식을 Task·Milestone에도 그대로 적용하지 마세요.

지원 확장자는 대소문자를 구분하지 않습니다. Guide는 브라우저가 MIME type을 비우거나 다르게 보내도 확장자에 맞춰 정규화하며, 그 밖의 파일은 기존 허용 MIME type에 해당할 때 업로드될 수 있다고 설명합니다. 그러나 .svg, .svgz, .js, .mjs, .cjs, .exe, .msi, .com, .bat, .cmd, .ps1, .sh는 MIME type과 무관하게 차단합니다. 확장자를 바꾸는 것은 파일 변환이나 안전성 검증이 아니며, 제한을 우회하는 방법으로 사용하면 안 됩니다.

예시: 긴 CSV에서 필요한 구간만 검토하기

다음은 가상 예시입니다. 파일명, 크기, 행 번호와 결과는 실제 실행 기록이나 제품의 자동 처리 보장이 아닙니다. 여기서 행 번호는 헤더를 제외한 데이터 레코드 순번으로 정합니다.

팀에 2 MiB 크기의 support-log.csv가 있고, 마지막 구간인 9,901~10,000번 레코드의 문의 유형만 집계하려고 합니다. Portal 미리보기의 앞부분만으로 이 구간을 확인할 수 있다고 가정하지 않습니다. 담당자는 조직이 승인한 도구로 해당 구간의 사본 support-log-9901-10000.csv를 만들고, 이름·연락처·고객 식별자를 제거한 뒤 헤더와 100개 레코드가 남았는지 확인합니다. 이는 권장 준비 절차이지 Portal의 자동 분할 기능 설명이 아닙니다.

요청

첨부한 support-log-9901-10000.csv는 원본 support-log.csv의 데이터 레코드 9,901~10,000번을 추린 사본입니다. 이 사본 전체를 읽을 도구가 있는지 먼저 확인하세요. 문의 유형별 건수를 집계하고, 실제 읽은 파일명·레코드 수·범위를 알려 주세요. 원본 전체를 검토했다고 쓰지 말고, 파일 수정·덮어쓰기·외부 전송은 하지 마세요. 전부 읽을 수 없거나 범위가 맞지 않으면 집계를 확정하지 말고 부족한 내용을 알려 주세요.

채워진 결과 표본 — 가상 예시

확인 항목 예시 응답
읽은 입력 support-log-9901-10000.csv, 헤더 제외 100개 레코드
범위 제공된 사본 전체. 원본의 9,901~10,000번이라는 대응은 담당자가 제공한 정보
집계 배송 60건, 환불 25건, 기타 15건, 합계 100건
검토하지 않은 범위 원본의 나머지 레코드와 원본 전체의 완전성
변경·전송 파일 수정·덮어쓰기·외부 전송 없음

성공 확인은 “요약 완료”라는 문장으로 끝내지 않습니다. 담당자는 승인된 도구로 사본의 100개 레코드와 유형별 건수를 독립적으로 대조합니다. 합계가 100이라고 해서 분류가 맞다는 뜻은 아니므로 각 유형도 확인합니다. 원본과 사본의 첫·마지막 레코드 및 추출 범위를 비교하고, 요청한 금지 사항의 준수도 Agent의 작업 기록에서 확인합니다. Agent가 사본만 받았다면 원본과의 대응을 독립 검증했다고 해석하지 마세요.

Agent가 앞부분만 읽었거나 도구가 없어 전체를 읽지 못했다면 결과는 미완료입니다. 부족한 구간을 확인하고, 승인된 방법으로 더 작은 사본을 나누어 제공하거나 담당자가 내려받은 파일을 직접 검토합니다. 다시 요청할 때는 사본마다 원본 범위를 적고, 구간의 겹침·누락을 확인하세요. 미리보기 제한과 Agent 도구의 읽기 제한은 별개의 원인이므로 어느 단계에서 잘렸는지 먼저 구분합니다.

첨부 파일과 artifact를 혼동하지 마세요

첨부는 대화에 올린 파일입니다. artifact는 Agent가 대화에서 생성한, 버전이 있는 결과물입니다. Guide는 HTML 첨부는 다운로드만 제공하지만 Markdown·HTML artifact는 Artifact panel에서 미리보기한다고 구분합니다. 같은 .html이라는 이름만으로 두 경로를 같게 취급하지 마세요.

업로드가 허용된 형식이라고 해서 Agent가 그 형식을 만들 수 있는 것도 아닙니다. PDF·DOCX·XLSX·PPTX·ZIP 생성은 해당 도구가 실행 환경에 실제 준비되어 있는지 먼저 확인해야 합니다. 결과물을 요청한다면 파일명·형식·경로·덮어쓰기 허용 여부·외부 전송 여부를 함께 지정하고, 받은 파일을 대화와 별도로 검토하세요.

이 글의 크기 수치는 업로드와 미리보기의 문서상 기준입니다. 전체 저장 용량, 보관 기간, 한 메시지의 첨부 개수, 다운로드 자체의 별도 크기 상한은 이 근거로 확정하지 않습니다. 미리보기에서 잘린 나머지를 이어 보는 조작 방법도 확인하지 않았습니다. 중요한 원본과 결과물은 조직이 승인한 저장소에 따로 보관하세요.

올리기 전 공유 범위와 내용을 함께 확인하세요

Room은 사용자와 Agent가 같은 대화 맥락에서 협업하는 공간이며, 접근 범위와 참가자는 조직 권한에 따라 제한됩니다. Guide에 따르면 참가 Agent 모두가 Room 메시지를 받아 처리할 수 있으므로, 특정 Agent를 언급했다는 이유만으로 다른 참가자에게 자료가 보이지 않는다고 가정하지 마세요. 정확히 한 Agent만 작업해야 한다면 그 Agent만 포함한 전용 Room을 사용합니다.

업로드 전에 개인정보·비밀값·고객 데이터를 확인하세요. .env와 .env.production이 인식된다는 것은 API key나 비밀번호 공유를 허용한다는 뜻이 아닙니다. 값을 제거한 사본을 쓰고, 실제 비밀값은 조직의 보호된 전달 절차를 따르세요. 미리보기는 보안 검사나 완전한 파일 검증이 아니므로 받은 ZIP·Office 문서·이미지를 실행하거나 외부 공유하기 전에도 조직의 보안 절차가 필요합니다.

파일을 올리는 행위는 자동 외부 전송이나 영구 보관을 지시하는 것이 아닙니다. 다음 첨부 요청에는 **“이 파일의 어느 범위를 읽고, 어떤 증거로 확인할지”**를 한 줄 덧붙이세요. 그것이 앞부분을 본 것과 필요한 자료를 끝까지 검토한 것을 구분하는 출발점입니다.

Sources