Diyelim ki bir sözleşme klasörünüz var ve inceleme için her birinin ilk sayfasına ya da imza sayfasına ihtiyacınız var. GroupDocs.Merger.Mcp sunucusuna sahip bir AI ajanı, bunu tek bir komutla, makinenizde yerel olarak, Claude Desktop, Claude Code, Cursor veya GitHub Copilot ile VS Code’dan yapar:

Belgeler klasörümdeki her PDF’den sayfa 1’i çıkar ve ürettiğin şeyi listele.

Adım adım sürüm, yapılandırma ve sorun giderme ile birlikte belgelerde bulunabilir: Birçok belgeden sayfaları toplu olarak nasıl çıkarılır.

Ajans bir klasördeki dosyalarla ne yapar?

Her dosya için ajan split aracını bir kez çağırır. Her çağrı tek sayfalık bir belge yazar. 40 faturadan oluşan bir klasör bu nedenle 40 kapak sayfası üretir. Araçta klasör modu yoktur; ajan döngüyü sağlar ve motor her dosya için sayfa çıkarımını yapar. Dosyalar, GROUPDOCS_MCP_STORAGE_PATH içinde yapılandırılan klasör içinde isimle çözülür, bu yüzden ajan invoice-014.pdf gönderir, makinenizden bir yol göndermez.

Çıkarılan sayfaları orijinal klasörün dışına nasıl tutarsınız?

Kırk çıkarılan sayfa, kırk orijinaliyle yan yana bir klasör, kimsenin gezinebileceği bir yer olur. GROUPDOCS_MCP_OUTPUT_PATH değişkenini ayrı bir dizine ayarlayın; sonuçlar kaynaklardan ayrı bir yere konur. Bu ayar yapılmazsa çıktı depolama klasörüne gider. Bu tek seferlik bir ayardır ve sonrasında yapılan her toplu komut düzenli kalır.

Son sayfayı ya da hareket eden bir sayfayı nasıl çıkarırsınız?

“Son sayfa” her dosyada farklı bir numaradır. Ajan önce her belge için get_document_info çağırsın. Bu, pageCount değerini döndürür, böylece ajan dosya başına sayfa numarasını hesaplayabilir:

Klasördeki her PDF için sayfa sayısını kontrol et, ardından her birinin son sayfasını çıkar.

Tahminle çalışan bir ajan, tahmininin yanlış olduğu dosyalarda başarısız olur. Hata dosya bazındadır, kritik değildir.

En sık karşılaşılan varyasyonlar nelerdir?

Her belgenin son sayfasını çıkar. Önce sayfa sayısını kontrol et.

Her sözleşmeden sayfa 2’yi al, ardından hepsini tek bir inceleme dosyasında birleştir.

Her dosya için imza sayfasını çıkar ve sonuçları çıktı klasörüne koy.

İkinci komut, en fazla dört belgelik turlarda mergee bağlanır; bu, her kaynaktan bir sayfa alınarak tek bir birleşik belge oluşturur. Dörtten fazla kaynak daha fazla tur anlamına gelir. İmza‑sayfası komutu, ajana imzanın hangi sayfada olduğunu söylerseniz çalışır; araç verilen sayfa numaralarını çıkarır ve içerik araması yapmaz.

Bir klasör başına bir komut ne zaman uygun boyuttadır?

Aynı kural her dosyaya uygulanıyorsa kullanın: ilk sayfa, son sayfa, bilinen bir imza sayfası. Komut kuralı bir kez belirtir ve ajan dosya dosya uygular. Arşiv ve yasal‑inceleme işleri bu şekle uyar: her dosyadan bir kapak sayfası indeks için ya da her sözleşmeden imzaları taşıyan sayfa kontrol için. Kural dosya bazında farklıysa klasörü gruplara bölün ve grup başına bir komut çalıştırın; böylece her komut hâlâ tek bir kural içerir. Her toplu komutta “ürettiğin şeyi listele” talimatını tutun; liste, hangi dosyaların işlendiğinin kaydıdır.

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

Belgelendirilmiş araç davranışına dayalı bir illüstrasyon, yakalanmış bir ekran görüntüsü değildir.

You:   Extract page 1 from every PDF in my documents folder and
       list what you produced.

Agent: Found 3 PDFs in the folder.
       [calls split on each file with pages = "1"]
       Extracted page 1 from all 3 files: 3 single-page documents
       in your output folder. No failures.

Çok sayıda dosyada ne gibi sorunlar ortaya çıkar?

  • Hatalar dosya bazındadır. Bozuk ya da şifre korumalı bir belge kendi çağrısında başarısız olur. Hataları bir liste olarak isteyin, böylece 40 dosyadan oluşan bir toplu iki hatayı gizlemez. split aracı, korumalı belgeler için bir password argümanı kabul eder.
  • Kısa bir belge. Var olmayan bir sayfa istenirse o dosya için hata oluşur; diğer dosyalar etkilenmez.
  • Ölçülen kullanım birikir. Ölçülen lisanslama altında, her çağrı işleme olarak faturalandırılır.

Dürüst sınırlamalar

  • Değerlendirme modu birleştirilmiş çıktıyı 3 sayfaya kırpar. Sonuç, her sayfada bir deneme rozeti bulunan ilk 3 sayfaya kırpılır. Tek sayfa çıkarımı etkilenmez, ancak sonuçları birleştirdiğiniz anda sınır sessizce uygulanır. Kırk ilk sayfadan oluşturulan birleştirilmiş inceleme dosyası üç sayfa olarak geri döner. Çalıştırmadan önce get_license_status kontrol edin.
  • İçerik araması yok. Ajan sayfaları numarayla seçer. “İmzanın bulunduğu sayfa”yı bulmak sizin talimatınızdır, araç özelliği değildir.
  • Araçta klasör modu yok. Tek bir split çağrısı tek bir dosyayı işler, bu yüzden büyük bir klasör birçok çağrı demektir.

SSS

Bir klasördeki tüm PDF’lerin ilk sayfasını nasıl çıkarırım? Sunucuyu klasöre yönlendirin, ardından şu komutu verin: “Belgeler klasörümdeki her PDF’den sayfa 1’i çıkar ve ürettiğin şeyi listele.” Ajan her dosya için split çağırır.

AI toplu olarak belgeleri bölüp sayfaları tek bir dosyada toplayabilir mi? Evet. Çıkarma işleminden sonra ajanı, tek sayfalık dosyaları dörtlük turlarda birleştirmesi için isteyin. Değerlendirme modunda bu birleştirilmiş dosya 3 sayfaya kırpılır.

Dosyalar makinemden çıkıyor mu? Hayır. Sunucu, yapılandırdığınız klasörleri yerel stdio aktarımı üzerinden okur ve yazar, gelen bağlantı noktası yoktur.

Daha derine in