To batch convert a folder with an AI agent, point the GroupDocs.Conversion.Mcp server at the folder and describe the job in one sentence. The agent works through the files, calls the conversion engine once per document, and reports what it produced, all locally in Claude, Cursor or GitHub Copilot. It is batch processing driven by a sentence:

Convert every DOCX in my documents folder to PDF, keep the originals

The step-by-step version with config and troubleshooting is in the documentation: How to batch-convert a folder of documents with an AI agent. This post walks through the same job as a short session, from the first prompt to handling failures.

Nereden Başlamalısınız: Depolama Klasörü mü yoksa İstem mi?

Depolama klasörüyle başlayın. Bir toplu iş, klasör eşlemesinde başarılı olur ya da başarısız olur ve eşleme sunucu girişinde bir kez ayarlanır, her istemde değil. İki ortam değişkeni bunu kontrol eder:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/invoices",
        "GROUPDOCS_MCP_OUTPUT_PATH": "/path/to/invoices/converted"
      }
    }
  }
}

GROUPDOCS_MCP_STORAGE_PATH ajanının okuyabileceği klasördür. GROUPDOCS_MCP_OUTPUT_PATH ise dönüştürülmüş dosyaların konulduğu yerdir. İkisi de ayarlandığında kaynak klasör dokunulmaz kalır ve her sonuç converted klasörüne gider. Bu, toplu işlem için en temiz düzenlemedir. dnx komutu .NET 10 SDK’sını gerektirir; Docker görüntüsü ghcr.io/groupdocs-conversion/conversion-net-mcp:latest klasörü /data olarak bağlar. Sunucuyu kaydettikten sonra Claude Desktop, Claude Code, VS Code veya Cursor’ı yeniden başlatın.

İlk istem ne yapar?

Ajanı önce basit bir senaryoyla besleyin:

Bu klasördeki her şeyi DOCX’ten PDF’e dönüştür.

Ajan klasörü tarar ve her dosya için convert aracını format: "pdf" parametresiyle çağırır. Her çağrı depolamadan bir dosya adı alır ve kaydedilen dosya adını döndürür. İki kez çalıştırdığınızda ikinci çalıştırma, birincinin yanına yeni, farklı adlandırılmış dosyalar oluşturur.

Bir filtre veya kural nasıl eklenir?

İstem, orkestrasyon katmanıdır. Filtreleme, sıralama ve hata politikası düz dilde ifade edilir:

Tüm PDF’leri Markdown’a dönüştür; zaten dönüştürülmüş dosyaları atla.

Faturaları arşivleme için PDF/A’ya dönüştür ve başarısız olan herhangi bir dosyayı listele.

Her sunumu PNG önizlemelerine çevir.

Sıralama için ajan önce get_document_info çağrısı yapabilir; bu, dosya türü, sayfa sayısı ve temel özellikleri dönüştürmeden döndürür:

Önce her PDF’in sayfa sayısını kontrol et ve sadece 10 sayfadan fazla olanları dönüştür.

“10 sayfadan fazla” kararı ajanın sorumluluğundadır. Dönüştürme ise motorun işidir.

Bir dosya başarısız olduğunda ne olur?

Motor bir dosyayı dönüştüremediğinde, örneğin kaynak format desteklenmiyorsa ya da şifre yanlışsa, o dosya için yanıt metni işlemi ve nedeniyle başlar. Var olmayan bir dosya adı, sunucunun görebildiği dosya listesini döndürür, böylece ajan kendini düzeltebilir. Korunan dosyalar için convert isteğe bağlı bir password parametresi kabul eder.

Bu yüzden bir hata politikası istemde yer almalıdır: “başarısız olan herhangi bir dosyayı listele” ifadesi, çalışmanın sonunda ajandan bir rapor talep eder, böylece bir hata gözden kaçmaz. Raporu okuyun ve yalnızca başarısız olanları yeniden çalıştırın.

Örnek oturum

Bu, kısaltılmış ve örnek bir oturumdur. Dosya adları uydurulmuş olup yanıt, belgelenen davranışa dayanarak oluşturulmuştur, ekran görüntüsü değildir.

You:    Faturaları arşivleme için PDF/A’ya dönüştür ve başarısız olan herhangi bir dosyayı listele.
Agent:  [fatura dosyalarını listeler]
Agent:  [her dosya için birer kez convert’i çağırır]
Agent:  11 dosya çıktı klasörüne dönüştürüldü.
        Başarısız: invoice-0412.docx (şifre korumalı, şifre verilmedi).

Büyük bir klasörde ilerlemeyi nasıl takip edersiniz?

Ajan genellikle dosyaları birbiri ardına işler, bu yüzden çalışma süresi dosya sayısı ve boyutlarıyla artar. İlerleme raporu istemek için istemde belirtin: “her on dosyada bir bana bildir” ya da “sonunda özetle”. Birkaç yüz belge sorunsuz çalışır ve son rapor ne olduğunu söyler. Küçük bir alt kümenin kopyasıyla başlayın, iki‑üç çıktıyı gözle kontrol edin, ardından tam klasörü çalıştırın.

Toplu işlem gözetimsiz çalışmalıysa ne olur?

Bir ajan oturumu başlatmak için bir kişi gerekir. Zamanlanmış boru hatları için n8n walkthrough aynı sunucuyu yöneten bir iş akışı aracını gösterir ve motor ayrıca GroupDocs.Conversion .NET kütüphanesiyle betiklenebilir. Raporu okumak istediğiniz anlık toplu işlemler için sohbeti kullanın.

Sınırlamalar nelerdir?

  • Değerlendirme modu bir toplu işi 15 belgeyle sınırlar. Lisans olmadan bir sunucu süreci en fazla 15 belge açabilir ve çıktı bir değerlendirme filigranı taşır. Bundan sonra daha fazla çağrı, sunucu yeniden başlatılana kadar başarısız olur. Gerçek bir toplu işlem başlatmadan önce get_license_status ile modu kontrol edin ya da “dönüştürme sunucusunun lisans durumu nedir?” diye sorun.
  • Ölçülen lisanslama dışa erişim gerektirir. Ölçülen anahtarlarla kullanım GroupDocs sunucularına raporlanır, bu yüzden güvenlik duvarı arkasındaki bir makine bir lisans dosyası kullanmalıdır. Belge içeriği asla gönderilmez.
  • Taramalar görüntü olarak kalır. OCR sunucunun bir parçası değildir, bu yüzden yalnızca görüntü içeren PDF’ler metin katmanı kazanmaz.

SSS

Tüm DOCX dosyalarını bir klasörde AI ile PDF’e nasıl dönüştürürüm?
Depolama klasörünü ayarlayın, ardından ajana tek cümleyle tam olarak bunu söyleyin. Dosyaları tek tek yerel sunucu üzerinden dönüştürür ve hiçbir şey yüklenmez.

Bir AI ajanı tüm klasörü yerel olarak işleyebilir mi?
Evet. Ajan ve dönüştürme sunucusu aynı makinede çalışır, dosyalar kendi klasörlerinizden okunur ve yazılır.

Belge dönüştürme boru hattını otomatikleştirmenin en iyi yolu nedir?
İncelemek istediğiniz anlık toplu işlemler için sohbeti kullanın. Zamanlanmış bir boru hattı için aynı sunucuyu n8n gibi bir iş akışı aracıyla yönetin ya da .NET kütüphanesini betikleyin.

Daha derine