İçeriğe atla
SinaptikLabAI KNOWLEDGE PLATFORM
RehberOrtaÇok Modlu Üretim

Çok modlu belge hattı kurmak

Çok modlu belge hattı, sayfayı görsel ve metin olarak okuyan bir modelin çevresine üç zorunlu katman eklenerek kurulur: çıkarılacak alanların önceden yazıldığı bir şema, modelin kendi iddiasına değil bağımsız kanıta dayanan alan bazlı bir güven ölçütü ve eşiğin altında kalan sayfaları insana devreden bir kuyruk. Sayfada okunabilir metin katmanı varsa onu birincil kaynak yapın ve görseli çapraz denetimde kullanın; taranmış ve elle doldurulmuş sayfalarda görsel okuma asıl yol olur. Ölçümü alan bazında yapın: sayfa düzeyindeki tek bir doğruluk oranı, hangi alanın bozulduğunu gizler.

ÖNKOŞULLAR

  • Çıkarılacak alanların iş karşılığını bilen bir süreç sahibi
  • Her belge sınıfından örnek içeren, elle doğrulanmış en az 50 sayfalık bir altın küme
  • Görsel girdi kabul eden bir model uç noktasına erişim
  • Belgelerin saklanması ve işlenmesi için kişisel veri uygunluğu onayı

