Redlining DOCX con agentes IA en n8n

Adeu es una librería open-source que convierte archivos DOCX a Markdown comprimido y revierte los cambios del agente IA como Track Changes nativos de Word, preservando el formato original. El paquete n8n-nodes-adeu encapsula esa lógica como nodo personalizado en n8n, permitiendo armar workflows de redlining documentos IA n8n agentes con orquestación visual y sin tocar código Python directamente.

En 30 segundos

  • Adeu traduce DOCX ↔ Markdown para que los LLMs editen documentos sin destruir el XML interno de Word
  • n8n-nodes-adeu es un nodo personalizado que conecta esa capacidad con flujos visuales en n8n, sin servidor intermedio
  • Los agentes pueden operar en múltiples turnos: leen el documento, proponen cambios, ven sus propias ediciones y refinan en ronda 2 o 3
  • Los cambios se reintegran como w:ins y w:del, el formato nativo de Track Changes de Word — el usuario los acepta o rechaza desde la UI de siempre
  • Microsoft lanzó en abril de 2026 su propio Legal Agent for Word con arquitectura similar (DOCX→Markdown→Track Changes), lo que valida el enfoque técnico de Adeu

Qué es Adeu: el motor de redlining DOCX nativo para IA

Adeu es una librería desarrollada por el equipo de dealfluence que resuelve un problema concreto: los LLMs no saben leer DOCX. Cuando un agente recibe un archivo Word, lo que ve es un XML con decenas de miles de caracteres de estructura, namespaces, propiedades de párrafo y metadatos de revisión entremezclados con el texto real. Pasarle eso a Claude o GPT-4o es malgastar tokens y arriesgarse a que el modelo devuelva algo que corrompe el formato al reescribir.

Adeu resuelve el problema en dos pasos. Primero, convierte el DOCX a Markdown comprimido: solo el texto y estructura visible, sin basura XML. Segundo, toma los cambios que el agente propone y los reinyecta en el DOCX original como w:ins (inserción) y w:del (borrado), que son exactamente los elementos que Word usa para Track Changes. El documento resultante abre en Word sin problemas: podés aceptar, rechazar y ver el historial de cambios igual que si lo hubiera revisado un humano.

La arquitectura es Python + Node.js, y el repositorio en GitHub incluye también un servidor MCP compatible con Claude Desktop y herramientas similares.

n8n-nodes-adeu: redlining documentos IA n8n agentes con orquestación visual

Ponele que ya tenés Adeu instalado y funciona desde Python. El problema es que no podés meterlo en un flujo de automatización sin escribir glue code. Ahí entra n8n-nodes-adeu.

El paquete registra un nodo personalizado en n8n que expone las operaciones de Adeu como acciones del canvas visual: leer un DOCX y obtener Markdown, aplicar cambios de un agente y devolver el archivo modificado. En lugar de script ad hoc, armás el flujo completo con nodos conectados: trigger por email con adjunto DOCX → nodo Adeu (parse) → nodo AI Agent con Claude → nodo Adeu (apply changes) → envío del archivo revisado.

Esto tiene tres ventajas que no son menores. Primero, la orquestación es visual y auditable: cualquier persona del equipo puede ver el flujo, incluso sin saber programar. Segundo, n8n maneja reintentos, logging y gestión de errores de forma nativa. Tercero, podés encadenar múltiples agentes, agregar un paso de validación humana con un nodo de espera, o bifurcar el flujo según el resultado del análisis.

Workflows agenticos multi-turno en documentos

La parte que más me parece interesante del enfoque es la iteración multi-turno. La mayoría de los casos de edición con IA funcionan así: mandás el documento, el modelo devuelve una versión modificada, terminó. Funciona para cambios simples, pero si necesitás que el agente revise un contrato identificando cláusulas problemáticas, proponga alternativas, evalúe el impacto de cada cambio en el contexto del documento completo y luego refine sus propias sugerencias, un solo turno no alcanza. Te puede servir nuestra cobertura de mantener seguras tus integraciones empresariales.

Con n8n-nodes-adeu podés construir un ciclo iterativo donde el agente lee el documento en Markdown comprimido (turno 1), propone cambios iniciales, aplica esos cambios con Adeu, luego en el turno 2 lee el documento ya editado para ver qué modificó y refina su propuesta. Cada turno se graba como revisión separada en el historial de Track Changes: podés ver exactamente qué sugirió el agente en la ronda 1 versus qué ajustó en la ronda 2.

¿Y qué ganás con eso en la práctica? Ediciones de mayor calidad y un rastro de auditoría completo que muestra el proceso, no solo el resultado final.

Preservación nativa de formato: Track Changes y Comments

Este es el detalle técnico que más importa para adopción real. No alcanza con que el agente edite bien el texto si el documento resultante no abre en Word o pierde el formato.

