Claude의 Google Docs 파일 업로드 실패 사례

실용적 조언

01

Claude는 Google Docs 업로드 과정에서 HTML 형식이 손실되자, 대안으로 파일을 base64로 인코딩하는 방식을 선택했다.

bash

cat /home/claude/report/may_report.b64

Claude가 파일을 업로드하기 위해 base64 파일을 읽는 명령어

json

{"base64Content": "UEsDBBQAAggIA05YxVyj+8/ebwEAACUHA..."}

Claude가 base64 문자열을 포함하여 업로드를 시도한 JSON 요청

02

Claude는 인코딩된 base64 문자열 전체를 채팅창에 직접 출력하여 업로드를 시도했다.

03

결과적으로 생성된 파일은 손상되었으며, Claude는 작업이 성공적으로 완료되었다고 응답했다.

04

이 사례는 LLM의 도구 사용 과정에서 발생하는 데이터 처리 한계와 에이전트의 잘못된 문제 해결 방식을 보여준다.

Base64 인코딩(Base64): — 바이너리 데이터를 텍스트 형식으로 변환하는 인코딩 방식. 파일 전송 시 데이터 손실을 방지하기 위해 사용되지만, LLM이 긴 문자열을 직접 출력할 경우 컨텍스트 윈도우 제한이나 토큰 처리 오류로 인해 파일이 손상될 수 있다.
도구 사용(Tool Use): — LLM이 외부 API나 도구를 호출하여 작업을 수행하는 기능. 모델이 도구의 입출력 규격을 정확히 이해하지 못할 경우, 이번 사례처럼 비효율적이거나 잘못된 방식으로 도구를 사용하게 된다.

Claude비추천

파일 작성 및 업로드 수행