GEREKEN ARAÇLAR

  • Görsel girdi kabul eden çok modlu bir model
  • Sayfa dönüştürme ve görüntü ön işleme kütüphanesi
  • Metin katmanı çıkarıcı ve bir OCR motoru
  • Yapılandırılmış çıktı için şema doğrulayıcı
  • İnceleme kuyruğu ve düzeltme arayüzü
  • Alan bazlı metrik panosu ve iz kaydı
  1. 01

    Alan sözleşmesini belgeden önce yaz

    Çıkarılacak her alan için ad, veri tipi, zorunluluk ve kabul edilebilir biçimi tek bir şemada tanımlayın; hat bu şemaya göre kurulur, modelin döndürdüğüne bakılarak değil.

    Belge hatlarının çoğu, çıktıya bakarak büyüdüğü için dağılıyor: model bir şey döndürüyor, ekip onu ayrıştırmaya çalışıyor, her yeni belge yeni bir istisna ekliyor. Doğru sıra tersi — önce alan sözleşmesi, sonra hat.

    json
    {
      "belge_sinifi": "fatura",
      "alanlar": {
        "belge_no":   { "tip": "metin",   "zorunlu": true,  "bicim": "^[A-Z0-9-]+$" },
        "tarih":      { "tip": "tarih",   "zorunlu": true,  "bicim": "YYYY-AA-GG" },
        "toplam":     { "tip": "ondalik", "zorunlu": true,  "birim_alani": "para_birimi" },
        "para_birimi":{ "tip": "metin",   "zorunlu": true,  "kume": ["TRY", "USD", "EUR"] },
        "kalemler":   { "tip": "liste",   "zorunlu": false }
      },
      "kanit_zorunlu": ["belge_no", "toplam"]
    }

    Sondaki kanıt listesi sonraki adımların dayanağı: bu alanlarda modelden yalnızca değer değil, değerin sayfadaki konumu da istenir. Sözleşmeyi şema doğrulayıcısına bağlayın — biçime uymayan bir çıktı hatta ilerlememeli, düzeltilmeye çalışılmamalı.

  2. 02

    Belge sınıflarını ayır ve altın kümeyi topla

    Fatura, form, sözleşme ve tarama gibi sınıfları ayrı ayrı örnekleyin; her sınıfın düzeni farklı bozuluyor ve tek bir hat hepsini aynı kalitede okumuyor.

    Sınıfları ayırmak yalnızca doğruluk için değil, hata ayıklama için gerekli: bozulma tek bir sınıfa özgüyse onu ancak ayrılmış ölçümde görürsünüz. Birleştirilmiş bir ortalama, bir sınıfın tamamen çöktüğü haftalarda bile makul görünebiliyor.

    Belge sınıfıZorlayan özellikHatta etkisi
    Basılı faturaYoğun tablo, ince çizgiSütun eşleştirme hatası
    Taranmış formElle doldurulmuş alanKarakter karışması, boş alan yanılgısı
    Çok sayfalı sözleşmeMaddenin sayfaya yayılmasıBağlam kopması
    Çok sütunlu raporOkuma sırasının belirsizliğiCümlelerin karışması
    Ekran görüntüsüArayüz gürültüsü, düşük çözünürlükAlakasız metnin çıkarıma karışması

    Doğrulama adımı: her sınıftan en az on sayfayı elle doğrulanmış altın kümeye koyun ve bu kümeyi sürüm kontrolüne alın. Sonraki tüm kararların ölçüsü bu küme olacak; küçük tutun ama gerçek tutun — temizlenmiş, seçilmiş örneklerden oluşan bir küme hattı kandırır.

  3. 03

    Sayfa alımını ve ön işlemeyi sabitle

    Sayfaları tek tek görüntüye çevirin, yönü düzeltin ve çözünürlüğü sınıf bazında sabitleyin; küçük punto ve ince tablo çizgileri düşük çözünürlükte sessizce kayboluyor.

    Ön işleme sıkıcıdır ve en çok kazandıran adımdır. Yönü düzeltilmemiş bir sayfa iyi bir modelin bile okuma sırasını bozuyor; düşük çözünürlükte ise model boş alan görmez, olmayan bir değer üretir. İkinci hata birincisinden çok daha pahalı çünkü sessiz.

    1. 01Sayfaları tek tek işleyin; çok sayfalı bir dosyayı tek bir uzun görsele birleştirmeyin.
    2. 02Yönü ve eğikliği düzeltin; taramalarda en sık görülen bozulma budur.
    3. 03Çözünürlüğü sınıf bazında sabitleyip yapılandırmaya yazın. Tarama tarafında 300 DPI yaygın bir başlangıç noktasıdır; kararı altın kümenizdeki en küçük puntonun okunabildiği en düşük ayara bakarak verin.
    4. 04Sayfa numarasını ve dosya kimliğini her çıkarıma iliştirin; kaynağa dönemeyen bir değer denetlenemez.
  4. 04

    Metin katmanı ile görsel okuma arasında yönlendirme kur

    Sayfada gömülü ve okunabilir bir metin katmanı varsa onu birincil kaynak yapıp görseli çapraz denetimde kullanın; metin katmanı yoksa OCR ile görsel okumayı birlikte koşturun.

    Dijital üretilmiş bir belgenin metin katmanı, görsel okumadan daha ucuz ve karakter düzeyinde daha güvenilir. Görsel okumanın kazandığı yer düzen: hangi hücre hangi başlığa ait, hangi kutu işaretli, imza alanı boş mu. Doğru kurulum ikisini yarıştırmaz, rol paylaştırır.

    1. 1Metin katmanını dene

      Gömülü metin varsa ve okunabilirlik eşiğini geçiyorsa birincil kaynak odur; karakter düzeyindeki değerler oradan alınır.

    2. 2Görselle çapraz denetle

      Kanıt zorunlu alanlar için model aynı değeri sayfa görselinden okur; iki okuma uyuşmuyorsa alan düşük güvenli işaretlenir.

    3. 3Metin yoksa iki okumayı birlikte koştur

      Taranmış sayfada OCR'ı karakter düzeyindeki değerler, görsel okumayı düzen ve elle doldurulmuş alanlar için kullanın; ikisini tek bir birincil kaynağa indirgemeyin, uyuşmazlık alanı düşük güvenli işaretlesin.

    4. 4Kararı iz kaydına yaz

      Hangi yolun seçildiği her sayfa için kaydedilir; sonraki hata ayıklamanın ilk sorusu budur.

    Okunabilirlik eşiğini kendiniz ölçün. Taranmış sayfalarda metin katmanı genellikle ya hiç yoktur ya da kırık çıkar; bu iki durumu ayırt etmek için sayfadaki karakter sayısı ve sözlükte karşılığı bulunan kelime oranı gibi basit bir sezgisel çoğu zaman yetiyor.

  5. 05

    Düzeni çıktının parçası yap

    Modelden yalnızca değerleri değil, değerin geldiği sayfa, tablo, satır ve okunan ham metni de isteyin; konum bilgisi sonraki bütün doğrulamaların tek dayanağıdır.

    Bir değerin doğru olup olmadığını denetleyebilmek için nereden geldiğini bilmek gerekir. Modelden yalnızca “toplam” istemek, denetlenemeyen bir cevap istemektir. Aynı istekte sayfa numarası, tablo adı, satır etiketi ve okunan ham metin de istendiğinde çıkarım denetlenebilir hâle gelir.

    json
    {
      "toplam": {
        "deger": "12450.00",
        "para_birimi": "TRY",
        "kanit": {
          "sayfa": 2,
          "tablo": "kalemler",
          "satir_etiketi": "Genel toplam",
          "okunan_metin": "Genel toplam 12.450,00 TL"
        }
      }
    }

    Yukarıdaki değerler temsilî; önemli olan yapı. Ham metin alanı özellikle değerli, çünkü biçim farkını — ondalık ayracı, binlik ayracı, para birimi eki — sonradan denetlemenizi sağlıyor ve yanlış normalleştirmeyi yakalıyor.

  6. 06

    Güveni modelin iddiasından değil kanıttan üret

    Her alan için biçim denetimi, aritmetik tutarlılık ve ikinci okumayla uyuşma gibi bağımsız sinyalleri birleştirin; modelin kendi verdiği güven ifadesi kalibre değildir.

    Bir dil modeline “bu değerden ne kadar eminsin” diye sorup yüzde almak kalibre bir olasılık üretmez; üretilen şey bir metindir ve eşik kurmaya elverişli değildir. Güven, alanın kendisinden ve birbirinden bağımsız kontrollerden üretilmelidir.

    SinyalNasıl üretilirNeyi yakalar
    Biçim denetimiAlanın düzenli ifadesi ve veri tipiKarakter karışması, eksik hane
    Aritmetik tutarlılıkKalem toplamı ile genel toplamın karşılaştırılmasıYanlış hücreden okuma
    Çapraz okuma uyumuMetin katmanı ile görsel okumanın karşılaştırılmasıDüzen kaynaklı hata
    Konum tutarlılığıKanıtın beklenen bölgede bulunmasıYanlış tablodan alma
    Sözlük denetimiKurum, ülke, para birimi listeleriyle eşleşmeUydurulmuş ad
    Sinyalleri önce ikili tutup sayarak başlayın; ağırlıklandırma ancak elinizde veri olduğunda anlamlı.

    Doğrulama adımı: altın kümede güven skorunu gerçek doğrulukla karşılaştırın. Yüksek güvenli çıkarımların içindeki hata oranı belirgin biçimde düşük değilse skorunuz iş görmüyor demektir; eşik koymadan önce bunu düzeltin, yoksa eşik yalnızca bir kuyruk uzunluğu ayarına dönüşür.

  7. 07

    İnsana devir eşiğini ve kuyruğunu kur

    Eşiği sayfa başına değil alan başına belirleyin, düşük güvenli çıkarımları inceleme kuyruğuna yollayın ve incelemecinin düzeltmesini altın kümeye geri yazın.

    Eşik teknik değil ekonomik bir karardır: bir hatanın maliyetiyle bir incelemenin maliyetini karşılaştırırsınız. Tutar ve kimlik alanlarında hata pahalı olduğu için eşik yüksek tutulur; serbest açıklama alanında hata ucuzdur, eşik düşürülebilir. Bu yüzden eşik alan başına konur.

    • Kuyruğa düşen sayfada incelemeciye yalnızca şüpheli alanı ve kanıt bölgesini gösterin; tüm belgeyi yeniden okutmak zaman kaybıdır.
    • İncelemecinin düzeltmesini altın kümeye ve eşik ayarına geri yazın; hat ancak böyle öğrenir.
    • Kuyruk uzunluğunu bir kapasite sinyali olarak izleyin; sürekli büyüyorsa sorun eşikte değil hattadır.
    • Tam otomatik geçen sayfalardan rastgele küçük bir örneklemi yine de insana gösterin; sessiz bozulmayı yalnızca bu yakalar.

    Devir kuyruğunu “sonra bakarız” klasörüne dönüştürmeyin. İncelenmemiş kuyruk ölçülmemiş hata demektir ve hattın gerçek doğruluğunu bilinmez hâle getirir: panodaki oran yükselirken kuyrukta biriken hata görünmez.

  8. 08

    Alan bazında ölç ve sürüklenmeyi izle

    Doğruluğu sayfa düzeyinde değil alan düzeyinde raporlayın ve yeni bir şablon ya da gönderen göründüğünde ölçümü yeniden koşturun; şablon değişimi en sık sessiz bozulma nedenidir.

    Sayfa düzeyindeki tek bir doğruluk oranı, kritik alanın bozulmasını önemsiz alanların ortalamasıyla gizler. Ölçüm alan bazında yapılır ve alanlar iş etkisine göre ağırlıklandırılır: tutar alanındaki bir hata ile açıklama alanındaki bir hata aynı tabloda eşit ağırlıkta duramaz.

    MetrikTanımNeden ayrı izlenir
    Alan doğruluğuDoğru çıkarılan alanların oranıKritik alan ortalamanın arkasına saklanmaz
    Boş dönüş oranıZorunlu alanın hiç bulunamamasıŞablon değişiminin ilk işareti
    Devir oranıİnsana giden sayfa payıKapasite ve eşik ayarı
    Devir sonrası düzeltme oranıİncelemecinin değiştirdiği alan payıEşiğin doğru yerde olup olmadığı

    Şablon değişimi en sık görülen sessiz bozulma nedeni: gönderen kurum düzeni değiştirir, hat aynı kalır, boş dönüş oranı yükselir. Uyarıyı alan doğruluğuna değil boş dönüş ve devir oranına kurun — alan doğruluğu haftalar sonra fark edilir, bu iki metrik ertesi gün.

