Paper Office, python-docx, python-pptx ve openpyxl'i Daha Güvenli Agent Belge Düzenlemesi İçin Forkladı

Paper Office nedir

Paper Instruments, yapay zeka agentlarının Word, PowerPoint ve Excel dosyalarını daha güvenli, doğru ve kapsamlı biçimde düzenlemesini sağlamak için tasarlanmış bir Python paketleri pakisi olan Paper Office'i yayınladı: paper-docx, paper-pptx ve paper-xlsx. Şirket sıfırdan başlamak yerine, köklü üç Python Office kütüphanesini — python-docx, python-pptx ve openpyxl — forklayıp yamaladı ve API'lerini yeniden düzenledi. import docx, from pptx import Presentation ve import openpyxl gibi bilinen import yolları çalışmaya devam ediyor; böylece eski kütüphanelere dair mevcut model bilgisi kullanışlı kalıyor.

Standart kütüphaneler agentlar için neden yetersiz kalıyor

Hacker News ana sayfasına çıkan duyuruya göre DOCX, PPTX ve XLSX dosyaları Office Open XML paketleridir: tek bir metin belgesi değil, XML dosyaları, görseller ve diğer bağlı kaynakları barındıran ZIP arşivleri. Bunlardan birini düzenlemek, parçaların ve aralarındaki ilişkilerin tutarlılığını korumak demektir; bu yüzden küçük bir görünür değişiklik bile birden çok yerde güncelleme gerektirebilir.

Paper Instruments'a göre danışmanlar, avukatlar, bankacılar ve operasyon uzmanları arasında agent benimsenmesi doğruluk (fidelity) konusunda takılmış durumda: agentlar mevcut belgeleri insanlar gibi revize etmiyor ve ortaya çıkan sunumlar, tablolar ve belgeler neredeyse doğru görünüyor ama müşteriye sunulmaya uygun değil.

Upstream kütüphaneler yılların birikmiş edge case'lerini barındıran olgun inşa araçları olarak tanımlansa da yıllardır güncellenmiyorlar ve birçok iş akışının ihtiyaç duyduğu özellik genişliği ile doğruluk sözlerini (correctness contract) sunmuyorlar. Bir kütüphane bir işlemi ifade edemediğinde — kullanıcının kastettiği nesneyi, metni öğelere bölünmüş ya da şablondan devralınmış olduğunda bulmayı; bir değişikliği biçimlendirme ve ilişkileri bozmadan uygulamayı; istenen kapsam dışındaki her şeyi korumayı ya da düzenlemenin kaydetmeden sonra da var olduğunu doğrulamayı — model wrapper betiklerine ve ham OOXML'e geri çekiliyor. Bu, bağlamını paket mekanikleriyle dolduruyor ve sıkça yorum çapaları, grafik çalışma kitapları, alanlar, özel XML ve formül bağımlılıklarında sessiz gerilemelere yol açıyor.

Forklar ne ekliyor

Pakis genelinde paylaşılan yaklaşım şöyle: gizli yapıyı tipli, makine tarafından okunabilir veri olarak ortaya çıkarmak, desteklenen düzenlemelerden önce hedefleri doğrulamak, paketi koruyan kaydetme yolları sunmak, sınırlı değişiklikleri raporlamak ve bir işlem güvenle gerçekleştirilemiyorsa bunu açıkça reddetmek.

paper-docx, python-docx'i şunlarla genişletiyor: Word'ün run parçalanması boyunca metni eşleştiren ve değiştirme, izlenen düzenlemeler veya yorum çapası için canlı aralıklar döndüren belge geneli arama; numaralandırmayı yeniden başlatma; doğrulanmış kabul ve ret sonuçlarıyla izlenen değişiklikler olarak üretilen yerel Word redline'ları; atomik revizyon çözümü ve yorum zinciri yönetimi; content control'ler; yer imleri ve alanlar; stilleri, numaralandırmayı, medyayı, köprüleri ve yer imlerini uzlaştıran belgeler arası birleştirme; anlamsal olarak değişmemiş parçalar için özgün baytları geri getiren paket diff'leri ve yama kayıtları; ve bir belgenin kısıtlama moduna saygı gösteren koruma denetimleri. Bir docx.story API'si gövde metnini, üstbilgileri, altbilgileri, dipnotları, sonnotları, yorumları, izlenen eklemeleri, content control'leri ve metin kutularını dolaşıyor ve okuyamadığı bölgelerin sayısını raporluyor.

paper-pptx, python-pptx'i şunlarla genişletiyor: yazı tiplerini, paragrafları ve şekilleri placeholder, layout, master ve tema zinciri üzerinden çözen biçimlendirme denetimi; etkilenmeyen run'ları koruyan ve bayat çapaları reddeden metin değiştirme; ilişki güvenli slayt klonlama, silme, yeniden sıralama ve taşıma — klonlanan grafikler bağımsız gömülü çalışma kitapları alıyor; belirsiz adları işaretleyen şekil düzenleme; birleştirilmiş hücrelerden haberdar tablo satır ve sütun işlemleri; yerel madde işaretleri ve konuşmacı notları yönetimi; ve konum ile kırpmayı koruyarak görsel ve grafik güncellemeleri. paper-xlsx, pakisi aynı fork temeli üzerinde Excel dosyaları için tamamlıyor.

Kıyaslama sonuçları

Beş model ve 61 görev genelinde Paper paketleri ve rehber birlikte denemelerin yüzde 92,5'ini geçti; buna karşılık yeteneksiz upstream paketler yüzde 80,7, Anthropic'in benzer Office yetenekleriyle birlikte yüzde 69,5 oldu. Agentların Office dosyası iç yapısını doğrudan düzenlemek için kod yazdığı deneme oranı Paper ile yüzde 1,6'ya düştü; yetenek olmadan yüzde 78,7, Anthropic yetenekleriyle yüzde 50,5 idi. Paper Instruments için çıkarım şu: yalnızca prompt'lar, yetenekler ve araçlar değil, temel yazılım da agent performansını iyileştirmenin önemli bir kaldıracı olmaya devam ediyor.

Neden önemli

Kurumsal bilgi işinin büyük bölümü halihazırda var olan Word, PowerPoint ve Excel dosyalarında yaşıyor: yeniden üretilmesi değil revize edilmesi gereken sözleşmeler, sunumlar ve modeller. Agentlar bu dosyaları izlenen değişiklikleri, yorum zincirlerini, grafik verilerini veya biçimlendirme kalıtımını bozmadan düzenleyemezse profesyonel iş akışlarının kenarında kalırlar. Paper Office'in sonuçları, kütüphane katmanını yükseltmenin — yalnızca prompt ya da yetenek eklemek yerine — hem hata oranlarını hem de sessiz bozulmanın arkasındaki ham OOXML'e geri çekilme davranışını aynı anda düşürebileceğini gösteriyor. Belge agentları geliştiren ekipler için paketler, eski kütüphaneleri agent-güvenli hale getirmenin yeniden kullanılabilir bir örüntüsünü de modelliyor: açık retler, doğrulanmış değişiklikler ve aracın anlamadığı parçaların korunması. Ve Anthropic'in kendi Office yetenekleriyle yapılan birebir karşılaştırma, belge düzenlemenin agent araçlarında aktif bir cephe hâline geldiğine işaret ediyor.