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:

Konversi setiap DOCX di folder dokumen saya ke PDF, pertahankan yang asli

Versi langkah demi langkah dengan konfigurasi dan pemecahan masalah ada di dokumentasi: Cara mengonversi batch sebuah folder dokumen dengan agen AI. Posting ini menjelaskan pekerjaan yang sama sebagai sesi singkat, dari prompt pertama hingga penanganan kegagalan.

Dari mana Anda memulai: folder penyimpanan atau prompt?

Mulailah dengan folder penyimpanan. Sebuah pekerjaan batch berhasil atau gagal berdasarkan pemetaan folder, dan pemetaan tersebut diatur sekali dalam entri server, bukan di setiap prompt. Dua variabel lingkungan mengendalikannya:

{
  "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 adalah folder yang dapat dibaca agen. GROUPDOCS_MCP_OUTPUT_PATH adalah tempat file yang telah dikonversi disimpan. Dengan keduanya diatur, folder sumber tetap tidak tersentuh dan setiap hasil masuk ke converted. Ini adalah tata letak paling bersih untuk batch. Perintah dnx memerlukan .NET 10 SDK; image Docker ghcr.io/groupdocs-conversion/conversion-net-mcp:latest memasang folder sebagai /data. Restart Claude Desktop, Claude Code, VS Code, atau Cursor setelah Anda mendaftarkan server.

Apa yang dilakukan prompt pertama?

Berikan agen kasus sederhana terlebih dahulu:

Konversi semua yang ada di folder ini dari DOCX ke PDF.

Agen menelusuri folder dan memanggil alat convert untuk setiap file dengan format: "pdf". Setiap panggilan mengambil nama file dari penyimpanan dan mengembalikan nama file yang disimpan. Jalankan dua kali dan run kedua akan membuat file baru dengan nama yang berbeda di samping yang pertama.

Bagaimana cara menambahkan filter atau aturan?

Prompt adalah lapisan orkestrasi. Penyaringan, urutan, dan kebijakan kesalahan dapat dituliskan dalam bahasa biasa:

Ubah semua PDF menjadi Markdown; lewati file yang sudah dikonversi.

Konversi faktur ke PDF/A untuk arsip, dan daftar setiap file yang gagal.

Buat pratinjau PNG untuk setiap presentasi.

Untuk urutan, agen dapat memanggil get_document_info terlebih dahulu, yang mengembalikan tipe file, jumlah halaman, dan properti dasar tanpa melakukan konversi:

Periksa jumlah halaman setiap PDF terlebih dahulu, dan hanya konversi yang memiliki lebih dari 10 halaman.

Keputusan “lebih dari 10 halaman” adalah milik agen. Konversi tetap menjadi tugas mesin.

Apa yang terjadi ketika satu file gagal?

Ketika mesin tidak dapat mengonversi sebuah file, misalnya karena format sumber tidak didukung atau kata sandi salah, teks respons untuk file tersebut dimulai dengan operasi dan alasannya. Nama file yang tidak ada mengembalikan daftar file yang dapat dilihat server sehingga agen dapat memperbaikinya. Untuk file yang dilindungi, convert menerima parameter opsional password.

Itulah mengapa kebijakan kegagalan harus dimasukkan dalam prompt: “daftar setiap file yang gagal” meminta agen membuat laporan di akhir proses, sehingga kegagalan tidak terlewat. Baca laporan tersebut dan jalankan ulang hanya file yang gagal.

Sesi contoh

Berikut adalah sesi singkat yang bersifat ilustratif. Nama file dibuat-buat dan balasan dibangun berdasarkan perilaku yang didokumentasikan, bukan tangkapan layar.

You:    Convert the invoices to PDF/A for archiving, and list any file that failed.
Agent:  [enumerates the invoice files]
Agent:  [calls convert for each file, one at a time]
Agent:  Converted 11 files to the output folder.
        Failed: invoice-0412.docx (password-protected, no password given).

Bagaimana Anda mengikuti kemajuan pada folder besar?

Agen biasanya memproses file satu per satu, sehingga waktu berjalan meningkat seiring jumlah file dan ukuran mereka. Untuk pelaporan kemajuan, minta dalam prompt: “beritahu saya setelah setiap sepuluh file” atau “ringkas di akhir”. Beberapa ratus dokumen dapat diproses dengan baik, dan laporan akhir memberi tahu apa yang terjadi. Mulailah dengan menyalin subset kecil, periksa dua atau tiga output secara visual, lalu jalankan seluruh folder.

Bagaimana jika batch harus dijalankan tanpa pengawasan?

Sesi agen memerlukan orang untuk memulainya. Untuk pipeline terjadwal, panduan n8n menunjukkan alat alur kerja yang mengendalikan server yang sama, dan mesin juga dapat diprogram melalui pustaka .NET GroupDocs.Conversion. Gunakan obrolan untuk batch ad‑hoc ketika Anda ingin membaca laporan.

Apa batasannya?

  • Mode evaluasi membatasi batch hingga 15 dokumen. Tanpa lisensi, satu proses server dapat membuka paling banyak 15 dokumen dan outputnya membawa watermark evaluasi. Setelah itu, panggilan selanjutnya gagal hingga server di‑restart. Periksa mode dengan get_license_status sebelum memulai batch nyata, atau tanyakan “apa status lisensi server konversi?”.
  • Lisensi berbasis meter memerlukan akses keluar. Dengan kunci metered, penggunaan dilaporkan ke server GroupDocs, sehingga mesin yang berada di belakang firewall sebaiknya menggunakan file lisensi. Konten dokumen tidak pernah dikirim.
  • Pemindaian tetap berupa gambar. OCR bukan bagian dari server, jadi batch PDF yang hanya berisi gambar tidak akan memperoleh lapisan teks.

Tanya Jawab

Bagaimana cara mengonversi semua file DOCX dalam folder ke PDF dengan AI?
Atur folder penyimpanan, lalu minta agen Anda melakukan hal itu dalam satu kalimat. Agen akan mengonversi file satu per satu melalui server lokal dan tidak ada yang diunggah.

Apakah agen AI dapat memproses seluruh folder secara lokal?
Ya. Agen dan server konversi keduanya berjalan di mesin Anda, dan file dibaca serta ditulis ke folder Anda sendiri.

Apa cara terbaik mengotomatisasi pipeline konversi dokumen?
Gunakan obrolan untuk batch ad‑hoc yang ingin Anda tinjau. Untuk pipeline yang dijalankan secara terjadwal, kendalikan server yang sama melalui alat alur kerja seperti n8n, atau skrip menggunakan pustaka .NET.

Mendalami lebih dalam