SIK DÜŞÜLEN TUZAKLAR

  • Modelin söylediği güven oranını eşik olarak kullanmak

    Dil modelinin ürettiği yüzde bir olasılık değil bir metindir; kalibre değildir ve yanlış okumalarda da yüksek çıkabilir. Bu sayıya kurulan eşik, hataları kuyruğa değil doğrudan üretime yollar.

  • Tablo başlığını değerden koparmak

    Sütun başlığı olmadan okunan bir hücrede model sayının hangi kolona ait olduğunu bilemez ve kendinden emin biçimde yanlış eşleştirir. Çok sütunlu tablolarda bu hata en sık komşu kolona kayma olarak görünür.

  • Tek bir sayfa düzeyi doğruluk oranı raporlamak

    Tutar, tarih ve kimlik gibi kritik alanlar bozulurken çok sayıdaki önemsiz alan ortalamayı ayakta tutabiliyor. Pano iyi görünür, muhasebe farkı büyür.

  • İnsan düzeltmelerini kuyruğun içinde bırakmak

    İncelemecinin düzeltmesi altın kümeye ve eşik ayarına geri dönmüyorsa hat öğrenmez; yalnızca insan yükü artar ve aynı hata her hafta yeniden düzeltilir.

  • Belgeden gelen metni yönerge gibi işlemek

    Sayfada yer alan bir cümle modelin talimatıymış gibi okunabiliyor. Belge içeriğini isteme veri olarak etiketleyin, modelin belgeden gelen yönergeleri uygulamayacağını açıkça yazın ve şema dışına çıkan her cevabı reddedin.

