Pour modifier en masse les propriétés des documents, donnez à un agent IA une norme et un dossier, et laissez‑le lire, écrire et vérifier via GroupDocs.Metadata.Mcp exécuté localement. Une seule invite suffit pour commencer :
Pour chaque document de mon dossier, définissez Company sur « Acme Ltd » et Author sur « Research Team », puis indiquez‑moi quels fichiers vous avez modifiés.
La version étape par étape avec configuration et dépannage se trouve dans la documentation : Comment corriger les propriétés des documents en masse avec un agent IA.
Pourquoi les normes de métadonnées dérivent‑elles en premier lieu ?
Les modèles laissent l’ancienne société dans chaque nouveau fichier. Un renommage d’équipe laisse l’ancien nom dans le champ auteur. Une migration laisse des horodatages qui n’ont aucun sens. Personne ne modifie les propriétés à la main sur 200 fichiers, donc la dérive persiste. Un agent avec une boucle est l’outil adéquat, mais seulement si la modification est effectuée par un moteur : un modèle de langage qui « réécrit » un document pour changer son auteur régénère le contenu, tandis que write_metadata modifie un champ et laisse le corps intact.
Quel est le flux de travail ?
Le flux de travail comporte quatre étapes, chacune avec une invite. Exécutez‑le dans Claude Desktop, Claude Code, Cursor, GitHub Copilot ou tout autre client qui a le serveur enregistré.
- Vérifier la licence. Demandez : « Quel est l’état de la licence du serveur de métadonnées ? » L’agent appelle
get_license_status. Faites‑le avant une exécution en masse, pas après. - Lire les valeurs actuelles. Demandez : « Listez d’abord l’auteur et la société actuels pour chaque fichier. » L’agent appelle
search_metadataavecnameContains, qui ne renvoie que les propriétés correspondantes. - Écrire uniquement ce qui est incorrect. Demandez : « Modifiez seulement celles qui sont erronées. » L’agent appelle
write_metadatapour chaque fichier et chaque propriété. - Vérifier. Demandez : « Relisez l’auteur et la société sur les nouveaux fichiers et listez ceux qui diffèrent encore, avec la raison. » Demandez les échecs sous forme de liste plutôt que de nombre.
Qui décide quoi : l’agent ou le moteur ?
| Decision | Made by |
|---|---|
| Quels fichiers sont concernés, et quelles valeurs sont incorrectes | L’agent, selon votre norme |
| Quel nom de propriété correspond à quel champ dans un PDF, un DOCX ou un JPEG | Le moteur : write_metadata associe le nom convivial selon le format |
| Si une propriété existe dans un format | Le moteur : une écriture qui ne s’applique pas indique 0 modifié ou échoue avec un message, jamais un succès silencieux |
| Ce qui a été enregistré et où | L’outil : il renvoie un message de chemin enregistré et le nombre de champs modifiés |
| Si l’état final correspond à la norme | L’agent, en relisant |
write_metadata accepte property parmi Author, Title, Subject, Keywords, Comments, Copyright, Company ou Manager. mode est set (remplacer, par défaut) ou add (ajouter, pour les champs de type liste comme Keywords).
Quelle est la règle qui préserve chaque modification ?
write_metadata définit une propriété par appel et enregistre un nouveau fichier. Deux propriétés sur un même document représentent deux appels, et le second doit être appliqué au résultat du premier. Si le second appel part du fichier original, la première modification disparaît. Lorsqu’un agent indique que les deux propriétés sont définies mais qu’une seule a été conservée, c’est la raison. Formulez la règle dans l’invite :
Appliquez la deuxième modification au fichier produit par la première, pas à l’original.
Exemple de session (abrégé)
You: Set Company to "Acme Ltd" on every .docx in the folder. List current values first.
Agent: [calls search_metadata: nameContains = "Company", per file]
Agent: proposal-q1.docx Company = "Contoso GmbH" -> will change
handbook.docx Company = "Acme Ltd" -> already correct
notes.docx (no Company property) -> will add
You: Go ahead. Name each file you produced.
Agent: [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent: 2 files changed, 1 unchanged. Each saved copy is named in the tool reply.
Ceci est une illustration du flux, pas une capture d’écran.
Pourquoi ne pas corriger tout le dossier en une seule passe ?
Une écriture en masse aveugle peut remplacer de bonnes valeurs par de mauvaises, donc l’étape de lecture est le test à blanc. Elle coûte un appel supplémentaire par fichier. Avec une licence à la consommation, chaque appel est facturé, et un balayage de deux propriétés sur 200 fichiers représente 400 appels d’écriture plus les lectures, il faut donc filtrer d’abord et écrire ensuite.
Les formats diffèrent. Une propriété qui n’a pas de place dans un format est signalée comme 0 modifié ou échoue avec un message au lieu de prétendre réussir, ce qui est le comportement correct mais signifie qu’un dossier mixte peut donner un résultat partiel. Demandez les échecs sous forme de liste.
Quelles sont les limites en mode d’évaluation ?
En mode d’évaluation, seules les 5 premières propriétés du document sont lisibles, et XMP et EXIF sont partiellement indisponibles. L’écriture est limitée de la même façon. Un flux de travail « vérifier, puis écrire » en évaluation vérifie une liste tronquée, il peut donc manquer la propriété que vous essayez de corriger. Confirmez avec get_license_status et appliquez un fichier de licence ou des clés à la consommation avant de vous fier au résultat. Une licence temporaire gratuite de 30 jours est disponible.
Questions fréquemment posées
Puis‑je changer l’auteur sur 100 documents Word d’un coup ?
Oui, avec une invite qui indique le dossier et la valeur. L’agent effectue un appel write_metadata par fichier pour la propriété Author, donc 100 fichiers représentent 100 appels d’écriture.
L’agent écrase‑t‑il mes fichiers originaux ?
L’outil enregistre un nouveau fichier et renvoie son chemin, ainsi l’original n’est pas le résultat. Demandez à l’agent de nommer chaque fichier qu’il a produit, et conservez les originaux jusqu’à ce que vous ayez vérifié les copies.
L’agent peut‑il définir une propriété personnalisée qui ne figure pas dans la liste ?
Les valeurs de property documentées sont Author, Title, Subject, Keywords, Comments, Copyright, Company et Manager. Tout autre valeur est hors du champ décrit par l’outil.
Approfondir
- Documentation, guide canonique : Comment corriger les propriétés des documents en masse avec un agent IA
- Hub de documentation : GroupDocs.Metadata MCP Server
- Commencez ici : 3 questions de métadonnées à poser à un agent IA avant de partager un document
- Lié : Questions sur la provenance des photos, répondues par un agent IA sans télécharger l’image
- Lié : Pourquoi le retrait des métadonnées ne rend pas un document sûr à partager
- Sur site et modèle de sécurité : 3 architectures pour le traitement de documents IA, et celle qui garde les fichiers à l’intérieur de votre réseau
- Questions : GroupDocs Metadata forum
- Source : GroupDocs.Metadata.Mcp on GitHub