"Dibujar un diagrama de proceso me lleva media jornada" o "nuestro manual de operaciones está siempre desactualizado porque mantenerlo es demasiado costoso": los diagramas y los manuales son dos de las tareas de documentación que más trabajo consumen.
Esta guía cubre dos cosas: cómo hacer que la IA dibuje diagramas de flujo, de secuencia y de arquitectura solo con instrucciones de texto, y cómo generar manuales de trabajo automáticamente a partir de capturas de pantalla. El contenido se basa en los materiales que usamos en nuestras formaciones corporativas y en nuestro curso online.
Qué aprenderás en este artículo
- Qué es la generación de diagramas con IA y por qué compensa en el trabajo
- Las tres grandes herramientas — Mermaid, PlantUML, Draw.io — y cuándo usar cada una
- Cómo generar diagramas de flujo de negocio, de secuencia y de arquitectura
- Tres formas de renderizar código PlantUML como imagen
- Cómo entregar capturas de pantalla a la IA y recibir un manual
- Patrones prácticos de imágenes anotadas (marcos rojos, flechas, números) y guías paso a paso
Qué es la generación de diagramas con IA
La generación de diagramas con IA es una tecnología en la que la IA dibuja automáticamente diagramas de flujo, organigramas y otros esquemas a partir de descripciones de texto. No hay que dibujar a mano, y las correcciones se piden con un simple "cambia esta parte".
Puedes crear diagramas de flujo de negocio, de arquitectura de sistemas, organigramas y diagramas de secuencia solo describiéndolos con palabras. Desaparece el tiempo que dedicabas a colocar cajas y flechas, y puedes concentrarte en pensar. El apoyo visual es el arma más potente de un documento claro, y como la IA lo produce en segundos, puedes permitirte añadir un diagrama a cualquier documento.
Comparativa de las tres grandes herramientas — Mermaid, PlantUML, Draw.io
Cuando la IA genera diagramas, el formato de salida suele pertenecer a una de estas tres familias.
| Herramienta | Características | Ideal para |
|---|---|---|
| Mermaid | Sintaxis basada en texto; ligera y con soporte CDN para vista previa instantánea en el navegador | Diagramas de flujo, de secuencia y Gantt |
| PlantUML | Sintaxis UML; la salida de imagen puede automatizarse por completo con un script | Diagramas UML de secuencia, clases y actividad |
| SVG compatible con Draw.io | Produce SVG editables en Draw.io (diagrams.net); permite colaboración en equipo | Diagramas de arquitectura de sistemas y de red |
Regla de selección sencilla:
- Necesitas verlo ya o insertarlo en documentación → Mermaid (vista previa instantánea en navegador)
- Necesitas interacciones precisas entre actores → PlantUML (su especialidad son los diagramas de secuencia)
- El equipo debe poder editarlo después → SVG compatible con Draw.io
Con estas tres opciones cubres desde un flujo sencillo hasta un diagrama de arquitectura complejo.
Cómo generar un diagrama de flujo de negocio
El flujo básico al pedírselo a un agente de IA (Claude Code, Cursor, etc.):
- Elige el tema — p. ej., "proceso de incorporación de nuevos empleados"
- Enumera los pasos en viñetas — entrega de documentos → configuración de PC y cuentas → formación → práctica en el puesto → entrevistas de seguimiento
- Especifica las condiciones de bifurcación — p. ej., "bifurca según aprobado/suspenso en el test de formación"
- Especifica el formato de salida — "como bloque de código Mermaid", "como SVG compatible con Draw.io", etc.
- Revisa el resultado y describe las correcciones con palabras
La clave es escribir los pasos y las bifurcaciones antes de pedir. Describe el tema de forma concreta y detallada, y haz explícitas las relaciones con viñetas y flechas: la precisión mejora notablemente. Los prompts en inglés también tienden a generar resultados más precisos.
El mismo enfoque escala a un diagrama de secuencia de cuatro participantes ("navegador → servidor API → BD → API externa"), un diagrama de arquitectura para un stack "Next.js + Supabase + Stripe" o un flujo del departamento de marketing codificado por colores como SVG de Draw.io. Incluso puedes hacer que la IA lea datos de ventas de un archivo Excel y construya una infografía de evolución mensual de forma interactiva.
Tres formas de renderizar PlantUML como imagen
PlantUML se genera como código, así que necesita renderizarse para convertirse en imagen. Hay tres opciones:
- Que la propia habilidad de generación lo renderice (recomendado) — pide a la IA "crea el diagrama en PlantUML y genera también la imagen"; la generación de código, la conversión a PNG/SVG y el guardado ocurren en un solo paso
- El editor online oficial de PlantUML — abre plantuml.com en el navegador y pega el código; sin instalación
- Extensión de VSCode / Cursor — instala la extensión "PlantUML" (jebbs.plantuml) para vista previa en tiempo real dentro del editor (Option+D en Mac, Alt+D en Windows/Linux)
Para los SVG compatibles con Draw.io, basta con arrastrar el archivo generado a app.diagrams.net para reeditarlo, o pegarlo directamente en diapositivas y documentos.
Capturas de pantalla × IA: manuales de trabajo automáticos
Ahora el segundo pilar. La IA moderna entiende imágenes, lo que significa que puedes entregarle capturas de pantalla o videos y recibir un manual de operaciones o un tutorial. Es como "darle ojos a la IA".
El curso cubre cuatro habilidades representativas:
| Habilidad | Qué hace |
|---|---|
| screenshot-analyzer | Analiza pantallas de error y capturas de UI; produce análisis de causas y soluciones sugeridas como informe |
| screenshot-annotator | Añade automáticamente marcos rojos, flechas, llamadas numeradas y resaltados para crear imágenes listas para manuales |
| tutorial-generator | Genera automáticamente un tutorial paso a paso en Markdown a partir de varias capturas |
| video-frame-reader | Extrae fotogramas clave de una grabación de pantalla (.mp4) y genera una guía documentada |
Una captura de pantalla transmite la situación con más precisión que 1.000 palabras. Ahora que la IA puede leerlas, las capturas son la herramienta de comunicación definitiva.
El flujo de generación de manuales
- Captura las pantallas de la operación y guárdalas en una carpeta — numera los nombres de archivo (
01_,02_, ...) en orden de captura - Pide a la IA que genere el tutorial — "a partir de las imágenes de esta carpeta, genera un manual paso a paso en Markdown"
- La IA determina el orden de las imágenes y reconoce los elementos de la UI para redactar los pasos
- Haz que anote las imágenes donde haga falta — instrucciones como "1. haz clic aquí, 2. introduce el valor, 3. pulsa guardar" se convierten en llamadas colocadas en la imagen
- Revisa y termina el documento generado
Las capturas de alta resolución (se recomienda 1920x1080 o más) mejoran la precisión del análisis. Para flujos complejos, combina con una grabación de pantalla y extrae fotogramas clave para documentar.
También sirve para gestionar errores
El mismo mecanismo permite el diagnóstico de pantallas de error. Entrega a la IA la captura de un error y reconocerá el mensaje, clasificará el tipo de error (HTTP/JS/UI, etc.), inferirá la causa probable por el contexto y propondrá una solución paso a paso. Se acabó describir la situación con palabras: compartir con el equipo y resolver incidencias se vuelve mucho más rápido.
En entornos con capacidad de automatización del navegador (Browser MCP), la IA puede incluso abrir una página web por sí misma, capturar la pantalla y analizar mejoras de UI.
Patrones prácticos combinando diagramas y manuales
Las piezas se potencian al combinarse:
- Implantación de un sistema nuevo: diagrama de flujo (Mermaid) + manual de operaciones generado automáticamente desde capturas
- Estandarizar el soporte: diagrama de secuencia del flujo de escalado (PlantUML) + manuales anotados por pantalla
- Propuestas: genera un diagrama de arquitectura (SVG de Draw.io) e insértalo en una presentación generada con IA
Si un resultado no convence, ajusta el prompt y vuelve a ejecutar; elige el mejor de varios intentos e itera. Para imágenes más allá de los diagramas — banners y visuales de cabecera — consulta la guía de generación de banners e imágenes con IA.
Para formación práctica en equipo, consulta nuestra formación corporativa en agentes de IA.
Preguntas frecuentes
Q. ¿Cómo elijo entre Mermaid, PlantUML y Draw.io? A. Usa Mermaid cuando quieras vista previa instantánea en el navegador o insertar el diagrama en documentación, PlantUML para diagramas de secuencia y UML precisos entre actores, y SVG compatible con Draw.io cuando el equipo necesite editar el resultado después arrastrando y soltando. Mermaid es ligero y con soporte CDN, PlantUML destaca en la automatización de salida de imágenes por script, y los SVG de Draw.io pueden reeditarse en app.diagrams.net.
Q. ¿De verdad puedo hacer diagramas sin saber dibujar? A. Sí. Lo que se requiere no es habilidad de dibujo sino la capacidad de escribir con palabras los pasos, las condiciones de bifurcación y los actores. Convierte el proceso en una lista de viñetas, di "convierte esto en un diagrama de flujo" y la IA lo traduce a sintaxis de diagrama y lo renderiza. Las correcciones también son verbales: "añade esta bifurcación".
Q. ¿Algún consejo para mejorar la precisión? A. Describe el tema de forma concreta y detallada, y usa viñetas y flechas para explicitar las relaciones entre elementos. Los prompts en inglés también tienden a generar con más precisión. No busques la perfección a la primera: genera varios candidatos, elige el mejor e itera.
Q. ¿Qué necesito para generar un manual de operaciones automáticamente? A. Basta con una carpeta de capturas guardadas en orden con nombres numerados (01_, 02_, ...). Se recomienda una resolución de 1920x1080 o superior. La IA infiere el orden y los elementos de la UI para redactar los pasos, y puede añadir marcos rojos, flechas y llamadas numeradas donde haga falta. También puedes partir de una grabación de pantalla (.mp4) y extraer fotogramas clave automáticamente.
Q. ¿Hasta dónde llega el análisis de pantallas de error? A. Con una captura del error, la IA reconoce el mensaje, clasifica el tipo (HTTP/JS/UI, etc.), infiere causas por el contexto y produce un informe con pasos de resolución sugeridos, incluyendo qué registros revisar si se lo pides. Las decisiones finales de corrección deben pasar por revisión humana antes de ejecutarse.
Artículos relacionados
- Generación de banners e imágenes con IA para tu negocio
- Crear y convertir presentaciones de PowerPoint con IA
- El flujo de redacción de artículos con IA
- Introducción a la generación de video con IA
- Formación corporativa en agentes de IA (práctica)
¿Listo para poner a trabajar los agentes de IA?
Convierte lo que acabas de leer en flujos de trabajo reales. AI Agent Camp ayuda a profesionales no técnicos a pasar de usar a construir.
Última revisión: 2026-06-10