n8n içindeki Split Agent ile belgeleri ayırma

Merhaba ve PaperOffice AI Akademisi’ne hoş geldiniz. Bu bölüm, n8n içindeki Split Agent konusundadır: toplu bir tarama yapılır, bireysel belgeler çıkar.

Önce sonuç: Toplu tarama girer, belgeler çıkar

Önce sonuca bakalım. Postane’den gelen toplu taramamız arasında ayırıcı yaprak bulunan yedi sayfadan oluşmaktadır. Split Agent, bir belgenin nerede bittiğini ve diğerinin nerede başladığını algılar. Beş belge geri döner; her biri kendi türü, açıklayıcı adı ve sayfalarıyla birlikte. Bu durum n8n içinde şöyle görünür. Bir test için iş akışını düzenleyicide başlatırım ve toplu taramayı webhook’a gönderirim. Şimdi iş akışı düğüm düğüm çalışır. Bölme görevi PaperOffice’e gider ve döngü tamamlanana kadar sürekli kontrol eder. Kırk saniyenin biraz altında her şey biter. Parçalar düğümü sonucu tutar: beş giriş, her biri bir belge için. İşte bu beş belge: alım emri, teslimat fişi, fatura, bir servis bildirimi ve bir muayene raporu. Servis bildirisi iki sayfadan oluşur ve birlikte kalır. Split Agent, üçüncü sayfadaki ayırıcı yaprağı algıladı ve kaldırdı. Her belgeye de kuralımıza göre açıklayıcı bir ad verilir. Her parça ayrı bir PDF’dir. İşte servis bildirisi: iki sayfa tek dosyada, kuralımıza göre adlandırılmıştır. Sonuç indirme bağlantısını içerir ancak bu bağlantı yalnızca kısa bir süre için geçerlidir. İşte daha zorlu ikinci bir toplu işlem: üç dilde altı sayfa. İngilizce bir alım emri, İspanyolca bir teslimat fişi ve İspanyolca bir fatura, iade fişi, kahve lekesi olan bir nakliye faturası ve eğik çekilmiş bir telefon fotoğrafı ile alınmış bir fatura. Split Agent altı belgenin tamamını ayırır ve onları tutarlı bir şekilde İngilizce adlandırır. Ve bunu dört aşamada oluşturuyoruz: girdi, bölme görevi, bekleme ve parçalar.

Aşama 1/4: Girdi

Birinci aşama girdidir: dosyayı POST yöntemiyle kabul eden başlık kimlik doğrulamasına sahip bir webhook. Dosya eksikse, iş akışı hemen net bir hata yanıtı verir. Peki dosya olmadan ne olur? Ekli olmayan bir istek gönderirim. İş akışı, Dosya eksik düğümünden kısa yolu izler ve hemen 400 durumu ile net bir mesajla yanıt verir. Hiçbir bölme görevi oluşturulmaz, bu nedenle maliyet de oluşmaz.

Aşama 2/4: Bölme görevi

İkinci aşama, tek bir HTTP çağrısı ile toplu işi Split Agent adresine gönderir ve bu çağrı PaperOffice API’sine yapılır. Bu işlem, bölünmüş şablonu, Ultra modelini ve parçaları adlandırmak için bir kuralı (belge türü, tarih, gönderen) içerir. Model alanında kapsamı seçersiniz. Basic sınırları algılar ve parçaları adlandırır. Premium ayrıca belge türünü, tarihi ve göndereni okur. Ultra her bir kesim için gerekçeyi sağlar ve denetim izi sunar. Faturalandırma sayfa başına yapılır. Fiyatı belirleyen iki unsur vardır: kapsam ve işleme hattı. Biz anlık seçeneği tercih ettik, yani hemen başlatma anlamına gelir. Başlangıç garantisi olmadan ve SLA (Hizmet Seviyesi Anlaşması) bulunmaması durumunda maliyet daha düşüktür. Güncel fiyatları web sitemizdeki Fiyatlandırma bölümünde bulabilirsiniz.

4’ten 3. Aşama: Bekleniyor

İş arka planda çalışır. Her altı saniyede bir döngü durumunu kontrol eder. İş tamamlandığında, çalışma devam eder. Başarısız olursa, çalışma bir mesajla sona erer.

4’ten 4. Aşama: Parçalar

Dördüncü aşamada yanıt, belge başına bir girdi içeren bir liste haline gelir. Ayırıcı sayfa kendi başına bir öğe olarak geri gelirse, bu düğüm onu filtreler. Son olarak, webhook tam olarak bu listeyi döndürür. Listenin ardından ne olur? Gelen kutusu ana videosunda döngü burada devreye girer: her belge kendi başına IDP Agent adresine gider, okunur ve Workspace’e kaydedilir. Bu şekilde, bölme tüm bir iş akışının başlangıcı haline gelir.

Kendiniz oluşturun: Kimlik bilgileri ve dışarıdan çağırma

Bu işlemi kendiniz gerçekleştirmek için iki kimlik bilgisi gereklidir; her ikisi de n8n içinde başlık (header) olarak doğrulama amacıyla kullanılır. Webhook için anahtarı, özel bir başlık adı belirleyerek siz seçersiniz. PaperOffice için ise Hesaplar > API ve Geliştiriciler bölümündeki API anahtarınızı kullanırsınız; bu anahtar Authorization başlığına yerleştirilir. Dışarıdan, webhook URL’sine POST isteği göndererek iş akışını tetiklersiniz: dosya alanına dosyanızı, başlık kısmına da anahtarınızı eklersiniz. Bu istek bir betik, başka bir program veya ikinci bir iş akışı olabilir. Gelen yanıt, bir sonraki adım için hazır olan belge listesidir. Pratikten üç öneri: Birincisi; ayırıcı sayfalarınıza gerek yoktur; Split Agent sınırları içerikten algılar. İkincisi; adlandırma kuralını adlandırma talimatı alanına, örneğin tarih, gönderen, belge türü gibi parametrelerle belirlersiniz. Üçüncüsü; dosyaları hemen indirin veya arşivleyin, çünkü bağlantılar kısa süre sonra süresi dolmaktadır. Bu n8n içinde bir webhook, bir çağrı, bir döngü ve bir liste anlamına gelmektedir: Split Agent. PaperOffice içinde bu işlemi yükleme sırasında doğrudan da kullanabilirsiniz. Gelen kutusu ana videosu, bireysel belgelerin oradan nasıl devam ettiğini göstermektedir. Bir sonraki videoda PaperOffice AI Akademisi’nde görüşmek üzere.