Bir yığın taranmış faturanın bulunduğu bir gelen kutusunu hayal edin; her sayfa satın alma siparişini adlandıran bir barkod taşır. Bir AI ajanı, klasördeki tüm kodları yerel olarak, yükleme yapmadan okuyabilir ve her dosyayı kaydıyla eşleştiren bir tablo verir. Ajan Claude, Cursor veya GitHub Copilot; okuma ise GroupDocs.Signature.Mcp sunucusu tarafından yapılır. Tek bir istem bunu kapsar:

Klasördeki her PDF için barkodu oku ve bana dosya adı, barkod değeri, sayfa içeren bir tablo ver.

Yapılandırma ve sorun giderme ile adım adım sürüm belgelerde bulunur: AI ile belgelerden QR kodu ve barkod verilerini nasıl çıkarılır.

Senaryo: bir yığın dosyadan yönlendirilmiş kuyruğa

Bir posta odası, bir alacak hesapları ekibi veya bir vaka yönetim masası belgeleri toplu olarak alır. Her biri, tam da bu an için yerleştirilmiş bir makine tarafından okunabilir kod taşır. Otomasyon olmadan biri değeri bir sonraki sisteme yazar. Bir ajanla süreç şu şekildedir:

  1. Belgeler, sunucunun kullanacak şekilde yapılandırıldığı klasöre düşer (GROUPDOCS_MCP_STORAGE_PATH).
  2. Ajan, her dosyada search_barcodes çağırır ve çözülen değerleri, sayfaları ve konumları toplar.
  3. Ajan tabloyu döndürür. Bu tablo, dosyalar ile ERP, depo veya vaka sisteminizdeki kayıtlar arasındaki birleştirme anahtarıdır.
  4. Bir kişi ya da kontrol ettiğiniz sonraki otomatik adım, aramayı ve yönlendirmeyi yapar.

Adım 4, kasıtlı olarak ajan dışındadır. Aşağıdaki “Otomatize edilmemesi gerekenler” bölümüne bakın.

Hangi araç hangi kodu okur?

search_qr_codes QR kodlarını okur. search_barcodes Code39, Code128 ve EAN gibi tek boyutlu barkodları okur. Her biri çözülen metni, sayfayı ve her eşleşmenin konumunu döndürür. Bir belgenin hangi tür kod içerdiğinden emin değilseniz, ikisini de isteyin:

invoice.pdf içindeki QR kodlarını ve barkodları oku ve bana ne içerdiğini söyle.

Çok sayıda kod arasında bir kodu nasıl bulursunuz?

Her iki araç da belirli bir dize içeren kodları döndüren bir text filtresi kabul eder:

SHIP ile başlayan barkodu bul ve hangi sayfada olduğunu söyle.

On bir düzine kod içeren bir belgede, bu bir cevap ile bir değer duvarı arasındaki farktır.

Yanıtları küçük tutun

Her iki araç da returnImage kabul eder. Gerçekten grafiğe ihtiyacınız yoksa kapalı bırakın. Çözülen metin, bir ajanın üzerinde düşündüğü şeydir ve base64 görüntüler yanıtları büyük ve yavaş yapar.

Örnek oturum (kısaltılmış)

You:    For every PDF in the folder, read the barcode, and give me a table
        of file name, barcode value, page.

Agent:  [search_barcodes] file=invoice-0007.pdf   found: 1
        [search_barcodes] file=invoice-0008.pdf   found: 1
        [search_barcodes] file=scan-0009.pdf      found: 0
        | file             | barcode value | page |
        | invoice-0007.pdf | PO-448210     | 1    |
        | invoice-0008.pdf | PO-448377     | 1    |
        scan-0009.pdf has no barcode in the pages that were processed.

Örnek çıktı: dosya adları ve barkod değerleri uydurmadır. Araç yukarıda açıklanan alanları döndürür.

Signature veya Parser: hangi sunucu kodu okur?

GroupDocs.Signature.Mcp’yi, kodun aynı zamanda eklediğiniz bir imza öğesi olduğu durumlarda veya belgeler iki yönlü aktığında kullanın: gelen referansı okuyun, işi yapın, ardından yeni referansı taşıyan bir QR kodu ile çıkan belgeye sign çağrısı yapın. Rastgele taramalardan veri çıkarırken aynı dosyalardan metin, tablo veya meta veriye de ihtiyacınız olduğunda GroupDocs.Parser.Mcp (yalnızca Docker görüntüsü olarak sunulur; extract_barcodes aracı) kullanın. Bu sunucu imzaları ve kodları okur. Düzeni, alanları veya tabloları çıkartmaz.

Otomatikleştirilmemesi gerekenler

  • Bu OCR değildir. Bu araçlar kod sembolojilerini okur, basılı metni değil. Kodu olmayan taranmış bir sayfa hiçbir şey döndürmez ve bu bir başarısızlık değil, doğru bir cevaptır.
  • Çözülen bir değer güvenilmeyen girdidir. Bu, belgeyi hazırlayan kişi tarafından sağlanmıştır. Raporlayın, kontrol edin ve çapraz doğrulayın. Bir ajanın bunu incelenmeden hareket etmesine izin vermeyin.

Değerlendirme limitleri

Lisans olmadan bir belgenin yalnızca ilk 2 sayfası işlenir ve her sayfaya bir deneme rozeti damgalanır. 3. sayfadaki bir kod basitçe bulunmaz ve boş bir sonuç o zaman “kod yok” gibi görünür. Boş bir sonuca güvenmeden önce ajana get_license_status çağırmasını söyleyin.

SSS

Claude bu PDF’deki QR kodunu okuyabilir mi?
Evet. Sunucu bağlandığında, Claude search_qr_codes çağırır ve çözülen metni, sayfayı ve konumu yerel olarak rapor eder.

AI ile bir faturadan barkod değerini nasıl çıkarırım?
Ajanı dosyadaki barkodları okumasını isteyin. search_barcodes çağırır ve çözülen değeri döndürür; belirli bir kod istiyorsanız bir text filtresi ekleyin.

Bir belge klasöründeki tüm QR kodlarını bulabilir miyim?
Evet. Ajanı klasör üzerinde döngü yapıp her QR kodu için dosya, çözülen metin ve sayfayı listelemesini isteyin. Lisans olmadan, her dosyanın yalnızca ilk 2 sayfası incelenir.

Daha derine inin