KONTROL LİSTESİ

  • Alan sözleşmesi yazılı ve şema doğrulayıcısına bağlı
  • Her belge sınıfı için ayrı örnek kümesi var, altın küme sürüm kontrolünde
  • Sayfa yönü düzeltmesi ve çözünürlük sınıf bazında sabitlendi
  • Metin katmanı ile görsel okuma arasındaki yönlendirme kuralı kodda ve iz kaydında
  • Kanıt zorunlu her alan sayfa, tablo ve satır konumunu taşıyor
  • Güven skoru en az iki bağımsız sinyalden üretiliyor ve altın kümede doğrulandı
  • İnceleme kuyruğu çalışıyor ve düzeltmeler altın kümeye geri yazılıyor
  • Alan bazlı doğruluk panosu ile boş dönüş ve devir oranı uyarıları kurulu

Maddelerin tamamı işaretlenmeden kurulum üretime alınmamalı.

Sık sorulan sorular

Çok modlu model OCR'ın yerini alır mı?

Tam olarak değil. OCR karakter düzeyinde metin çıkarmakta ucuz ve kararlıdır; çok modlu model ise düzeni anlamakta — hangi hücre hangi başlığa ait, kutu işaretli mi, imza alanı boş mu — belirgin biçimde daha iyidir. Üretimde en dayanıklı kurulum ikisini birbirinin denetimi olarak kullanmak: değerler uyuşmadığında alan düşük güvenli işaretlenir ve incelemeye gider.

