K dávkovému převodu složky pomocí AI agenta nasměrujte server GroupDocs.Conversion.Mcp na složku a popište úlohu jednou větou. Agent prochází soubory, jednou pro každý dokument zavolá převodní engine a nahlásí, co vytvořil, vše lokálně v Claude, Cursor nebo GitHub Copilot. Jedná se o dávkové zpracování řízené větou:

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

Postupná verze s konfigurací a řešením problémů je v dokumentaci: How to batch-convert a folder of documents with an AI agent. Tento příspěvek prochází stejnou úlohu jako krátkou relaci, od prvního promptu po zpracování selhání.

Kde začít: úložní složka nebo prompt?

Začněte úložní složkou. Dávková úloha uspěje nebo selže na mapování složky a mapování se nastavuje jednou v záznamu serveru, ne v každém promptu. Dvě proměnné prostředí to řídí:

{
  "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 je složka, kterou může agent číst. GROUPDOCS_MCP_OUTPUT_PATH je místo, kam se ukládají převedené soubory. S oběma nastavenými zůstane zdrojová složka nedotčena a každý výsledek jde do converted. Toto je nejčistší uspořádání pro dávku. Příkaz dnx vyžaduje .NET 10 SDK; Docker image ghcr.io/groupdocs-conversion/conversion-net-mcp:latest připojuje složku jako /data. Po zaregistrování serveru restartujte Claude Desktop, Claude Code, VS Code nebo Cursor.

Co dělá první prompt?

Nejprve agentovi dejte jednoduchý případ:

Convert everything in this folder from DOCX to PDF.

Agent projde složku a pro každý soubor zavolá nástroj convert s parametrem format: "pdf". Každé volání vezme název souboru ze storage a vrátí uložený název souboru. Spusťte to dvakrát a druhý běh vytvoří nové, odlišně pojmenované soubory vedle prvních.

Jak přidat filtr nebo pravidlo?

Prompt je vrstva orchestrace. Filtrování, sekvenování a politika chyb jsou prostý jazyk:

Turn all the PDFs into Markdown; skip files that are already converted.

Convert the invoices to PDF/A for archiving, and list any file that failed.

Make PNG previews of every presentation.

Pro sekvenování může agent nejprve zavolat get_document_info, který vrátí typ souboru, počet stránek a základní vlastnosti bez převodu:

Check the page count of each PDF first, and only convert the ones with more than 10 pages.

Rozhodnutí „více než 10 stránek“ je na agentovi. Převod zůstává úkolem engine.

Co se stane, když jeden soubor selže?

Když engine nemůže soubor převést, například protože formát není podporován nebo je špatné heslo, textová odpověď pro tento soubor začne operací a důvodem. Název souboru, který neexistuje, vrátí seznam souborů, které server vidí, aby si agent mohl opravit chybu. Pro chráněné soubory convert přijímá volitelný parametr password.

Proto patří politika selhání do promptu: „list any file that failed“ požaduje od agenta zprávu na konci běhu, takže selhání nezůstane nepovšimnuté. Přečtěte si zprávu a znovu spusťte jen selhané soubory.

Příklad relace

Jedná se o zkrácenou, ilustrační relaci. Názvy souborů jsou vymyšlené a odpověď je postavena na zdokumentovaném chování, ne na snímku obrazovky.

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

Jak sledovat průběh u velké složky?

Agent obvykle zpracovává soubory jeden po druhém, takže doba běhu roste s počtem souborů a jejich velikostí. Pro hlášení průběhu požádejte o to v promptu: „tell me after every ten files“ nebo „summarize at the end“. Několik stovek dokumentů funguje bez problémů a závěrečná zpráva vám řekne, co se stalo. Začněte s kopií malé podmnožiny, vizuálně zkontrolujte dva‑tři výstupy a pak spusťte celou složku.

Co když musí dávka běžet bez dozoru?

Relace agenta potřebuje člověka, který ji spustí. Pro naplánované pipeline ukazuje n8n walkthrough workflow nástroj, který řídí stejný server, a engine je také skriptovatelný přes .NET knihovnu GroupDocs.Conversion. Použijte chat pro ad‑hoc dávky, kde chcete přečíst zprávu.

Jaké jsou limity?

  • Režim hodnocení omezuje dávku na 15 dokumentů. Bez licence může jeden proces serveru otevřít nejvýše 15 dokumentů a výstup nese hodnocení‑vodoznak. Po překročení další volání selžou, dokud se server nerestartuje. Zkontrolujte režim pomocí get_license_status před zahájením skutečné dávky, nebo se zeptejte „what is the license status of the conversion server?“.
  • Měřené licencování vyžaduje odchozí přístup. U měřených klíčů se využití hlásí serverům GroupDocs, takže stroj za firewallem by měl používat licenční soubor. Obsah dokumentů se nikdy neposílá.
  • Skeny zůstávají obrázky. OCR není součástí serveru, takže dávka PDF obsahujících jen obrázky nezíská textovou vrstvu.

Často kladené otázky

Jak převést všechny DOCX soubory ve složce do PDF pomocí AI?
Nastavte úložní složku a poté agentovi řekněte přesně to jednou větou. Agent soubory převádí jeden po druhém přes lokální server a nic se neuploaduje.

Může AI agent zpracovat celou složku lokálně?
Ano. Agent i převodní server běží na vašem počítači a soubory se čtou a zapisují do vašich vlastních složek.

Jaký je nejlepší způsob, jak automatizovat pipeline převodu dokumentů?
Použijte chat pro ad‑hoc dávky, které chcete zkontrolovat. Pro pipeline, která běží podle plánu, řiďte stejný server z workflow nástroje jako n8n, nebo skriptujte .NET knihovnu.

Jděte hlouběji