PTENES
RUTA 3

📐 Diseño de soluciones

El proceso ya está mapeado. Ahora te conviertes en arquitecto: traduce el diagrama to-be a un blueprint ejecutable, elige herramientas y modelos con criterio, y diseña la lógica y los prompts que hacen que la IA decida con confianza. Diseñar bien en esta etapa es lo que distingue una automatización que resiste en producción de una que falla ante el primer caso inesperado.

3
Módulos
18
Temas
~3h
Duración
Inter.
Nivel
Blueprint del to-be a los componentes trigger recopilación IA + decisión acción log salida confiable ilustrativo — el blueprint que se convierte en un flujo ejecutable

Mapa de la ruta

Contenido detallado

3.1 ~60 min

📋 Del proceso al blueprint

Cómo convertir el diagrama to-be de la T2 en un blueprint de automatización: componentes, anatomía del flujo, datos, puntos de falla y métricas de éxito.

Qué es:

Un blueprint es la especificación técnica de la automatización: un documento que describe cada componente, los datos que entran y salen, y cómo se conectan las piezas, antes de tocar cualquier herramienta.

Por qué aprender:

Construir sin blueprint es improvisar en el editor: te pierdes, vuelves a hacer trabajo y descubres fallas tarde. El blueprint hace que el problema sea visible y barato de corregir en papel.

Conceptos clave:

Especificación ≠ implementación · pensar antes de construir · un plan legible para quien no lo va a construir.

Qué es:

Tomar cada cuadro del diagrama to-be y clasificarlo en un tipo de componente: lo que dispara (trigger), lo que mueve o transforma datos (pasos), lo que razona (IA) y lo que produce un efecto en el mundo (acciones).

Por qué aprender:

Sin esta traducción, el diagrama es solo un dibujo bonito. Clasificar en componentes revela exactamente cuántas integraciones, prompts y nodos vas a necesitar.

Conceptos clave:

1 caja = 1 o más componentes · separar la lógica determinística de la IA · nombrar cada componente.

Qué es:

La estructura básica de casi toda automatización con IA sigue seis etapas: algo la activa, se recopilan datos, la IA interpreta, se toma una decisión, se ejecuta una acción y todo queda registrado.

Por qué aprender:

Conocer la anatomía estándar te da un molde reutilizable: encajas cualquier caso nuevo en estas seis etapas en lugar de inventar la estructura desde cero.

Conceptos clave:

6 etapas canónicas · el registro nunca es opcional · la decisión va separada de la acción.

Qué es:

Para cada componente, define explícitamente qué entra y qué sale, y en qué formato (texto, JSON, archivo, número). Es el contrato que conecta una pieza con la siguiente.

Por qué aprender:

La mayoría de las interrupciones del flujo ocurre en la integración: un componente entrega un formato que el siguiente no entiende. Definir los formatos en el blueprint elimina este problema antes de que exista.

Conceptos clave:

Contrato de datos · JSON como lengua franca · campos obligatorios vs. opcionales.

Qué es:

Mapea, para cada componente, qué puede salir mal (API fuera de servicio, dato faltante, IA sin certeza) y define el comportamiento de fallback: repetir, omitir, alertar a una persona o detenerse.

Por qué aprender:

La automatización sin plan B es frágil: la primera excepción lo derriba todo. Anticipar fallas en el blueprint es lo que transforma un prototipo en algo realmente confiable.

Conceptos clave:

Reintentos vs. alternativa · intervención humana · fallar de forma visible, nunca silenciosa.

Qué es:

Define, antes de construir, qué cuenta como éxito: tiempo ahorrado, tasa de aciertos, % de casos que requieren intervención humana, costo por ejecución.

Por qué aprender:

Sin definir una métrica de éxito de antemano, nunca sabes si la automatización es lo suficientemente buena para entregarla o si, en realidad, está creando más trabajo.

Conceptos clave:

Métrica antes de la construcción · línea base manual · el costo por ejecución cuenta.

Ver completo
3.2 ~60 min

🧰 Elección de herramientas y modelos

¿n8n, Make o código? ¿Qué LLM? Cuándo entran RAG, MCP, APIs y bases de datos. Criterios de decisión y trade-offs para armar el stack adecuado para el blueprint.

Qué es:

Tres caminos para orquestar la automatización: n8n (low-code, self-host, flexible), Make (visual, SaaS, rápido para empezar) y código puro (máximo control, máximo mantenimiento).

Por qué aprender:

Elegir mal la base sale caro después: te topas con límites de licencia, falta de un conector o una complejidad que el low-code no soporta. Elegir con criterio evita una migración futura.

Conceptos clave:

Low-code vs. código · self-host vs. SaaS · el costo de mantenimiento es parte del costo.

Qué es:

Decidir si la tarea realmente necesita un LLM (frente a una regla/regex) y, si lo necesita, qué modelo usar: uno pequeño y económico para clasificar, uno grande y costoso para razonamientos complejos.

Por qué aprender:

Usar el modelo más caro en todo quema el presupuesto; usar el más barato en una tarea difícil quema la confiabilidad. Adaptar el modelo a la tarea es lo que mantiene los costos y la calidad bajo control.

Conceptos clave:

Un LLM no es la respuesta para todo · modelo pequeño para tarea simple · costo por token × volumen.

Qué es:

RAG (Retrieval-Augmented Generation) busca fragmentos relevantes de una base de conocimiento propia y los inyecta en el prompt, para que la IA responda con base en tus documentos y no solo en su entrenamiento.

