Om een map in batch te converteren met een AI‑agent, richt je de GroupDocs.Conversion.Mcp‑server op de map en beschrijf je de taak in één zin. De agent werkt de bestanden af, roept de conversie‑engine één keer per document aan en rapporteert wat er is geproduceerd, allemaal lokaal in Claude, Cursor of GitHub Copilot. Het is batchverwerking aangestuurd door een zin:

Converteer elk DOCX in mijn documentenmap naar PDF, behoud de originelen

De stap‑voor‑stap versie met configuratie en probleemoplossing staat in de documentatie: How to batch-convert a folder of documents with an AI agent. Deze post loopt dezelfde taak door als een korte sessie, van de eerste prompt tot het afhandelen van fouten.

Waar begin je: de opslagmap of de prompt?

Begin met de opslagmap. Een batchtaak slaagt of faalt op basis van de mapkoppeling, en de koppeling wordt één keer ingesteld in de serverconfiguratie, niet in elke prompt. Twee omgevingsvariabelen regelen dit:

{
  "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 is de map die de agent kan lezen. GROUPDOCS_MCP_OUTPUT_PATH is waar geconverteerde bestanden terechtkomen. Met beide ingesteld blijft de bronmap onaangeroerd en gaat elk resultaat naar converted. Dit is de netste indeling voor een batch. Het dnx‑commando heeft de .NET 10 SDK nodig; de Docker‑image ghcr.io/groupdocs-conversion/conversion-net-mcp:latest koppelt de map als /data. Start Claude Desktop, Claude Code, VS Code of Cursor opnieuw nadat je de server hebt geregistreerd.

Wat doet de eerste prompt?

Geef de agent eerst het eenvoudige geval:

Converteer alles in deze map van DOCX naar PDF.

De agent doorloopt de map en roept voor elk bestand het convert‑tool aan met format: "pdf". Elke oproep neemt een bestandsnaam uit de opslag en retourneert de opgeslagen bestandsnaam. Voer het twee keer uit en de tweede uitvoering maakt nieuwe, duidelijk anders benoemde bestanden naast de eerste.

Hoe voeg je een filter of regel toe?

De prompt is de orkestratielaag. Filteren, sequencen en een foutbeleid zijn gewone taal:

Zet alle PDF’s om naar Markdown; sla bestanden over die al geconverteerd zijn.

Converteer de facturen naar PDF/A voor archivering, en lijst elk bestand op dat is mislukt.

Maak PNG‑voorbeelden van elke presentatie.

Voor sequencen kan de agent eerst get_document_info aanroepen, wat het bestandstype, paginacount en basis‑eigenschappen retourneert zonder te converteren:

Controleer eerst het paginacount van elke PDF, en converteer alleen die met meer dan 10 pagina’s.

De beslissing “meer dan 10 pagina’s” is van de agent. De conversie blijft van de engine.

Wat gebeurt er als één bestand faalt?

Wanneer de engine een bestand niet kan converteren, bijvoorbeeld omdat het bronformaat niet wordt ondersteund of het wachtwoord onjuist is, begint de respons‑tekst voor dat bestand met de bewerking en de reden. Een bestandsnaam die niet bestaat, retourneert de lijst van bestanden die de server kan zien zodat de agent zichzelf kan corrigeren. Voor beveiligde bestanden accepteert convert een optionele password‑parameter.

Daarom hoort een foutbeleid in de prompt: “lijst elk bestand dat is mislukt” vraagt de agent om een rapport aan het einde van de uitvoering, zodat een fout niet onopgemerkt blijft. Lees het rapport en voer alleen de mislukkingen opnieuw uit.

Voorbeeldsessie

Dit is een verkorte, illustratieve sessie. De bestandsnamen zijn verzonnen en het antwoord is gebaseerd op de gedocumenteerde werking, niet op een screenshot.

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).

Hoe volg je de voortgang bij een grote map?

De agent verwerkt meestal bestanden één voor één, dus de uitvoeringstijd groeit met het aantal bestanden en hun grootte. Vraag voor voortgangsrapportage in de prompt: “vertel me na elke tien bestanden” of “geef een samenvatting aan het einde”. Een paar honderd documenten werken prima, en het eindrapport vertelt wat er is gebeurd. Begin met een kopie van een kleine subset, controleer twee of drie resultaten visueel, en voer daarna de volledige map uit.

Wat als de batch onbemand moet draaien?

Een agentsessie vereist een persoon om deze te starten. Voor geplande pipelines toont de n8n walkthrough een workflow‑tool die dezelfde server aanstuurt, en de engine is ook scriptbaar via de GroupDocs.Conversion .NET‑bibliotheek. Gebruik de chat voor ad‑hoc batches waarbij je het rapport wilt lezen.

Wat zijn de limieten?

  • Evaluatiemodus beperkt een batch tot 15 documenten. Zonder licentie kan één serverproces maximaal 15 documenten openen en de output bevat een evaluatiewatermerk. Daarna falen verdere oproepen totdat de server opnieuw wordt gestart. Controleer de modus met get_license_status voordat je een echte batch start, of vraag “wat is de licentiestatus van de conversieserver?”.
  • Metered licenties vereisen uitgaand verkeer. Met metered‑sleutels wordt het gebruik gerapporteerd aan de GroupDocs‑servers, dus een machine achter een firewall moet een licentiebestand gebruiken. Documentinhoud wordt nooit verzonden.
  • Scans blijven afbeeldingen. OCR maakt geen deel uit van de server, dus een batch van alleen‑afbeelding‑PDF’s krijgt geen tekstlaag.

Veelgestelde vragen

Hoe converteer ik alle DOCX‑bestanden in een map naar PDF met AI?
Stel de opslagmap in en vraag je agent vervolgens precies dat in één zin. Hij converteert de bestanden één voor één via de lokale server en er wordt niets geüpload.

Kan een AI‑agent een volledige map lokaal verwerken?
Ja. De agent en de conversieserver draaien beide op je machine, en de bestanden worden gelezen uit en geschreven naar je eigen mappen.

Wat is de beste manier om een documentconversiepijplijn te automatiseren?
Gebruik de chat voor ad‑hoc batches die je wilt beoordelen. Voor een pijplijn die volgens een schema draait, stuur je dezelfde server aan vanuit een workflow‑tool zoals n8n, of script je de .NET‑bibliotheek.

Ga dieper