# Rakenne 0.5.0 — Motor de plantillas, extracción de variables y herramientas DOCX

> 0.5.0 introduce un motor de plantillas basado en esquemas para generar documentos estructurados, un pipeline de extracción con trazabilidad completa para obtener variables de documentos fuente, y un conjunto completo de herramientas para crear y editar archivos Word.

Author: map[bio:Founder linkedin:https://www.linkedin.com/in/ricardocabral/ name:Ricardo Cabral]
Published: 2026-03-05

URL: https://rakenne.app/es/learn/releases/rakenne-0-5-0/index.md


Nos complace anunciar **Rakenne 0.5.0**. Esta versión añade tres grandes capacidades: un **motor de plantillas** para generar documentos estructurados a partir de variables validadas, un **pipeline de extracción** para obtener datos de variables de documentos fuente con trazabilidad completa, y una skill de **herramientas DOCX** para crear, editar y convertir archivos Word.

## Motor de plantillas

Las skills ahora pueden definir un **esquema de variables** y **plantillas de documento** para su salida. El agente utiliza cuatro nuevas herramientas para validar, analizar, renderizar y auditar el resultado:

- **Validate variables** — Comprueba los valores de las variables contra el esquema. Soporta tipos enriquecidos (moneda, fechas, CNPJ, CPF, porcentajes, tablas markdown) e informa la tasa de completitud para saber qué tan completos están los datos antes de renderizar.
- **Lint template** — Detecta errores antes de renderizar: helpers faltantes, variables no definidas, valores opcionales sin texto de respaldo. Reporta los problemas con referencias de archivo y línea para que el agente pueda corregirlos in situ.
- **Render template** — Sustituye las variables validadas en la plantilla con formato adaptado a la localización (p. ej. `R$ 1.500.000,00` para portugués brasileño, `$1,500,000.00` para inglés). Las variables derivadas se calculan automáticamente a partir de sus fuentes.
- **Audit render** — Compara la salida renderizada con la plantilla original. Valida que las **zonas inmutables** (avisos regulatorios, cláusulas estándar) no hayan cambiado, ejecuta verificaciones anticontaminación y aplica presupuestos de cambio para que el agente se mantenga dentro de los límites esperados.

Las plantillas soportan parciales, secciones condicionales y más de 40 helpers de formato adaptados a la localización. El motor es determinístico: las mismas entradas siempre producen la misma salida.

## Extracción de variables

Un nuevo pipeline de ocho herramientas permite al agente extraer variables estructuradas de documentos fuente (PDF, DOCX u otros formatos) y producir un archivo `variables.json` listo para el motor de plantillas:

- **Ingest** — Convierte el documento fuente en un corpus de páginas direccionable por línea (un archivo markdown por página) para que cada valor extraído pueda rastrearse hasta su ubicación exacta.
- **Segment** — Detecta los límites de sección usando una definición de taxonomía, dividiendo el corpus en partes manejables que el agente lee una a la vez.
- **Record** — A medida que el agente lee cada sección, registra los valores extraídos. La herramienta los normaliza automáticamente — monedas, fechas e identificadores se convierten a su formato estándar de almacenamiento — y etiqueta cada valor con su página y rango de líneas.
- **Consolidate** — Combina todas las extracciones de sección en un único `variables.json`. Cuando la misma variable aparece en múltiples secciones, la resolución de conflictos elige al mejor candidato según validez, especificidad y prioridad de sección.
- **Double-check** — Escanea el corpus en busca de variables que sigan en null después de la consolidación, usando patrones sensibles al formato para descubrir candidatos que el agente pudo haber pasado por alto.

Cada valor en la salida final lleva procedencia completa: en qué página, en qué líneas, en qué sección y cómo se resolvieron los conflictos. El resultado se conecta directamente con la herramienta `validate_variables` del motor de plantillas para un flujo continuo de extracción y renderizado.

## Herramientas DOCX

Una nueva skill **docx-tools** proporciona al agente nueve herramientas para trabajar con documentos Word:

- **Build** — Crea archivos `.docx` de forma programática con control total sobre párrafos, tablas, encabezados, pies de página, listas y estilos.
- **Unpack / Pack** — Extrae un `.docx` en archivos XML editables (con formato automático) y los vuelve a comprimir en un `.docx` válido. Útil para cambios de formato precisos que van más allá de lo que ofrece la herramienta de construcción de alto nivel.
- **Extract text** — Obtiene el contenido del documento como Markdown, con control sobre los cambios registrados: mostrar todas las marcas, aceptar la versión final o rechazar al original.
- **Accept changes** — Acepta todos los cambios registrados, produciendo un documento limpio sin marcas de revisión.
- **Add comment** — Ancla comentarios de revisión a texto específico, con soporte para respuestas en hilo.
- **Validate** — Verifica la estructura del documento en busca de archivos faltantes, contenido malformado, IDs duplicados y relaciones rotas, con reparación automática opcional.
- **Convert** — Convierte entre `.doc`, `.docx`, PDF, HTML y ODT.

La skill se instala desde la biblioteca como cualquier otra e incluye guías de referencia para que el agente pueda construir documentos complejos sin ayuda externa.

---

Gracias por usar Rakenne. Estas tres funcionalidades trabajan juntas como un pipeline: extraer variables de un documento fuente, renderizarlas en una plantilla y exportar el resultado como un archivo Word pulido. Nos encantaría saber cómo las aprovechas.

— El equipo Rakenne


---

Back to [Lanzamientos](https://rakenne.app/es/learn/releases/index.md)

