Wenn Sie einen KI‑Agenten bitten, eine gescannte Seite zu redigieren, und die Textredaktion nichts zum Ersetzen findet, ist die Seite nicht sauber, sie hat keine Textebene zum Durchsuchen. Um einen Scan lokal zu redigieren, deckt der Agent einen Bereich anhand von Koordinaten mit redact_image_area ab, anstatt Wörter zu matchen. Mit GroupDocs.Redaction.Mcp, das mit Claude Desktop oder Cursor verbunden ist, sieht die Anfrage so aus:

Decken Sie das untere Drittel von scan.png mit einer schwarzen Box ab.

Die schrittweise Version mit Konfiguration und Fehlersuche finden Sie in der Dokumentation: How to redact scanned documents and images with an AI agent.

Warum findet die Textredaktion bei einem Scan nichts?

Ein Scan ist ein Bild eines Dokuments. Die Wörter darauf sind Pixel, sodass ein regulärer Ausdruck nichts zum Abgleichen hat. redact_text findet auf einer gescannten Seite nichts zum Ersetzen, und nichts zu finden ist nicht dasselbe wie nichts Sensibles. Behandeln Sie ein leeres Ergebnis bei einer rein bildbasierten Datei als „keine Textebene“ und wechseln Sie dann das Werkzeug. Das Gleiche gilt für Fotografien, Stempel und eine gescannte Unterschriftsseite am Ende eines ansonsten digitalen Vertrags.

Welches Werkzeug deckt einen Bereich einer Seite ab?

