Quando chiedi a un agente IA di redigere una pagina scansionata e la redazione del testo non trova nulla da sostituire, la pagina non è pulita, non ha uno strato di testo da cercare. Per redigere una scansione localmente, l’agente copre una regione tramite coordinate con redact_image_area invece di cercare parole corrispondenti. Con GroupDocs.Redaction.Mcp collegato a Claude Desktop o Cursor, la richiesta appare così:

Copri il terzo inferiore di scan.png con una casella nera.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come redigere documenti e immagini scansionati con un agente IA.

Perché la redazione del testo non trova nulla su una scansione?

Una scansione è un’immagine di un documento. Le parole su di essa sono pixel, quindi un’espressione regolare non ha nulla da corrispondere. redact_text non trova nulla da sostituire su una pagina scansionata, e non trovare nulla non è lo stesso di non esserci dati sensibili. Tratta un risultato vuoto su un file solo immagine come “nessuno strato di testo”, quindi passa a un altro strumento. Lo stesso vale per fotografie, timbri e una pagina di firma scansionata sul retro di un contratto altrimenti digitale.

Quale strumento copre una regione di una pagina?

redact_image_area copre un rettangolo di una pagina con una casella a tinta unita e nasconde permanentemente il contenuto dell’immagine sottostante, come volti, firme e timbri. Accetta x, y, width e height in pixel, misurati dall’angolo in alto a sinistra della pagina, e un color opzionale (predefinito Black, o un valore esadecimale come #FF0000). Lo strumento non richiede un argomento di pagina, solo il file e il rettangolo, quindi apri l’output e conferma dove è atterrata la casella. Poiché i numeri sono pixel, hai bisogno delle dimensioni dell’immagine o della pagina prima di scegliere un rettangolo.

Come ottieni le coordinate?

Inizia con le dimensioni della pagina. get_document_info restituisce il tipo di file, il conteggio delle pagine e la larghezza e altezza per pagina, trasformando “il terzo inferiore” in numeri reali.

Quanto è grande scan.png?

Poi fornisci all’agente la regione:

Copri il terzo inferiore di scan.png con una casella nera.

Per un elemento specifico come una firma o un volto, ti serve la sua posizione. Due percorsi pratici funzionano. Apri la pagina in qualsiasi visualizzatore e leggi le coordinate tu stesso. Oppure lascia che l’agente renderizzi la pagina con un server che restituisce immagini della pagina: lo strumento render_page di GroupDocs.Viewer.Mcp renderizza una singola pagina come PNG e la restituisce inline, e il server GroupDocs.Annotation.Mcp può restituire anteprime delle pagine (il suo strumento di anteprima attualmente fallisce per file PDF su Linux e in Docker; i documenti Word e altri Office vengono renderizzati, e su Windows con dnx ogni formato viene renderizzato). Un modello con capacità visiva può quindi stimare la casella, e tu la confermi prima che la redazione venga eseguita.

E i documenti che sono metà testo, metà scansione?

Un contratto nato digitale con una pagina di firma scansionata richiede entrambi gli strumenti, e redact_image_area non può essere indirizzato a una sola pagina tramite un argomento. Mantieni le parti separate: redigi prima il testo, e tratta le pagine scansionate come immagini che ricevono la propria redazione per area.

Redigi gli indirizzi email in contract.docx, poi dimmi quale file salvato devo usare per il passo successivo.

Poi controlla ogni pagina dell’output finale a occhio.

Come appare un tipico flusso di lavoro per le scansioni?

L’ordine che funziona è: leggi le dimensioni della pagina, decidi la regione, coprila, poi guarda il risultato. Se la regione non è ovvia, renderizza prima la pagina e lascia che un modello con capacità visiva proponga una casella. Conserva la proposta e le coordinate finali nella trascrizione così chiunque riveda il fascicolo può vedere cosa è stato coperto e perché. La redazione per area è intenzionalmente grossolana: copre un rettangolo e nient’altro.

Questo server legge il testo nelle immagini (OCR)?

No. GroupDocs.Redaction.Mcp redige; non riconosce il testo nelle immagini. Questo mantiene il comportamento prevedibile, perché nessuna soglia di confidenza decide silenziosamente che un nome sfocato non fosse un nome. Se il tuo flusso di lavoro necessita del testo dalle scansioni, estrailo prima con uno strumento costruito per questo, decidi cosa è sensibile, poi redigi per area. Il server non può dirti dove si trova un nome in un’immagine.

Example session (abridged)

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.

Come controlli una redazione per area?

Guarda ogni pagina dell’output, non solo quella su cui hai puntato. Una redazione per area che è corta di 20 pixel è una redazione fallita, e nessun testo di risposta te lo dirà. Questo è l’unico caso in cui la verifica non può essere automatizzata rieseguendo un modello: il controllo è con i tuoi occhi, o con un’anteprima renderizzata che l’agente può vedere. La verifica è trattata in un post dedicato, Non fidarti di una redazione che non hai verificato.

Quali sono i limiti della modalità di valutazione?

Senza licenza il server consente un documento per processo e una redazione, limitata a 4 sostituzioni, più badge di prova. Per le scansioni ciò significa una casella: una pagina che necessita di tre regioni coperte ne ottiene una, e sembra comunque processata. Esegui prima get_license_status. Il limite è per provare gli strumenti, non per lavoro reale.

  • PDF su Linux. Su Linux, inclusa l’immagine Docker, redact_image_area e erase_metadata attualmente falliscono sui file PDF (la gestione delle immagini del motore PDF dipende da System.Drawing, che .NET supporta solo su Windows); entrambi funzionano sui documenti Word, e redact_text funziona su PDF. Esegui la redazione per area PDF e la cancellazione dei metadati su Windows con dnx.

FAQ

Un agente IA può redigere un documento scansionato? Sì, per area. Copre un rettangolo che definisci con redact_image_area, perché non c’è testo per il matching di pattern.

Claude può rimuovere una firma da un’immagine scansionata? Claude può guidare la redazione una volta che la posizione della firma è nota, da un visualizzatore o da un’anteprima della pagina renderizzata. Il server quindi copre quel rettangolo con una casella solida.

Come posso oscurare automaticamente una regione in una scansione o immagine? Fornisci all’agente il file e il rettangolo, e lui chiama redact_image_area. Lo strumento non ha argomento di pagina, quindi controlla ogni pagina del risultato a occhio.

Perché la redazione del testo non cambia nulla sulla mia scansione? La scansione o immagine contiene pixel, non testo, quindi non c’è nulla da sostituire. Usa la redazione per area e controlla il risultato a occhio.

Approfondisci