Lorsque vous demandez à un agent IA de masquer une page numérisée et que la redaction de texte ne trouve rien à remplacer, la page n’est pas propre, elle n’a pas de couche de texte à rechercher. Pour masquer une numérisation localement, l’agent couvre une région par coordonnées avec redact_image_area au lieu de faire correspondre des mots. Avec GroupDocs.Redaction.Mcp connecté à Claude Desktop ou Cursor, la requête ressemble à ceci :

Couvrir le tiers inférieur de scan.png avec une boîte noire.

La version étape par étape avec configuration et dépannage se trouve dans la documentation : Comment masquer les documents et images numérisés avec un agent IA.

Pourquoi la redaction de texte ne trouve-t-elle rien sur une numérisation ?

Une numérisation est une image d’un document. Les mots qui y figurent sont des pixels, donc une expression régulière n’a rien à faire correspondre. redact_text ne trouve rien à remplacer sur une page numérisée, et ne rien trouver n’est pas équivalent à l’absence de données sensibles. Considérez un résultat vide sur un fichier uniquement image comme « pas de couche de texte », puis changez d’outil. Il en va de même pour les photographies, les tampons et une page de signature numérisée au verso d’un contrat autrement numérique.

Quel outil couvre une région d’une page ?

redact_image_area couvre un rectangle d’une page avec une boîte de couleur unie et masque de façon permanente le contenu image en dessous, comme les visages, les signatures et les tampons. Il prend x, y, width et height en pixels, mesurés depuis le coin supérieur gauche de la page, et une color optionnelle (noir par défaut, ou une valeur hexadécimale comme #FF0000). L’outil ne prend pas d’argument de page, seulement le fichier et le rectangle, donc ouvrez le résultat et confirmez où la boîte a été placée. Comme les nombres sont en pixels, vous avez besoin de la taille de l’image ou de la page avant de choisir un rectangle.

Comment obtenir les coordonnées ?

Commencez par la taille de la page. get_document_info renvoie le type de fichier, le nombre de pages et la largeur et hauteur par page, ce qui transforme « le tiers inférieur » en nombres réels.

Quelle est la taille de scan.png ?

Ensuite, donnez la région à l’agent :

Couvrir le tiers inférieur de scan.png avec une boîte noire.

Pour un élément spécifique comme une signature ou un visage, vous avez besoin de sa position. Deux approches pratiques fonctionnent. Ouvrez la page dans n’importe quel visualiseur et lisez vous-même les coordonnées. Ou laissez l’agent rendre la page avec un serveur qui renvoie des images de page : l’outil render_page de GroupDocs.Viewer.Mcp rend une page unique en PNG et la renvoie en ligne, et le serveur GroupDocs.Annotation.Mcp peut renvoyer des aperçus de page (son outil d’aperçu échoue actuellement pour les fichiers PDF sous Linux et dans Docker ; les documents Word et autres Office sont rendus, et sous Windows avec dnx chaque format est rendu). Un modèle capable de vision peut alors estimer le rectangle, et vous le confirmez avant que la redaction ne s’exécute.

Et les documents qui sont moitié texte, moitié numérisation ?

Un contrat né‑numérique avec une page de signature numérisée nécessite les deux outils, et redact_image_area ne peut pas être ciblé sur une seule page via un argument. Gardez les parties séparées : masquez le texte d’abord, et traitez les pages numérisées comme des images qui reçoivent leur propre redaction par zone.

Masquez les adresses e‑mail dans contract.docx, puis dites‑moi quel fichier enregistré je devrais utiliser pour l’étape suivante.

Ensuite, vérifiez chaque page du résultat final à l’œil.

À quoi ressemble un flux de travail typique de numérisation ?

L’ordre qui fonctionne est : lire la taille de la page, décider de la région, la couvrir, puis examiner le résultat. Si la région n’est pas évidente, rendez d’abord la page et laissez un modèle capable de vision proposer un rectangle. Conservez la proposition et les coordonnées finales dans la transcription afin que toute personne examinant le dossier puisse voir ce qui a été couvert et pourquoi. La redaction par région est volontairement brutale : elle couvre un rectangle et rien d’autre.

Ce serveur lit‑il le texte dans les images (OCR) ?

Non. GroupDocs.Redaction.Mcp masque ; il ne reconnaît pas le texte dans les images. Cela rend le comportement prévisible, car aucun seuil de confiance ne décide silencieusement qu’un nom flou n’est pas un nom. Si votre flux de travail nécessite le texte des numérisations, extrayez‑le d’abord avec un outil conçu à cet effet, décidez ce qui est sensible, puis masquez par zone. Le serveur ne peut pas vous indiquer où se trouve un nom dans une image.

Exemple de session (abrégé)

You:    How big is scan.png?
Agent:  -> get_document_info(file: scan.png)
        The image is 1200 x 1600 pixels.
You:    Cover the bottom third of scan.png with a black box.
Agent:  -> redact_image_area(file: scan.png, x: 0, y: 1067, width: 1200, height: 533, color: Black)
        Saved the output file. Please open it and check that the box covers the area.

Comment vérifier une redaction par zone ?

Examinez chaque page du résultat, pas seulement celle que vous avez ciblée. Une redaction par zone qui manque de 20 pixels est une redaction qui a échoué, et aucun texte de réponse ne vous le dira. C’est le seul cas où la vérification ne peut pas être automatisée en relançant un motif : la vérification repose sur vos yeux, ou sur un aperçu rendu que l’agent peut voir. La vérification est traitée dans son propre article, Ne faites confiance à aucune redaction que vous n’avez pas vérifiée.

Quelles sont les limites du mode d’évaluation ?

Sans licence, le serveur autorise un document par processus et une redaction, limitées à 4 remplacements, plus des badges d’essai. Pour les numérisations, cela signifie une boîte : une page qui nécessite trois régions couvertes n’en obtient qu’une, et semble tout de même traitée. Exécutez d’abord get_license_status. La limite sert à tester les outils, pas à un travail réel.

  • PDF sur Linux. Sous Linux, y compris l’image Docker, redact_image_area et erase_metadata échouent actuellement sur les fichiers PDF (la gestion des images du moteur PDF dépend de System.Drawing, que .NET ne supporte que sous Windows) ; les deux fonctionnent sur les documents Word, et redact_text fonctionne sur les PDF. Exécutez la redaction de zone PDF et l’effacement des métadonnées sous Windows avec dnx.

FAQ

Un agent IA peut‑il masquer (redacter) un document numérisé ? Oui, par zone. Il couvre un rectangle que vous définissez avec redact_image_area, car il n’y a pas de texte pour la recherche de motifs.

Claude peut‑il supprimer une signature d’une image numérisée ? Claude peut piloter la redaction une fois la position de la signature connue, à partir d’un visualiseur ou d’un aperçu de page rendu. Le serveur couvre alors ce rectangle avec une boîte solide.

Comment puis‑je noircir automatiquement une région dans une numérisation ou une image ? Donnez le fichier et le rectangle à l’agent, et il appelle redact_image_area. L’outil n’a pas d’argument de page, donc vérifiez chaque page du résultat à l’œil.

Pourquoi la redaction de texte ne change‑t‑elle rien sur ma numérisation ? La numérisation ou l’image contient des pixels, pas du texte, il n’y a donc rien à remplacer. Utilisez la redaction par zone, et vérifiez le résultat à l’œil.

Aller plus loin