실제로 완성되는 100페이지 분량의 문서

올해 초 저희는 수백 페이지 분량의 문서 및 프레젠테이션 생성에 대해 글을 썼습니다. 100페이지짜리 보고서를 요청할 수 있는 것과, 매번 87번째 페이지가 3번째 페이지만큼 훌륭한 퀄리티로 100페이지 전체를 온전히 받아보는 것은 완전히 다른 문제였습니다. 이는 올해 저희가 받은 가장 좌절스러운 버그 리포트의 원인이기도 했습니다. 바로 문서가 완성된 것처럼 보이지만 14페이지에서 멈춰버리는 문제였습니다.

이 글에서는 긴 문서 생성 기능이 작동하는 방식, v1.11.1에서 변경된 사항, 그리고 매우 긴 문서가 필요할 때 최상의 결과를 얻는 방법을 설명합니다.

긴 문서가 만들어지는 방식

NextDocs는 하나의 모델에 한 번에 100페이지를 작성하도록 요구하지 않습니다. 세 가지 역할이 작업을 나누어 처리합니다:

• **라우터(Router)**는 사용자의 요청을 읽고 어떤 종류의 문서인지, 길이는 얼마나 되는지, 어떤 구조인지, 그리고 어떤 레인(lane)을 사용할지 결정합니다.
• **생성 모델(Create model)**은 문서를 섹션별로 작성하며, 작성되는 대로 캔버스에 스트리밍하여 사용자가 실시간으로 확인할 수 있도록 합니다.
• **업데이트 모델(Update model)**은 생성 이후 사용자가 요청하는 수정을 처리하며, 나머지 부분을 다시 생성하지 않고 한 번에 한 섹션씩 수정합니다.

각 역할은 그에 가장 적합한 모델에서 실행됩니다. 라우터는 가볍고 빠릅니다. 생성 모델은 요금제와 모드에 따라 선택됩니다. 빠른 레인(fast lane)에서는 GPT-5.6 Luna, 품질(quality) 모드에서는 Gemini 3.8 Flash, 프리미엄(premium) 모드에서는 Claude Sonnet 4.6이 사용됩니다. 자세한 모델 선택 기준은 래더 포스트에서 설명하고 있습니다.

기존에 문제가 발생했던 부분

긴 문서를 작성하는 모델에는 제한 시간(budget)이 있습니다. NextDocs는 생성에 약 11분, 업데이트에 약 6분을 허용합니다. 어떤 모델은 첫 페이지부터 마지막 페이지까지 일정한 속도로 글을 씁니다. 반면 어떤 모델은 처음에는 빠르게 시작했다가 문서가 길어질수록 속도가 느려집니다. 긴 문서를 작성할 때 속도가 느려지는 모델은 제한 시간을 초과하게 되고, 스트리밍이 중단됩니다. 그리고 바로 이 지점에서 버그가 발생했습니다. 반만 완성된 문서가 마치 완전히 끝난 것처럼 저장되었던 것입니다. 오류 메시지도, 경고도 없이 문장 중간에서 뚝 끊긴 보고서만 남았습니다.

저희는 실제 프로덕션 환경에서 발생한 22페이지 분량의 요청을 우리가 사용하는 모든 모델에 다시 실행해 보며 이 문제를 발견했습니다. 패턴을 확인하고 나니 문제는 명확해졌고, 이제는 테스트 시 가장 먼저 확인하는 항목이 되었습니다. 다섯 개의 모델이 이 재현 테스트를 거쳤으며, 그중 두 개는 이 문제로 인해 레인을 배정받지 못했습니다.

v1.11.1에서 변경된 사항

세 가지가 변경되었습니다.

조기에 종료된 스트림은 이제 문서가 아니라 실패로 처리됩니다. 모델이 완료하기 전에 멈추면, NextDocs는 잘려 나간 결과를 저장하지 않고 무슨 일이 일어났는지 알려줍니다. 덕분에 회의 중에 문제를 발견하는 대신 즉시 다시 시도할 수 있습니다.

중단된 실행은 완료된 부분까지 보존합니다. 이는 반대의 경우로, 긴 문서를 생성하는 동안 연결이 끊기거나 탭을 닫더라도 이미 완료된 페이지는 유지되므로 처음부터 다시 시작할 필요 없이 이어서 진행할 수 있습니다. 아무런 예고 없이 잘리는 것은 실패이지만, 의도적인 중단은 실패가 아닙니다.

래더에 있는 모든 모델은 긴 문서 검증 관문을 통과했습니다. 아무리 최신 모델이거나 벤치마크 점수가 좋더라도, 제한 시간 내에 22페이지 재현 테스트를 완료하지 못하면 레인을 배정받지 못합니다. Gemini 3.8 Flash는 출시 하루 만에 이 테스트를 통과하여 9월 3일에 승격되었습니다. 반면 Claude Sonnet 5는 16페이지에서 멈춰 승격되지 못했습니다.

매우 긴 문서에서 최상의 결과를 얻는 방법

• 품질(Quality) 또는 프리미엄(Premium) 모드를 사용하세요. 빠른 레인은 신속하고 안정적이지만, 일관성을 유지해야 하는 섹션이 포함된 60페이지 분량의 문서의 경우 품질 레인의 모델이 구조를 더 잘 유지합니다. 프리미엄 모드는 가장 철저하고 긴 문서를 작성하므로 충분한 시간을 제공하는 것이 좋습니다.
• 명확한 구조를 제공하세요. "요약, 결과, 권장 사항 표가 포함된 12개의 섹션"과 같이 명확하게 지정하는 것이 "긴 보고서 작성해줘"라고 요청하는 것보다 훨씬 더 고른 품질의 문서를 만들어냅니다. 형태를 운에 맡기면 긴 문서는 방향을 잃기 쉽습니다.
• 개요를 먼저 생성한 다음 문서를 생성하세요. 40페이지가 넘는 문서의 경우, 개요를 별도의 짧은 문서로 먼저 요청하여 수정한 다음, 이를 실제 프롬프트에 붙여넣으세요. 이는 가장 비용이 적게 드는 효율적인 수정 방법입니다.
• 참고자료를 첨부하세요. 프롬프트에 PDF, Word 파일, 스프레드시트를 첨부하면 긴 문서가 허구로 흐르지 않고 사실에 기반하도록 고정할 수 있습니다.
• 문서 전체가 아닌 섹션별로 편집하세요. 생성된 후에는 특정 섹션의 이름을 지정하여 수정을 요청하세요. 업데이트 모델은 해당 섹션만 수정하므로 속도가 빠르고 나머지 부분은 그대로 유지됩니다.

이것이 의미하는 바

이제 NextDocs에서 생성된 긴 문서는 두 가지 방식 중 하나로 끝납니다. 완전히 완료되거나, 완료되지 않은 이유와 함께 명확한 메시지가 표시되거나 둘 중 하나입니다. 제3의 상태는 존재하지 않습니다. 사소한 변화처럼 보일 수 있지만, 14페이지에서 뚝 끊겨버린 보고서로 발표를 해본 경험이 있는 분이라면 이것이 결코 사소한 일이 아님을 아실 것입니다.

NextDocs에서 긴 문서 생성하기

---

NextDocs 팀