¿Quién no ha deseado alguna vez que la documentación para desarrolladores se escribiera automáticamente o que los registros de cambios de las versiones de software se conservaran de forma fiable y sin esfuerzo adicional?
En el ámbito del desarrollo de software, la creación y el mantenimiento de la documentación no suelen estar entre las tareas más populares. A menudo, no hay una responsabilidades claras para esta tarea, por lo que la documentación se vuelve en poco tiempo obsoleta o incompleta. Sin embargo, a largo plazo, esto puede dar lugar a deudas técnicas que complican innecesariamente el desarrollo y el mantenimiento del software.
A día de hoy ya existen potentes herramientas de IA denominadas modelos de lenguaje grandes (LLM) que pueden aplicarse precisamente en este ámbito. Estas herramientas abren nuevas posibilidades para crear documentación de forma estructurada, coherente y comprensible.
En este contexto, en CIB Group hemos desarrollado un proceso basado en nuestra plataforma de procesos CIB flow, que aborda este tema y genera automáticamente la documentación completa para aproximadamente 500 módulos de proceso CIB flow. Para ello se utilizó la automatización de IA basada en los modelos LLM de la empresa estadounidense Anthropic.
¿Cómo funciona el proceso?
Nuestro proceso se inicia automáticamente cada dos meses. Comienza con la recepción de nuestros últimos módulos BPM en forma de archivos JSON. Con una indicación detallada, aplicamos el modelo LLM Claude Sonnet 4.0 con una temperatura baja y un número limitado de tokens de respuesta.
Tras ser invocado, el modelo genera HTML totalmente funcional para cada módulo del proceso, teniendo en cuenta múltiples clases CSS para diferentes opciones de diseño. Este HTML se puede publicar directamente en nuestra plataforma e-Learning de formación.
Bueno saberlo:
La temperatura es un parámetro que controla la creatividad del modelo: una temperatura baja da lugar a respuestas más predecibles y precisas, mientras que una temperatura más alta da lugar a respuestas más creativas y variadas, pero menos consistentes.
Un token es una pequeña unidad de texto —puede ser una palabra, un signo de puntuación o una parte de una palabra— y equivale, de media, a unos cuatro caracteres.
El modelo Claude Sonnet 4.0 ya no es el más reciente. Actualmente hay varios modelos nuevos de Anthropic, OpenAI o Grok, como Claude Opus 4.5, GPT-5.2 y Grok 4. Estos se integran continuamente en nuestros módulos. ¡Con solo unos clics, nuestro proceso también puede utilizar los modelos más recientes!
¿Cómo funciona el proceso?
Las alucinaciones son errores típicos de los LLM, en los que el modelo genera información que no es correcta. Esto ocurre a menudo porque los LLM funcionan basándose en probabilidades a partir de patrones aprendidos, en lugar de tener una comprensión real. A pesar de la baja temperatura que hemos establecido para obtener respuestas precisas y menos creativas, las alucinaciones pueden seguir apareciendo.
Por eso, en nuestro proceso incluimos un posprocesamiento con elementos deterministas, como reglas fijas mediante expresiones específicas que reconocen y corrigen determinados patrones en el texto. Además, volvemos a utilizar un LLM para corregir otros errores y mejorar la calidad de la documentación.
Pero ahora hablemos de los costes:
De forma conservadora, estimamos que la creación manual de la documentación, incluido el control de calidad, para un único módulo de proceso requiere unos 30 minutos. Por tanto, el esfuerzo total para esta actividad asciende a unos 30 días laborables. A esto hay que añadir los considerables costes de oportunidad, ya que este tiempo no se puede dedicar a actividades que aportan valor añadido, como la captación de clientes o el desarrollo conceptual.
Con nuestro enfoque automatizado, este esfuerzo se reduce drásticamente. Sobre la base de los precios modelo vigentes en el momento de redactar este artículo, de aproximadamente 3 € por millón de tokens de entrada y 14 € por millón de tokens de salida, los costes puros del modelo ascendían a solo unos 0,03 € por módulo.
En total, esto supone unos 15 € por la documentación completa de los 500 componentes, frente a los varios miles de euros que costaría la creación manual única.
El ahorro de tiempo también es significativo: La generación, incluido el postprocesamiento, tardó menos de 30 segundos por módulo. De este modo, se pudo crear toda la documentación de forma totalmente automática en menos de cinco horas, de manera rápida, coherente y escalable.
Automatización de los procesos de documentación
Por tanto, podemos concluir que estos modelos son muy útiles para automatizar procesos de documentación. Pensemos, por ejemplo, en la creación de registros de cambios para versiones de software o en la documentación de API, que contiene secciones estandarizadas como puntos finales, respuestas y códigos de error.
Los informes de errores de los usuarios también se pueden transferir sin problemas a herramientas de gestión de proyectos habituales, como JIRA (Atlassian), con CIB flow, por ejemplo. Los LLM basados en IA apoyan el proceso añadiendo automáticamente descripciones precisas de los errores, propuestas de solución fundamentadas, así como la priorización adecuada y el tipo de tarea correcto.
El resultado: los gestores de producto ven aliviada notablemente su carga de trabajo, los desarrolladores reciben tickets claramente estructurados y comprensibles, y todo el equipo puede concentrarse más en tareas estratégicas y que aportan valor añadido.
En CIB Group somosespecialistas en la automatización inteligente de la creación de documentos. Una de nuestras soluciones principales es el potente sistema de plantillas y correspondencia CIB coSys.
CIB coSys permite crear de forma eficiente y a prueba de revisiones documentos complejos, como contratos bancarios, notificaciones de siniestros para seguros, escrituras notariales o documentos de administraciones municipales, con solo unos pocos clics.
A continuación, los documentos pueden transferirse sin problemas a procesos de posprocesamiento adicionales, como el envío automatizado de correos electrónicos o la línea de impresión central CIB fairBrief. De este modo se crea un proceso documental continuo y altamente automatizado, desde la creación hasta el envío. Let´s CIB!