Por qué aprender:

Cuando la automatización depende de información que solo existe en tu empresa (políticas, catálogo, historial), RAG es lo que evita que la IA invente cosas y la mantiene anclada en la realidad.

Conceptos clave:

Recuperar antes de generar · embeddings y búsqueda semántica · RAG solo cuando hay conocimiento propio.

Qué es:

MCP (Model Context Protocol) es un estándar para conectar la IA con herramientas externas —leer archivos, consultar bases de datos, llamar APIs— de forma uniforme, sin código de integración para cada conexión.

Por qué aprender:

Cuando la automatización requiere que la IA actúe (no solo responda), MCP estandariza ese acceso. Entender cuándo usarlo evita reinventar conectores y mantiene la stack escalable.

Conceptos clave:

Protocolo estandarizado · IA que usa herramientas · reutilización de conectores.

Qué es:

Las tuberías de la automatización: APIs (pides datos), webhooks (el sistema te avisa) y bases de datos (guardas y consultas el estado), con Supabase como ejemplo de base de datos + API + auth en un solo paquete.

Por qué aprender:

Casi toda automatización útil necesita obtener, recibir o persistir datos. Saber la diferencia entre API y webhook, y cuándo necesitas una base de datos, es lo que conecta el flujo con el mundo real.

Conceptos clave:

Pull (API) vs. push (webhook) · el estado necesita una base de datos · Supabase como atajo.

Qué es:

Un conjunto de criterios para comparar opciones: costo, velocidad de entrega, mantenimiento, control, límites de escalabilidad y dependencia del proveedor, además del reconocimiento de que cada elección implica un intercambio.

Por qué aprender:

Tomar decisiones sobre la tecnología por moda o costumbre cuesta caro. Un cuadro explícito de ventajas y desventajas te obliga a justificar cada elección y a defenderla ante el cliente.

Conceptos clave:

No existe una opción sin costo · criterio explícito · si hay empate, gana la opción simple.

Ver completo
3.3 ~60 min

🎯 Diseño de prompts y lógica de decisión

El prompt es el corazón de la automatización con IA. Estructura confiable, salida en JSON validable, guardrails, ramificación a partir de la IA y el ciclo de pruebas e iteración.

Qué es:

Tratar el prompt no como una conversación, sino como una parte de la especificación: instrucciones precisas y sin ambigüedades que definan exactamente el comportamiento esperado de la IA dentro del flujo.

Por qué aprender:

En la automatización no hay una persona que corrija la IA en tiempo real. El prompt debe estar bien desde el principio: es código que se ejecuta solo mil veces.

Conceptos clave:

Prompt = código en lenguaje natural · cero ambigüedad · escribir para la máquina, no para conversar.

Qué es:

Una estructura reutilizable: definir el rol de la IA, darle el contexto necesario, especificar la tarea, fijar el formato de salida y enumerar las reglas y restricciones.

Por qué aprender:

Los prompts ad hoc dan resultados inconsistentes. Una estructura fija hace que el comportamiento sea predecible y que el prompt sea fácil de revisar y mantener.

Conceptos clave:

Papel + contexto + tarea + formato + reglas · secciones con nombre · plantilla reutilizable.

Qué es:

Pedirle a la IA que responda en un JSON con campos fijos y validar esa respuesta antes de usarla, para garantizar que el siguiente paso del flujo siempre reciba la misma estructura.

Por qué aprender:

El texto libre rompe la automatización: el siguiente paso no sabe dónde está cada dato. Un JSON validado es lo que hace que la salida de la IA sea lo bastante confiable como para alimentar una acción automática.

Conceptos clave:

JSON con schema · validar antes de usar · rechazar y repetir si no es válido.

Qué es:

Las salvaguardas son límites en el prompt y en la validación (lo que la IA no puede hacer y lo que debe rechazar); la alternativa es lo que ocurre cuando la IA no está segura o se sale de las reglas: pedir confirmación, escalar o usar un valor predeterminado.

Por qué aprender:

La IA comete errores y alucina. Las barreras de seguridad y el fallback son lo que impide que un error se convierta en una acción irreversible ejecutada automáticamente.

Conceptos clave:

Limitar lo que la IA puede hacer · campo de confianza · ruta segura cuando hay incertidumbre.

Qué es:

Usar un campo de la salida JSON de la IA (p. ej., categoría, prioridad) como clave de una decisión IF/switch en el flujo, y dirigir cada caso a una acción diferente.

Por qué aprender:

Aquí es donde la IA deja de ser un adorno y se convierte en el cerebro de la automatización: clasifica y el flujo se ramifica. Saber diseñar este puente es lo que hace que la automatización sea realmente inteligente.

Conceptos clave:

La IA decide, el flujo ejecuta · el campo categórico como clave · una rama por caso + rama predeterminada.

Qué es:

Crear un conjunto de casos de prueba (incluidos casos difíciles y adversariales), ejecutar el prompt con todos, medir la tasa de aciertos y ajustar el prompt hasta que se estabilice.

Por qué aprender:

Un prompt que funciona en un ejemplo puede fallar en diez. Solo un ciclo de pruebas con casos reales te da confianza para poner a la IA a decidir sola en producción.

Conceptos clave:

Conjunto de pruebas · primero los casos difíciles · iterar hasta estabilizar la tasa de acierto.

Ver completo
← Ruta 2 · Auditoría Ruta 4 · Construcción →