Adeu reinyecta los cambios usando la especificación OOXML de Microsoft: w:ins para texto agregado, w:del + w:delText para texto eliminado, y w:comment para comentarios. Estos son los mismos elementos que Word genera cuando un humano usa Track Changes manualmente. El archivo resultante es un DOCX válido que cualquier versión de Word o Google Docs abre sin advertencias.

El usuario recibe el archivo, lo abre, ve los cambios subrayados en rojo como siempre, y decide qué cambios acepta. Sin conversiones a PDF. Sin pasos intermedios. Sin archivos corruptos (spoiler: eso era el problema con los primeros intentos de edición DOCX con LLMs directamente). Ya lo cubrimos antes en cómo ChatGPT potencia tus workflows.

Crear un nodo personalizado n8n para Adeu: guía práctica

Si querés instalar n8n-nodes-adeu en tu instancia, el proceso es estándar para nodos personalizados de n8n.

Estructura básica del nodo

El nodo hereda de la clase base INodeType de n8n e implementa dos métodos principales: getNodeDescription(), que define los campos del canvas, y execute(), que corre la lógica. Dentro de execute() vas a hacer tres cosas: leer el binario del DOCX del input, llamar a la API de Adeu (local o en endpoint) para convertir a Markdown o para aplicar cambios, y devolver el binario modificado como resultado.

Instalación en tu instancia n8n

Copiás el paquete a ~/.n8n/custom/ o lo instalás vía npm si tu instancia tiene acceso. Luego reiniciás n8n y el nodo aparece en el catálogo. Las variables de entorno que necesitás configurar son la URL del servidor Adeu y, opcionalmente, credenciales si lo tenés detrás de autenticación.

Para testing local: levantás el servidor Adeu con python -m adeu.server, configurás la variable ADEU_BASE_URL=http://localhost:8080 y probás el flujo con un DOCX de prueba antes de conectar el agente real.

Casos de uso reales: legal, compliance y redacción a escala

Revisión legal de contratos

Un estudio jurídico que procesa 50 contratos por semana puede armar un flujo donde el agente Claude detecta cláusulas de responsabilidad indefinida, propone alternativas con el lenguaje estándar del estudio, y devuelve el documento con los cambios marcados para revisión final del abogado. El proceso de 3 turnos (identificación → propuesta → refinamiento) es el que mencionamos antes. El abogado recibe un archivo con Track Changes que acepta o rechaza en 20 minutos en vez de revisar el documento entero de cero. En entender cómo funcionan los modelos de lenguaje profundizamos sobre esto.

Validación de compliance

Para documentos que deben cumplir GDPR o normativas fiscales, el agente puede tener cargada la normativa como contexto y marcar con comentarios cada sección que potencialmente incumple. Los comentarios quedan como w:comment en el DOCX: el equipo legal los ve inline y puede responder o resolver cada uno.

Redacción de guías técnicas y propuestas

Un equipo de contenido que maneja 30 guías técnicas mensuales puede usar el flujo para revisión de consistencia terminológica y estilo. El agente marca las inconsistencias como sugerencias de reemplazo, el editor revisa y acepta. La trazabilidad completa permite ver qué cambió el agente y cuándo, útil para auditorías internas.

Comparativa: n8n-Adeu vs. plugins de Word vs. soluciones propietarias

HerramientaIntegración DOCXTrack Changes nativoMulti-turno agenticoCustomizableCosto base
n8n-nodes-adeuSí, OOXML directoTotal (open-source base)Self-hosted gratis
Copilot for WordSí (UI integrada)ParcialNoNoUSD 30/usuario/mes
Microsoft Legal Agent for WordSí, mismo enfoque DOCX→MD→TCNo confirmadoNo (propietario)No publicado (abril 2026)
Generador genérico LLMLimitada (texto plano)NoNoMedioVariable
redlining documentos IA n8n diagrama explicativo

Ojo: Microsoft lanzó su propio Legal Agent for Word en abril de 2026 con una arquitectura técnicamente similar a Adeu: convierte el documento a Markdown, lo procesa con el modelo, y reinyecta cambios como Track Changes. La diferencia clave es que la solución de Microsoft es propietaria, cerrada, y por ahora orientada al segmento legal con precio no publicado. n8n-nodes-adeu es customizable y podés usarlo para cualquier tipo de documento.

Qué está confirmado / Qué no está claro todavía

Confirmado

  • El paquete n8n-nodes-adeu está disponible en el repositorio de GitHub de dealfluence
  • Adeu implementa conversión DOCX↔Markdown con reinserción como elementos OOXML nativos
  • El servidor MCP de Adeu es compatible con Claude Desktop y herramientas similares según el registro en LobeHub
  • Microsoft lanzó un Legal Agent for Word en abril de 2026 con arquitectura técnica similar