redact_image_area deckt ein Rechteck einer Seite mit einer einfarbigen Box ab und verbirgt dauerhaft den darunter liegenden Bildinhalt, wie Gesichter, Unterschriften und Stempel. Es nimmt x, y, width und height in Pixeln, gemessen vom oberen linken Eck der Seite, sowie ein optionales color (Standard Schwarz oder ein Hex‑Wert wie #FF0000). Das Werkzeug hat kein Seiten‑Argument, nur die Datei und das Rechteck, also öffnen Sie die Ausgabe und prüfen Sie, wo die Box gelandet ist. Da die Zahlen in Pixeln angegeben werden, benötigen Sie die Bild‑ oder Seitengröße, bevor Sie ein Rechteck wählen.

Wie erhalten Sie die Koordinaten?

Beginnen Sie mit der Seitengröße. get_document_info liefert den Dateityp, die Seitenzahl sowie Breite und Höhe pro Seite, wodurch „das untere Drittel“ in reale Zahlen umgewandelt wird.

Wie groß ist scan.png?

Dann geben Sie dem Agenten den Bereich an:

Decken Sie das untere Drittel von scan.png mit einer schwarzen Box ab.

Für ein konkretes Element wie eine Unterschrift oder ein Gesicht benötigen Sie dessen Position. Zwei praktische Wege funktionieren: Öffnen Sie die Seite in einem beliebigen Viewer und lesen Sie die Koordinaten selbst. Oder lassen Sie den Agenten die Seite mit einem Server rendern, der Seitenbilder zurückgibt: Das GroupDocs.Viewer.Mcp‑Werkzeug render_page rendert eine einzelne Seite als PNG und gibt sie inline zurück, und der GroupDocs.Annotation.Mcp‑Server kann Seitenvorschauen zurückliefern (sein Vorschau‑Werkzeug schlägt derzeit bei PDF‑Dateien unter Linux und in Docker fehl; Word‑ und andere Office‑Dokumente werden gerendert, und unter Windows mit dnx wird jedes Format gerendert). Ein vision‑fähiges Modell kann dann die Box schätzen, und Sie bestätigen sie, bevor die Redaktion ausgeführt wird.

Was ist mit Dokumenten, die halb Text, halb Scan sind?

Ein born‑digitaler Vertrag mit einer gescannten Unterschriftsseite benötigt beide Werkzeuge, und redact_image_area kann nicht per Argument auf eine einzelne Seite zielen. Halten Sie die Teile getrennt: Redigieren Sie zuerst den Text und behandeln Sie die gescannten Seiten als Bilder, die ihre eigene Flächenredaktion erhalten.

Redigieren Sie die E‑Mail‑Adressen in contract.docx, und sagen Sie mir dann, welche gespeicherte Datei ich für den nächsten Schritt verwenden soll.

Überprüfen Sie anschließend jede Seite der endgültigen Ausgabe visuell.

Wie sieht ein typischer Scan‑Workflow aus?

Die funktionierende Reihenfolge ist: Seitengröße lesen, Bereich festlegen, abdecken, dann das Ergebnis ansehen. Wenn der Bereich nicht offensichtlich ist, rendern Sie zuerst die Seite und lassen ein vision‑fähiges Modell eine Box vorschlagen. Bewahren Sie den Vorschlag und die endgültigen Koordinaten im Transkript auf, damit jeder, der die Akte prüft, sehen kann, was abgedeckt wurde und warum. Das Redigieren nach Fläche ist bewusst grob: Es deckt ein Rechteck und nichts anderes ab.

Liest dieser Server Text in Bildern (OCR)?

Nein. GroupDocs.Redaction.Mcp redigiert; es erkennt keinen Text in Bildern. Das sorgt für vorhersehbares Verhalten, weil kein Vertrauens‑Schwellenwert stillschweigend entscheidet, dass ein verschwommener Name kein Name war. Wenn Ihr Workflow den Text aus Scans benötigt, extrahieren Sie ihn zuerst mit einem dafür vorgesehenen Werkzeug, bestimmen Sie, was sensibel ist, und redigieren Sie dann nach Fläche. Der Server kann Ihnen nicht sagen, wo ein Name im Bild sitzt.

Beispielsession (gekürzt)

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.

Wie prüfen Sie eine Flächenredaktion?

Betrachten Sie jede Seite der Ausgabe, nicht nur die, die Sie gezielt haben. Eine Flächenredaktion, die um 20 Pixel zu kurz ist, ist eine fehlgeschlagene Redaktion, und kein Antworttext wird Sie darauf hinweisen. Dies ist der eine Fall, in dem die Verifizierung nicht automatisiert werden kann, indem ein Muster erneut ausgeführt wird: Die Prüfung erfolgt mit Ihren Augen oder einer gerenderten Vorschau, die der Agent sehen kann. Die Verifizierung wird in einem eigenen Beitrag behandelt, Trust no redaction you haven’t verified.

Was sind die Grenzen des Evaluationsmodus?

Ohne Lizenz erlaubt der Server ein Dokument pro Prozess und eine Redaktion, begrenzt auf 4 Ersetzungen, plus Test‑Badges. Für Scans bedeutet das eine Box: Eine Seite, die drei abgedeckte Regionen benötigt, bekommt nur eine, und sieht trotzdem verarbeitet aus. Führen Sie zuerst get_license_status aus. Die Begrenzung dient dem Ausprobieren der Werkzeuge, nicht für die reale Arbeit.

  • PDF on Linux. Unter Linux, einschließlich des Docker‑Images, schlagen redact_image_area und erase_metadata derzeit bei PDF‑Dateien fehl (die Bildverarbeitung des PDF‑Engines hängt von System.Drawing ab, das .NET nur unter Windows unterstützt); beide funktionieren bei Word‑Dokumenten, und redact_text funktioniert bei PDF. Führen Sie PDF‑Flächenredaktion und Metadaten‑Löschung unter Windows mit dnx aus.

FAQ

Kann ein KI‑Agent ein gescanntes Dokument redigieren? Ja, nach Fläche. Er deckt ein von Ihnen definiertes Rechteck mit redact_image_area ab, weil kein Text für ein Muster‑Matching vorhanden ist.

Kann Claude eine Unterschrift aus einem gescannten Bild entfernen? Claude kann die Redaktion steuern, sobald die Position der Unterschrift bekannt ist, sei es aus einem Viewer oder einer gerenderten Seitenvorschau. Der Server deckt dann dieses Rechteck mit einer einfarbigen Box ab.

Wie kann ich einen Bereich in einem Scan oder Bild automatisch schwärzen? Geben Sie dem Agenten die Datei und das Rechteck, und er ruft redact_image_area auf. Das Werkzeug hat kein Seiten‑Argument, also prüfen Sie jede Seite des Ergebnisses visuell.

Warum ändert die Textredaktion nichts an meinem Scan? Der Scan bzw. das Bild besteht aus Pixeln, nicht aus Text, sodass es nichts zu ersetzen gibt. Verwenden Sie Flächenredaktion und prüfen Sie das Ergebnis visuell.

Weiterführende Informationen