Wanneer je een AI‑agent vraagt een gescande pagina te redigeren en tekstredactie niets vindt om te vervangen, is de pagina niet schoon, hij heeft geen tekstlaag om te doorzoeken. Om een scan lokaal te redigeren, bedekt de agent een gebied via coördinaten met redact_image_area in plaats van woorden te matchen. Met GroupDocs.Redaction.Mcp verbonden met Claude Desktop of Cursor ziet het verzoek er als volgt uit:

Bedek het onderste derde deel van scan.png met een zwart vak.

De stap‑voor‑stap versie met configuratie en probleemoplossing staat in de documentatie: Hoe gescande documenten en afbeeldingen te redigeren met een AI‑agent.

Waarom vindt tekstredactie niets op een scan?

Een scan is een afbeelding van een document. De woorden erop zijn pixels, dus een reguliere expressie heeft niets om te matchen. redact_text vindt niets om te vervangen op een gescande pagina, en niets vinden is niet hetzelfde als niets gevoelig. Beschouw een leeg resultaat op een alleen‑afbeeldingsbestand als “geen tekstlaag”, en schakel dan van tool. Hetzelfde geldt voor foto’s, stempels en een gescande handtekeningpagina aan de achterkant van een verder digitaal contract.

Welke tool bedekt een gebied van een pagina?

redact_image_area bedekt een rechthoek van een pagina met een effen gekleurde doos en verbergt permanent de afbeelding eronder, zoals gezichten, handtekeningen en stempels. Het neemt x, y, width en height in pixels, gemeten vanaf de linkerbovenhoek van de pagina, en een optionele color (standaard Zwart, of een hex‑waarde zoals #FF0000). De tool heeft geen paginaparameter, alleen het bestand en de rechthoek, dus open de output en bevestig waar de doos is geplaatst. Omdat de getallen pixels zijn, heb je de afbeelding‑ of paginagrootte nodig voordat je een rechthoek kiest.

Hoe krijg je de coördinaten?

Begin met de paginagrootte. get_document_info geeft het bestandstype, het aantal pagina’s en de breedte en hoogte per pagina terug, waardoor “het onderste derde deel” in echte getallen wordt omgezet.

Hoe groot is scan.png?

Geef vervolgens de agent het gebied:

Bedek het onderste derde deel van scan.png met een zwart vak.

Voor een specifiek element zoals een handtekening of een gezicht heb je de positie nodig. Twee praktische routes werken. Open de pagina in een viewer en lees zelf de coördinaten. Of laat de agent de pagina renderen met een server die paginabeelden teruggeeft: de GroupDocs.Viewer.Mcp render_page tool rendert een enkele pagina als PNG en retourneert deze inline, en de GroupDocs.Annotation.Mcp server kan paginavoorbeelden teruggeven (zijn preview‑tool faalt momenteel voor PDF‑bestanden op Linux en in Docker; Word‑ en andere Office‑documenten renderen, en op Windows met dnx rendert elk formaat). Een vision‑capable model kan dan de doos schatten, en jij bevestigt deze voordat de redactie wordt uitgevoerd.

Wat te doen met documenten die half tekst, half scan zijn?

Een digitaal contract met een gescande handtekeningpagina heeft beide tools nodig, en redact_image_area kan niet op één pagina worden gericht via een argument. Houd de delen gescheiden: redigeer eerst de tekst, en behandel de gescande pagina’s als afbeeldingen die hun eigen gebiedsredactie krijgen.

Redigeer de e‑mailadressen in contract.docx, en vertel me vervolgens welk opgeslagen bestand ik moet gebruiken voor de volgende stap.

Controleer vervolgens elke pagina van de uiteindelijke output met het blote oog.

Hoe ziet een typische scan‑workflow eruit?

De volgorde die werkt is: lees de paginagrootte, bepaal het gebied, bedek het, en bekijk vervolgens het resultaat. Als het gebied niet duidelijk is, render de pagina eerst en laat een vision‑capable model een doos voorstellen. Bewaar het voorstel en de uiteindelijke coördinaten in het transcript zodat iedereen die het dossier beoordeelt kan zien wat er bedekt is en waarom. Redigeren per gebied is opzettelijk grof: het bedekt een rechthoek en niets anders.

Leest deze server tekst in afbeeldingen (OCR)?

Nee. GroupDocs.Redaction.Mcp redigeert; het herkent geen tekst in afbeeldingen. Dat houdt het gedrag voorspelbaar, omdat er geen vertrouwensdrempel stilletjes beslist dat een vage naam geen naam was. Als je workflow de tekst uit scans nodig heeft, extraheer deze eerst met een daarvoor gebouwde tool, bepaal wat gevoelig is, en redigeer vervolgens per gebied. De server kan je niet vertellen waar een naam zich in een afbeelding bevindt.

Voorbeeldsessie (verkort)

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.

Hoe controleer je een gebiedsredactie?

Bekijk elke pagina van de output, niet alleen diegene waarop je je richtte. Een gebiedsredactie die 20 pixels te kort is, is een mislukte redactie, en er zal geen respons‑tekst zijn die je dat vertelt. Dit is het ene geval waarin verificatie niet geautomatiseerd kan worden door een patroon opnieuw uit te voeren: de controle is je ogen, of een gerenderde preview die de agent kan zien. Verificatie wordt behandeld in een eigen bericht, Vertrouw geen redactie die je niet hebt geverifieerd.

Wat zijn de limieten van de evaluatiemodus?

Zonder licentie staat de server één document per proces en één redactie toe, beperkt tot 4 vervangingen, plus proef‑badges. Voor scans betekent dat één vak: een pagina die drie te bedekken gebieden nodig heeft, krijgt er één, en ziet er nog steeds bewerkt uit. Voer eerst get_license_status uit. De limiet is bedoeld om de tools uit te proberen, niet voor echt werk.

  • PDF op Linux. Op Linux, inclusief de Docker‑image, falen redact_image_area en erase_metadata momenteel op PDF‑bestanden (de beeldverwerking van de PDF‑engine hangt af van System.Drawing, dat .NET alleen op Windows ondersteunt); beide werken op Word‑documenten, en redact_text werkt op PDF. Voer PDF‑gebiedsredactie en metadata‑verwijdering uit op Windows met dnx.

FAQ

Kan een AI‑agent een gescand document redigeren? Ja, per gebied. Het bedekt een rechthoek die je definieert met redact_image_area, omdat er geen tekst is voor patroonmatching.

Kan Claude een handtekening van een gescande afbeelding verwijderen? Claude kan de redactie uitvoeren zodra de positie van de handtekening bekend is, vanuit een viewer of een gerenderde paginavoorbeeld. De server bedekt vervolgens die rechthoek met een effen doos.

Hoe maak ik automatisch een gebied in een scan of afbeelding zwart? Geef de agent het bestand en de rechthoek, en hij roept redact_image_area aan. De tool heeft geen paginaparameter, dus controleer elke pagina van het resultaat met het blote oog.

Waarom verandert tekstredactie niets aan mijn scan? De scan of afbeelding bevat pixels, geen tekst, dus er is niets om te vervangen. Gebruik gebiedsredactie, en controleer het resultaat met het blote oog.

Ga dieper