Cuando le pides a un agente de IA que redacte una página escaneada y la redacción de texto no encuentra nada que reemplazar, la página no está limpia, no tiene capa de texto para buscar. Para redactar un escaneo localmente, el agente cubre una región por coordenadas con redact_image_area en lugar de coincidir palabras. Con GroupDocs.Redaction.Mcp conectado a Claude Desktop o Cursor, la solicitud se ve así:

Cubrir el tercio inferior de scan.png con una caja negra.

La versión paso a paso con configuración y solución de problemas está en la documentación: How to redact scanned documents and images with an AI agent.

¿Por qué la redacción de texto no encuentra nada en un escaneo?

Un escaneo es una foto de un documento. Las palabras son píxeles, por lo que una expresión regular no tiene nada que coincidir. redact_text no encuentra nada que reemplazar en una página escaneada, y no encontrar nada no es lo mismo que no haber información sensible. Trata un resultado vacío en un archivo solo de imagen como “sin capa de texto”, y luego cambia de herramienta. Lo mismo ocurre con fotografías, sellos y una página de firma escaneada al final de un contrato que de otro modo es digital.

¿Qué herramienta cubre una región de una página?

redact_image_area cubre un rectángulo de una página con una caja de color sólido y oculta permanentemente el contenido de la imagen debajo, como caras, firmas y sellos. Toma x, y, width y height en píxeles, medidos desde la esquina superior izquierda de la página, y un color opcional (por defecto Negro, o un valor hexadecimal como #FF0000). La herramienta no recibe un argumento de página, solo el archivo y el rectángulo, así que abre el resultado y confirma dónde quedó la caja. Como los números son píxeles, necesitas el tamaño de la imagen o página antes de elegir un rectángulo.

¿Cómo obtener las coordenadas?

Comienza con el tamaño de la página. get_document_info devuelve el tipo de archivo, el número de páginas y el ancho y alto por página, lo que convierte “el tercio inferior” en números reales.

¿Qué tamaño tiene scan.png?

Luego indica la región al agente:

Cubrir el tercio inferior de scan.png con una caja negra.

Para un elemento específico como una firma o una cara, necesitas su posición. Funcionan dos rutas prácticas. Abre la página en cualquier visor y lee las coordenadas tú mismo. O deja que el agente renderice la página con un servidor que devuelva imágenes de página: la herramienta render_page de GroupDocs.Viewer.Mcp genera una sola página como PNG y la devuelve en línea, y el servidor GroupDocs.Annotation.Mcp puede devolver vistas previas de página (su herramienta de vista previa actualmente falla para archivos PDF en Linux y en Docker; los documentos Word y otros de Office se renderizan, y en Windows con dnx se renderiza cualquier formato). Un modelo con capacidad de visión puede entonces estimar la caja, y tú la confirmas antes de que se ejecute la redacción.

¿Qué pasa con documentos que son mitad texto, mitad escaneo?

Un contrato nacido digitalmente con una página de firma escaneada necesita ambas herramientas, y redact_image_area no puede dirigirse a una sola página mediante un argumento. Mantén las piezas separadas: redacta el texto primero, y trata las páginas escaneadas como imágenes que reciben su propia redacción por área.

Redacta las direcciones de correo electrónico en contract.docx, luego dime qué archivo guardado debo usar para el siguiente paso.

Luego revisa cada página del resultado final a simple vista.

¿Cómo es un flujo de trabajo típico de escaneo?

El orden que funciona es: leer el tamaño de la página, decidir la región, cubrirla, y luego observar el resultado. Si la región no es obvia, renderiza la página primero y deja que un modelo con capacidad de visión proponga una caja. Mantén la propuesta y las coordenadas finales en la transcripción para que cualquiera que revise el caso pueda ver qué se cubrió y por qué. Redactar por región es deliberadamente brusco: cubre un rectángulo y nada más.

¿Este servidor lee texto en imágenes (OCR)?

No. GroupDocs.Redaction.Mcp redacta; no reconoce texto en imágenes. Eso mantiene el comportamiento predecible, porque no hay un umbral de confianza que silenciosamente decida que un nombre borroso no era un nombre. Si tu flujo de trabajo necesita extraer texto de escaneos, extráelo primero con una herramienta diseñada para eso, decide qué es sensible y luego redacta por área. El servidor no puede decirte dónde se encuentra un nombre en una foto.

Sesión de ejemplo (abreviada)

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.

¿Cómo comprobar una redacción por área?

Revisa cada página del resultado, no solo la que apuntaste. Una redacción por área que quede 20 píxeles corta es una redacción fallida, y ningún texto de respuesta te lo dirá. Este es el caso en que la verificación no puede automatizarse reejecutando un patrón: la revisión la hacen tus ojos, o una vista previa renderizada que el agente pueda ver. La verificación se trata en su propia publicación, Trust no redaction you haven’t verified.

¿Cuáles son los límites del modo de evaluación?

Sin una licencia, el servidor permite un documento por proceso y una redacción, con un máximo de 4 reemplazos, más insignias de prueba. Para escaneos eso significa una caja: una página que necesita tres regiones cubiertas obtiene solo una, y aún parece procesada. Ejecuta get_license_status primero. El límite es para probar las herramientas, no para trabajo real.

  • PDF en Linux. En Linux, incluida la imagen Docker, redact_image_area y erase_metadata actualmente fallan con archivos PDF (el manejo de imágenes del motor PDF depende de System.Drawing, que .NET solo soporta en Windows); ambas funcionan con documentos Word, y redact_text funciona con PDF. Ejecuta la redacción de área y borrado de metadatos en PDF en Windows con dnx.

Preguntas frecuentes

¿Puede un agente de IA redactar un documento escaneado? Sí, por área. Cubre un rectángulo que defines con redact_image_area, porque no hay texto para que una coincidencia de patrón lo encuentre.

¿Puede Claude eliminar una firma de una imagen escaneada? Claude puede ejecutar la redacción una vez que se conoce la posición de la firma, ya sea desde un visor o una vista previa renderizada. El servidor entonces cubre ese rectángulo con una caja sólida.

¿Cómo oscurezco automáticamente una región en un escaneo o imagen? Proporciona al agente el archivo y el rectángulo, y él llama a redact_image_area. La herramienta no tiene argumento de página, así que revisa cada página del resultado a simple vista.

¿Por qué la redacción de texto no cambia nada en mi escaneo? El escaneo o imagen contiene píxeles, no texto, por lo que no hay nada que reemplazar. Usa la redacción por área y verifica el resultado a simple vista.

Profundiza más