Aby wsadowo konwertować folder przy pomocy agenta AI, skieruj serwer GroupDocs.Conversion.Mcp na folder i opisz zadanie w jednym zdaniu. Agent przetwarza pliki, wywołuje silnik konwersji raz na dokument i zgłasza, co zostało wyprodukowane, wszystko lokalnie w Claude, Cursor lub GitHub Copilot. To przetwarzanie wsadowe sterowane zdaniem:

Konwertuj wszystkie pliki DOCX w moim folderze dokumentów na PDF, zachowaj oryginały

Krok‑po‑kroku wersja z konfiguracją i rozwiązywaniem problemów znajduje się w dokumentacji: How to batch-convert a folder of documents with an AI agent. Ten wpis przechodzi przez to samo zadanie jako krótka sesja, od pierwszego polecenia po obsługę błędów.

Od czego zacząć: folder magazynu czy polecenie?

Zacznij od folderu magazynu. Zadanie wsadowe odnosi sukces lub porażkę w zależności od mapowania folderu, a mapowanie jest ustawiane raz w wpisie serwera, a nie w każdym poleceniu. Dwie zmienne środowiskowe kontrolują to:

{
  "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 to folder, który agent może odczytać. GROUPDOCS_MCP_OUTPUT_PATH to miejsce, w którym lądują skonwertowane pliki. Gdy oba są ustawione, folder źródłowy pozostaje nietknięty, a każdy wynik trafia do converted. To najczystszy układ dla wsadu. Polecenie dnx wymaga SDK .NET 10; obraz Docker ghcr.io/groupdocs-conversion/conversion-net-mcp:latest montuje folder jako /data. Po zarejestrowaniu serwera uruchom ponownie Claude Desktop, Claude Code, VS Code lub Cursor.

Co robi pierwsze polecenie?

Najpierw podaj agentowi prosty przypadek:

Konwertuj wszystko w tym folderze z DOCX na PDF.

Agent wymienia pliki w folderze i wywołuje narzędzie convert dla każdego z nich z parametrem format: "pdf". Każde wywołanie pobiera nazwę pliku z magazynu i zwraca zapisaną nazwę pliku. Uruchom to dwukrotnie, a drugi przebieg utworzy nowe, wyraźnie nazwane pliki obok pierwszych.

Jak dodać filtr lub regułę?

Polecenie jest warstwą orkiestracji. Filtrowanie, sekwencjonowanie i polityka błędów to zwykły język:

Przekształć wszystkie PDF‑y w Markdown; pomiń pliki, które już zostały skonwertowane.

Konwertuj faktury na PDF/A do archiwizacji i wypisz każdy plik, który się nie powiódł.

Utwórz podglądy PNG każdej prezentacji.

Do sekwencjonowania agent może najpierw wywołać get_document_info, które zwraca typ pliku, liczbę stron i podstawowe właściwości bez konwersji:

Najpierw sprawdź liczbę stron każdego PDF‑a i konwertuj tylko te, które mają więcej niż 10 stron.

Decyzja „więcej niż 10 stron” należy do agenta. Konwersja pozostaje w gestii silnika.

Co się dzieje, gdy jeden plik nie powiedzie się?

Gdy silnik nie może skonwertować pliku – np. format źródłowy nie jest obsługiwany lub hasło jest nieprawidłowe – tekst odpowiedzi dla tego pliku zaczyna się od operacji i przyczyny. Nieistniejąca nazwa pliku zwraca listę plików, które serwer widzi, aby agent mógł się poprawić. Dla plików zabezpieczonych convert przyjmuje opcjonalny parametr password.

Dlatego polityka niepowodzeń należy umieścić w poleceniu: „wypisz każdy plik, który się nie powiódł” prosi agenta o raport na koniec działania, tak aby nieprzyjęte błędy nie przeszły niezauważone. Przeczytaj raport i uruchom ponownie tylko nieudane pliki.

Przykładowa sesja

Poniżej skrócona, ilustracyjna sesja. Nazwy plików są wymyślone, a odpowiedź oparta jest na udokumentowanym zachowaniu, nie na zrzucie ekranu.

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 śledzić postęp w dużym folderze?

Agent zazwyczaj przetwarza pliki kolejno, więc czas działania rośnie wraz z liczbą plików i ich rozmiarem. Aby uzyskać raportowanie postępu, poproś o to w poleceniu: „powiedz mi po każdych dziesięciu plikach” lub „podsumuj na końcu”. Kilkaset dokumentów działa bez problemu, a końcowy raport informuje, co się stało. Zacznij od kopii małego podzbioru, sprawdź dwa‑trzy wyniki ręcznie, a potem uruchom pełny folder.

Co zrobić, gdy wsad musi działać bez nadzoru?

Sesja agenta wymaga osoby, która ją uruchomi. Dla zaplanowanych potoków, przewodnik n8n walkthrough pokazuje, jak narzędzie do przepływu pracy steruje tym samym serwerem, a silnik można także wywoływać skryptowo przez bibliotekę GroupDocs.Conversion .NET. Używaj czatu do ad‑hoc wsadów, gdy chcesz przeczytać raport.

Jakie są limity?

  • Tryb ewaluacji ogranicza wsad do 15 dokumentów. Bez licencji jeden proces serwera może otworzyć maksymalnie 15 dokumentów, a wynik zawiera znak wodny ewaluacji. Po przekroczeniu dalsze wywołania kończą się niepowodzeniem, dopóki serwer nie zostanie ponownie uruchomiony. Sprawdź tryb poleceniem get_license_status przed rozpoczęciem prawdziwego wsadu lub zapytaj „jaki jest status licencji serwera konwersji?”.
  • Licencjonowanie metryczne wymaga dostępu wychodzącego. Przy kluczach metrycznych użycie jest raportowane do serwerów GroupDocs, więc maszyna za zaporą powinna korzystać z pliku licencji. Zawartość dokumentu nigdy nie jest wysyłana.
  • Skany pozostają obrazami. OCR nie jest częścią serwera, więc wsad składający się wyłącznie z PDF‑ów zawierających obrazy nie uzyska warstwy tekstowej.

FAQ

Jak skonwertować wszystkie pliki DOCX w folderze na PDF przy pomocy AI?
Ustaw folder magazynu, a następnie poproś agenta o to w jednym zdaniu. Agent konwertuje pliki po kolei przez lokalny serwer i nic nie jest przesyłane.

Czy agent AI może przetworzyć cały folder lokalnie?
Tak. Agent i serwer konwersji działają na Twoim komputerze, a pliki są odczytywane i zapisywane w Twoich własnych folderach.

Jaki jest najlepszy sposób na automatyzację potoku konwersji dokumentów?
Używaj czatu do ad‑hoc wsadów, które chcesz zweryfikować. Dla potoku uruchamianego według harmonogramu steruj tym samym serwerem z narzędzia do przepływu pracy, takiego jak n8n, lub skryptuj bibliotekę .NET.

Zanurz się głębiej