Pour convertir un dossier en lot avec un agent IA, pointez le serveur GroupDocs.Conversion.Mcp vers le dossier et décrivez la tâche en une phrase. L’agent parcourt les fichiers, appelle le moteur de conversion une fois par document et indique ce qu’il a produit, le tout localement dans Claude, Cursor ou GitHub Copilot. Il s’agit d’un traitement par lots piloté par une phrase :

Convertir chaque DOCX de mon dossier documents en PDF, en conservant les originaux

La version pas‑à‑pas avec configuration et dépannage se trouve dans la documentation : Comment convertir en lot un dossier de documents avec un agent IA. Cet article décrit la même tâche sous forme de courte session, du premier prompt à la gestion des échecs.

Par où commencer : le dossier de stockage ou le prompt ?

Commencez par le dossier de stockage. Un travail en lot réussit ou échoue selon le mappage du dossier, et ce mappage est défini une seule fois dans l’entrée du serveur, pas dans chaque prompt. Deux variables d’environnement le contrôlent :

{
  "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 est le dossier que l’agent peut lire. GROUPDOCS_MCP_OUTPUT_PATH est l’endroit où les fichiers convertis sont déposés. Avec les deux définies, le dossier source reste intact et chaque résultat va dans converted. C’est la disposition la plus propre pour un lot. La commande dnx nécessite le SDK .NET 10 ; l’image Docker ghcr.io/groupdocs-conversion/conversion-net-mcp:latest monte le dossier sous /data. Redémarrez Claude Desktop, Claude Code, VS Code ou Cursor après avoir enregistré le serveur.

Que fait le premier prompt ?

Donnez d’abord à l’agent le cas le plus simple :

Convertir tout le contenu de ce dossier de DOCX en PDF.

L’agent énumère le dossier et appelle l’outil convert pour chaque fichier avec format: "pdf". Chaque appel prend un nom de fichier depuis le stockage et renvoie le nom du fichier enregistré. Exécutez‑le deux fois ; la seconde exécution crée de nouveaux fichiers, nommés différemment, à côté des premiers.

Comment ajouter un filtre ou une règle ?

Le prompt constitue la couche d’orchestration. Le filtrage, le séquençage et une politique d’erreur sont exprimés en langage naturel :

Convertir tous les PDF en Markdown ; ignorer les fichiers déjà convertis.

Convertir les factures en PDF/A pour l’archivage, et lister tout fichier qui a échoué.

Créer des aperçus PNG de chaque présentation.

Pour le séquençage, l’agent peut appeler get_document_info d’abord, ce qui renvoie le type de fichier, le nombre de pages et quelques propriétés de base sans conversion :

Vérifier le nombre de pages de chaque PDF d’abord, et ne convertir que ceux qui ont plus de 10 pages.

La décision « plus de 10 pages » revient à l’agent. La conversion reste la responsabilité du moteur.

Que se passe‑t‑il lorsqu’un fichier échoue ?

Lorsque le moteur ne peut pas convertir un fichier, par exemple parce que le format source n’est pas pris en charge ou que le mot de passe est incorrect, le texte de réponse pour ce fichier commence par l’opération et la raison. Un nom de fichier inexistant renvoie la liste des fichiers que le serveur voit afin que l’agent puisse se corriger. Pour les fichiers protégés, convert accepte un paramètre optionnel password.

C’est pourquoi une politique d’échec doit figurer dans le prompt : « lister tout fichier qui a échoué » demande à l’agent de fournir un rapport à la fin de l’exécution, de sorte qu’un échec ne passe pas inaperçu. Lisez le rapport et relancez uniquement les fichiers en échec.

Session d’exemple

Voici une session abrégée et illustrative. Les noms de fichiers sont fictifs et la réponse est construite à partir du comportement documenté, pas d’une capture d’écran.

Vous :    Convertir les factures en PDF/A pour l'archivage, et lister tout fichier qui a échoué.
Agent :  [énumère les fichiers de factures]
Agent :  [appelle convert pour chaque fichier, un à la fois]
Agent :  Converti 11 fichiers vers le dossier de sortie.
        Échec : invoice-0412.docx (protégé par mot de passe, aucun mot de passe fourni).

Comment suivre la progression sur un gros dossier ?

L’agent traite généralement les fichiers les uns après les autres, de sorte que le temps d’exécution augmente avec le nombre de fichiers et leur taille. Pour obtenir un suivi, demandez‑le dans le prompt : « prévenez‑moi toutes les dix fichiers » ou « résumez à la fin ». Quelques centaines de documents fonctionnent sans problème, et le rapport final indique ce qui s’est passé. Commencez avec une petite copie du sous‑ensemble, vérifiez deux ou trois sorties à l’œil, puis lancez le traitement du dossier complet.

Et si le lot doit s’exécuter sans surveillance ?

Une session d’agent nécessite une personne pour la démarrer. Pour des pipelines planifiés, le guide n8n montre comment un outil de workflow pilote le même serveur, et le moteur est également scriptable via la bibliothèque GroupDocs.Conversion .NET. Utilisez le chat pour des lots ponctuels où vous souhaitez lire le rapport.

Quelles sont les limites ?

  • Le mode d’évaluation limite un lot à 15 documents. Sans licence, un processus serveur ne peut ouvrir que 15 documents au maximum et la sortie porte un filigrane d’évaluation. Au‑delà, les appels échouent jusqu’au redémarrage du serveur. Vérifiez le mode avec get_license_status avant de lancer un vrai lot, ou demandez « quel est le statut de licence du serveur de conversion ? ».
  • La licence à consommation nécessite un accès sortant. Avec des clés à consommation, l’utilisation est rapportée aux serveurs GroupDocs, donc une machine derrière un pare‑feu doit utiliser un fichier de licence. Le contenu des documents n’est jamais envoyé.
  • Les scans restent des images. L’OCR n’est pas intégré au serveur, ainsi un lot de PDF uniquement image ne gagnera pas de couche texte.

FAQ

Comment convertir tous les fichiers DOCX d’un dossier en PDF avec l’IA ?
Définissez le dossier de stockage, puis demandez à votre agent exactement cela en une phrase. Il convertit les fichiers un par un via le serveur local et rien n’est téléchargé.

Un agent IA peut‑il traiter un dossier entier localement ?
Oui. L’agent et le serveur de conversion s’exécutent tous deux sur votre machine, et les fichiers sont lus et écrits dans vos propres dossiers.

Quelle est la meilleure façon d’automatiser une chaîne de conversion de documents ?
Utilisez le chat pour des lots ponctuels que vous souhaitez examiner. Pour un pipeline programmé, pilotez le même serveur depuis un outil de workflow tel que n8n, ou scriptz la bibliothèque .NET.

Approfondir