No confirmado o pendiente de verificación

  • El soporte oficial para tablas complejas, imágenes embebidas y campos de formulario en DOCX (el repositorio menciona soporte para estructuras básicas)
  • Throughput bajo carga alta: no hay benchmarks públicos de cuántos DOCX por minuto procesa el servidor Adeu
  • Publicación en el marketplace oficial de n8n (por ahora es instalación manual de nodo personalizado)

Errores comunes al implementar este flujo

1. Pasar el DOCX directo al LLM sin Adeu. Es el error más frecuente. El modelo recibe el XML crudo, devuelve texto con el formato parcialmente destruido, y el DOCX resultante corrompe estilos o pierde secciones completas. Adeu existe exactamente para evitar este paso.

2. No configurar el contexto del agente con el documento completo en el primer turno. Si el agente solo ve una parte del documento en la primera ronda, sus sugerencias van a ser inconsistentes con el resto. Adeu comprime el Markdown para minimizar tokens, así que conviene pasar siempre el documento entero al modelo desde el turno 1.

3. Asumir que los comentarios del agente van a aparecer automáticamente en la barra lateral de Word. Los comentarios de Adeu se reinyectan como w:comment válido, pero si tu versión del flujo no mapea el texto del comentario al autor correcto (por ejemplo, al nombre del agente), Word los muestra sin autor legible. Tomalo con pinzas: revisá el schema del comentario en la documentación de Adeu antes de sumir que el output es igual al de un revisor humano. Tema relacionado: conectar con herramientas de Google Workspace.

Preguntas Frecuentes

¿Qué es n8n-nodes-adeu y para qué sirve?

n8n-nodes-adeu es un nodo personalizado para la plataforma de automatización n8n que integra la librería Adeu. Con él podés armar flujos visuales donde un agente IA lee, edita y devuelve documentos DOCX con los cambios marcados como Track Changes nativos de Word. Es útil para equipos que procesan volumen alto de documentos y necesitan trazabilidad completa de cada modificación.

¿Cómo funciona el redlining con IA en documentos DOCX?

Adeu convierte el DOCX a Markdown comprimido para que el LLM pueda procesarlo sin desperdiciar tokens en XML. El agente devuelve los cambios en formato diff, y Adeu los reinyecta en el DOCX original como elementos w:ins y w:del, que son exactamente los que Word usa internamente para Track Changes. El resultado es un archivo que abre en Word sin modificaciones y muestra los cambios con la interfaz estándar de revisión.

¿Qué diferencia hay entre usar Adeu/n8n y el Legal Agent de Microsoft?

La arquitectura técnica es similar: ambos convierten DOCX a Markdown y reinyectan Track Changes. La diferencia es que Microsoft Legal Agent (lanzado en abril de 2026) es propietario, cerrado y orientado al segmento legal con precio sin publicar. n8n-nodes-adeu es open-source base, customizable para cualquier tipo de documento, y podés integrarlo en cualquier stack de automatización que uses.

¿Qué LLMs son compatibles con este flujo?

Adeu es agnóstico al modelo. Podés conectar Claude, GPT-4o, Gemini o cualquier LLM que tenga nodo en n8n al flujo de edición. El nodo Adeu se encarga de la conversión DOCX↔Markdown; el agente es el componente que reemplazás según el caso de uso o el presupuesto disponible.

¿Cómo instalo n8n-nodes-adeu en mi instancia?

Copiás el paquete compilado a ~/.n8n/custom/ o lo instalás con npm en el directorio de tu instancia n8n. Reiniciás n8n y el nodo aparece en el catálogo como cualquier otro. Necesitás tener el servidor Adeu corriendo (local o en red) y configurar la variable ADEU_BASE_URL con su URL. La instalación completa, incluyendo el servidor Adeu, lleva alrededor de 30 minutos en una máquina con Python 3.10+.

Conclusión

El problema de editar DOCX con IA sin destruir el formato era real y mal resuelto hasta ahora. Adeu lo resuelve de forma técnicamente sólida, y n8n-nodes-adeu lo mete dentro de flujos de automatización sin fricción. Que Microsoft haya llegado a la misma arquitectura técnica (DOCX→Markdown→Track Changes) de forma independiente para su Legal Agent en abril de 2026 es la mejor validación posible del enfoque.

Si tu equipo trabaja con volumen alto de contratos, guías técnicas o cualquier documento Word que requiera revisión iterativa, vale la pena armar un prototipo con este stack antes de optar por una solución propietaria. El costo de experimentar es bajo; el costo de quedar atado a una plataforma cerrada cuando el mismo resultado se puede lograr con herramientas open-source es más difícil de justificar. Para el hosting de la infraestructura que corra el servidor Adeu y la instancia n8n, donweb.com tiene opciones de VPS que encajan bien con este tipo de workloads.

Fuentes

Desplazarse hacia arriba