Taranmış belgelerde hangi çözünürlük yeterli?

Ölçüt bir sayı değil okunabilirlik. Tarama tarafında 300 DPI yaygın bir başlangıç noktasıdır; kendi kararınızı altın kümenizdeki en küçük puntolu satırın büyütmeden okunabildiği en düşük ayara bakarak verin. Daha yükseğe çıkmak her zaman kazandırmaz: uç nokta görseli kendi sınırına göre küçültüyorsa fazladan çözünürlük işlenmeden atılır.

Güven eşiğini nereye koymalıyım?

Eşik alan başına ve iş maliyetine göre konur. Pratik yöntem: altın kümedeki çıkarımları güven skoruna göre sıralayın, kabul edemeyeceğiniz hata oranının başladığı noktayı eşik yapın, sonra bu eşiğin ürettiği devir hacmini inceleme kapasitenizle karşılaştırıp ayarlayın. Kapasiteyi aşan bir eşik kâğıt üzerinde doğru, uygulamada işlemeyen bir eşiktir.

Belgedeki metin modele komut olarak geçebilir mi?

Evet, bu gerçek bir risk. Sayfada yer alan bir cümle modelin yönergesiymiş gibi okunabiliyor ve bu, dışarıdan belge kabul eden her hatta geçerli. Korunma üç katmanlı: belge içeriğini istemde veri olarak etiketleyip sınırlandırın, modele belgeden gelen yönergeleri uygulamayacağını açıkça söyleyin ve çıktının şemaya uymasını zorunlu tutun — şema dışına çıkan her cevap reddedilsin.

Kaynaklar

  1. 01Çok modlu model ve görsel girdi dokümantasyonları — Model sağlayıcıları · Dokümantasyon
  2. 02Belge ayrıştırma ve OCR araç dokümantasyonları — Açık kaynak proje belgeleri · Dokümantasyon
  3. 03Sinaptik Research — belge hattı uygulama notları — Sinaptik Lab · Teknik rapor

BUILD

Bu rehberi kurumunuzda uygulayalım mı?

Aynı mimariyi kendi verinizle kurmak için discovery oturumundan üretime kadar birlikte ilerliyoruz.