Gerçekten tamamlanan yüz sayfalık belgeler

Bu yılın başlarında, yüzlerce sayfalık belge ve sunum oluşturma hakkında yazmıştık. 100 sayfalık bir rapor talep edebilmek bir şeydir; ancak her seferinde 87. sayfanın da 3. sayfa kadar iyi olduğu 100 sayfanın tamamını elde etmek çok daha zor bir sorun oldu. Bu durum, bu yıl aldığımız en sinir bozucu hata raporlarına yol açtı: tamamlanmış gibi görünen ancak 14. sayfada duran belgeler.

Bu yazıda, uzun belge oluşturma sürecinin nasıl çalıştığını, v1.11.1 sürümünde neleri değiştirdiğimizi ve çok uzun bir belgeye ihtiyaç duyduğunuzda en iyi sonucu nasıl alacağınızı açıklıyoruz.

Uzun bir belge nasıl oluşturulur?

NextDocs, tek bir modelden tek nefeste 100 sayfa yazmasını istemez. İşi üç rol paylaşır:

• Bir yönlendirici (router) talebinizi okur ve bunun ne tür bir belge olduğuna, uzunluğuna, yapısına ve hangi kulvarın kullanılacağına karar verir.
• Bir oluşturma modeli (create model) belgeyi bölüm bölüm yazar ve yazıldıkça tuvale aktarır (stream), böylece belgenin oluşumunu canlı olarak izleyebilirsiniz.
• Bir güncelleme modeli (update model) sonrasında talep ettiğiniz düzenlemeleri, belgenin geri kalanını yeniden oluşturmadan, her seferinde tek bir bölüm olacak şekilde yönetir.

Her rol, kendisine en uygun model üzerinde çalışır. Yönlendirici küçük ve hızlıdır. Oluşturma modeli ise planınıza ve modunuza göre seçilir: Hızlı kulvarda GPT-5.6 Luna, kalitede Gemini 3.8 Flash, premiumda ise Claude Sonnet 4.6. Seçenekleri aşama yazımız açıklamaktadır.

Eskiden nerede hata yapılıyordu?

Uzun bir belge yazan modelin belirli bir bütçesi (süre sınırı) vardır: NextDocs, bir oluşturma işlemi için yaklaşık on bir dakika, güncelleme için ise altı dakika süre tanır. Bazı modeller ilk sayfadan son sayfaya kadar sabit bir hızda yazar. Diğerleri ise hızlı başlar ve belge büyüdükçe yavaşlar. Uzun bir belgede, yavaş olan modellerin bütçesi tükenir, akış sona erer ve (işte hata buradaydı) yarıda kalmış belge sanki tamamlanmış gibi kaydedilirdi. Hata yok, uyarı yok; sadece cümlenin ortasında biten bir rapor.

Bu hatayı, canlı ortamdan alınan gerçek bir 22 sayfalık talebi kullandığımız her model üzerinde yeniden çalıştırarak tespit ettik. Modeli bir kez gördükten sonra bu örüntüyü gözden kaçırmak imkansızdı ve artık ilk test ettiğimiz şey bu oldu. Beş model bu testi gerçekleştirdi; bunlardan ikisi bu hata nedeniyle bir kulvar alamadı.

v1.11.1 sürümünde neler değişti?

Üç şey.

Erken biten bir akış artık bir belge değil, başarısızlık olarak kabul ediliyor. Bir model işini bitirmeden durursa, NextDocs kesintiye uğramış sonucu kaydetmeyi reddeder ve size ne olduğunu bildirir; böylece sorunu bir toplantı sırasında keşfetmek yerine işlemi yeniden deneyebilirsiniz.

Yarıda kesilen bir işlem, tamamlanan kısımları korur. Madalyonun diğer yüzü ise şudur: Uzun bir oluşturma işlemi sırasında bağlantınız koparsa veya sekmeyi kapatırsanız, tamamlanan sayfalar korunur ve baştan başlamak yerine kaldığınız yerden devam edebilirsiniz. Sessizce yarıda kesilme bir başarısızlıktır; bilinçli bir durdurma ise değildir.

Aşamalardaki her model, uzun belge eşiğini geçti. Ne kadar yeni olursa olsun veya performans testleri ne kadar iyi görünürse görünsün, hiçbir model bütçe dahilinde 22 sayfalık testi tamamlamadan bir kulvar elde edemez. Gemini 3.8 Flash, piyasaya sürülmesinden sonraki bir gün içinde bu testi geçti ve 3 Eylül'de yükseltildi. Claude Sonnet 5 ise 16. sayfada durdu ve geçemedi.

Çok uzun bir belgede en iyi sonucu alma

• Use Quality or Premium mode. Hızlı kulvar seri ve güvenilirdir, ancak tutarlı kalması gereken bölümlere sahip 60 sayfalık bir belge için kalite kulvarındaki model yapıyı daha iyi korur. Premium ise tüm modeller arasında en kapsamlı ve en uzun belgeleri yazar, bu yüzden ona zaman tanıyın.
• Yapıyı önceden belirleyin. "Her biri bir özet, bulgular ve bir öneriler tablosu içeren on iki bölüm" ifadesi, "uzun bir rapor" ifadesine kıyasla çok daha dengeli bir belge üretir. Şekil şansa bırakıldığında uzun belgeler hedefinden sapar.
• Önce taslağı, ardından belgeyi oluşturun. 40 sayfanın üzerindeki her şey için, önce taslağı kendi başına kısa bir belge olarak isteyin, düzenleyin ve ardından asıl komut istemine (prompt) yapıştırın. Bu, yapacağınız en zahmetsiz ve en ucuz düzenleme olacaktır.
• Kaynakları ekleyin. Komut istemine eklenen PDF'ler, Word dosyaları ve e-tablolar, uzun bir belgenin konudan sapmasını önleyerek gerçeklere bağlı kalmasını sağlar.
• Belgeyi değil, bölümleri düzenleyin. Oluşturma işleminden sonra, bir bölümde yapmak istediğiniz değişiklikleri adıyla belirtin. Güncelleme modeli yalnızca o bölüme müdahale eder; bu hem hızlıdır hem de belgenin geri kalanını olduğu gibi korur.

Bu ne anlama geliyor?

NextDocs'tan çıkan uzun bir belge artık iki şekilde sonuçlanır: ya tamamen biter ya da neden bitmediğine dair net bir mesaj verir. Üçüncü bir durum yoktur. Bu kulağa küçük bir şey gibi gelebilir. Ancak daha önce 14. sayfada yarıda kalmış bir raporla sunum yapmak zorunda kaldıysanız, bunun hiç de küçük bir şey olmadığını bilirsiniz.

NextDocs'ta uzun bir belge oluşturun

---

NextDocs Ekibi