PTENES
RUTA 1

🟢 Fundamentos y primer workflow

Entender qué es el "vibe coding", configurar el entorno completo y recorrer el ciclo Plan → Build → Troubleshoot → Optimize mientras construyes un agente de soporte por correo electrónico real.

3
Módulos
22
Temas
~3h
Duración
Básico
Nivel
Progreso de la ruta 0% · 0 de 22
Banner: creación del primer workflow de automatización, nodo a nodo, en verde esmeralda
Módulo 1.1 Entorno conectado Módulo 1.2 Plan · Build · Troubleshoot · Optimize Módulo 1.3 De "funciona" a "funciona bien"

Mapa de la ruta

Contenido detallado

1.1 ~45 min

🧩 Fundamentos y entorno

Del concepto al entorno conectado y verificado: qué es el vibe coding, el asistente de código en el editor, el CLAUDE.md, n8n vía MCP, las skills y la verificación de las 4 conexiones.

Progreso del módulo 0% · 0 de 6
Qué es:

Crear software y automatizaciones conversando con la IA en lenguaje natural: tú describes el resultado y ella se encarga de la implementación.

Por qué aprender:

Elimina la sobrecarga técnica: enfócate en el problema, no en la mecánica de cada nodo. Velocidad e iteración rápida.

Conceptos clave:

El lenguaje natural dirige la construcción; la IA hace el «trabajo pesado»; iterar es solo pedir el cambio.

Qué es:

Un asistente que funciona dentro del editor: lee archivos, escribe y edita, ejecuta comandos y conecta herramientas mediante MCP.

Por qué aprender:

Entender la diferencia entre una suscripción (tarifa fija, basada en chat) y una API (por uso/token) evita sorpresas en los costos.

Conceptos clave:

La IA vuelve a leer toda la conversación con cada mensaje; las sesiones enfocadas cuestan menos; "una carpeta por proyecto".

Qué es:

Una carpeta por proyecto + un archivo CLAUDE.md en markdown que funciona como system prompt persistente (rol, contexto, preferencias).

Por qué aprender:

Define quién es la IA y cómo debe ayudar en todo el proyecto, sin repetir el contexto en cada conversación.

Conceptos clave:

Generar mediante una solicitud en lenguaje natural; editable en cualquier momento; empieza con una carpeta vacía.

Qué es:

n8n es un constructor visual de workflows; un servidor MCP lo conecta con la IA, que entonces puede leer/crear/probar/depurar workflows.

Por qué aprender:

Es el puente que permite crear automatizaciones conversando, sin armar cada nodo a mano.

Conceptos clave:

Clonar manualmente (no NPX); configuración a nivel de proyecto; API key + URL de la instancia solo en .env.

Qué es:

Documentación que enseña a la IA los tipos de nodos, parámetros, estructuras y patrones de n8n.

Por qué aprender:

Con las skills, la IA arma workflows correctos: no necesitas conocer cada nodo.

Conceptos clave:

Instalación igual a la del MCP (solo cambia el repo); actualizar CLAUDE.md; reiniciar para registrarlo.

Qué es:

Una secuencia de 4 pruebas antes de construir: directorio del proyecto, conexión MCP, lectura de workflows y documentación de los nodos.

Por qué aprender:

Garantiza que el entorno esté 100% listo; evita perder tiempo depurando la configuración en medio de un build.

Conceptos clave:

Cuatro pruebas; errores comunes (API key parcial, MCP no conecta, falla la autenticación); deja que la IA diagnostique.

1.2 ~60 min

🔁 El ciclo completo: Plan → Build → Troubleshoot → Optimize

El ciclo de cuatro fases, demostrado en un agente de soporte por correo electrónico con RAG: modos de permisos, plan, build, credenciales OAuth, troubleshoot, optimize, proyecto guía y pruebas.

Progreso del módulo 0% · 0 de 8
Qué es:

Los modos que controlan cuánto puede hacer la IA por sí sola: preguntar antes, editar automáticamente, plan, auto, bypass.

Por qué aprender:

Equilibrar velocidad y seguridad: saber cuándo dejar que la IA actúe y cuándo aprobar paso a paso.

Conceptos clave:

Plan Mode planifica sin actuar; el bypass omite las aprobaciones (es peligroso); elige el modo según el contexto.

Qué es:

La IA investiga los nodos, hace preguntas para aclarar y propone un plan para que lo apruebes antes de construir.

Por qué aprender:

Alinear las expectativas antes de gastar tokens construyendo algo equivocado.

Conceptos clave:

Preguntas (columnas, acciones extra); plan aprobable; investigación de patrones.

Qué es:

La IA crea y valida los nodos en n8n a partir del plan aprobado.

Por qué aprender:

Conocer los límites: las credenciales, las hojas de cálculo y el mapeo quedan a tu cargo.

Conceptos clave:

Creación + validación automática; límites claros entre la IA y el humano.

Qué es:

Conectar Gmail/Google Sheets (OAuth2) y OpenAI (clave de API) de forma segura.

Por qué aprender:

Es la parte que solo tú puedes hacer; entender el flujo evita errores de permisos.

Conceptos clave:

OAuth2 para Google; clave de API para OpenAI; nunca pongas secretos en el chat.

Qué es:

Copia el mensaje de error y envíaselo a la IA para que lo diagnostique y corrija.

Por qué aprender:

El loop humano de debug es la habilidad central: un error se convierte rápidamente en una corrección.

Conceptos clave:

El error como insumo; iteración; la IA lee, entiende y propone la corrección.

Qué es:

Pedir mejoras conversando; por ejemplo, cambiar el intervalo de polling.

Por qué aprender:

Refinar sin volver a abrir el build; el workflow evoluciona mediante conversación.

Conceptos clave:

Cambios incrementales; lenguaje natural; ajustes pequeños y seguros.

Qué es:

Un agente que clasifica correos, busca en PDFs de políticas (vector store) y redacta respuestas.

Por qué aprender:

Es el proyecto que reúne todo el ciclo en un caso real y útil.

Conceptos clave:

RAG; clasificador de texto; respuestas a partir de la base de conocimientos.

Qué es:

Checklist visual + probar escenarios reales; "verde" en el editor no significa que la respuesta sea correcta.

Por qué aprender:

Evitar que el agente invente lo que no sabe: calidad real, no solo ejecución sin errores.

Conceptos clave:

Probar como usuario; la IA debe negarse a inventar; verde ≠ correcto.

1.3 ~55 min

✨ De "Funciona" a "Funciona Bien": Enhancement

Transformar un workflow que «pasa las pruebas» en uno listo para el mundo real: filosofía por capas, orden de prioridad, fallback, filtros, voz de marca, personalización e indicador de confianza.

Progreso del módulo 0% · 0 de 8
Qué es:

Iterar una mejora a la vez, distinguiendo entre «funciona» y «funciona bien».

Por qué aprender:

Los cambios aislados son fáciles de probar y revertir.

Conceptos clave:

Capas; incremento; medir antes y después de cada cambio.

Qué es:

La secuencia recomendada de mejoras: manejar errores, luego la lógica, después la calidad de la salida y, por último, el rendimiento.

Por qué aprender:

Resolver primero lo que más importa evita optimizar algo que todavía falla.

Conceptos clave:

Robustez antes que pulido; rendimiento al final.

Qué es:

Marcador de confianza + nodo de código + IF + borrador «vamos a investigar y responder» cuando no hay respuesta en la base.

Por qué aprender:

Garantiza una respuesta digna incluso cuando el agente no sabe.

Conceptos clave:

Score de confianza; rama IF; borrador de respaldo.

Qué es:

Procesar solo correos más recientes que X minutos, con la sintaxis "newer than" en el disparador.

Por qué aprender:

Evita reprocesar el historial antiguo en cada ejecución.

Conceptos clave:

Ventana temporal; filtro en el disparador; eficiencia.

Qué es:

Detectar e ignorar mensajes sin respuesta, respuestas automáticas por ausencia y boletines informativos.

Por qué aprender:

No desperdicies procesamiento (ni tokens) con mensajes que no necesitan respuesta.

Conceptos clave:

Patrones de remitente; cuidado con mayúsculas y minúsculas (case sensitivity).

Qué es:

Actualizar el system prompt del agente y el borrador de respaldo para que suenen como la marca.

Por qué aprender:

La consistencia de voz transmite profesionalismo.

Conceptos clave:

Tono definido en el prompt; fallback alineado; revisión de ejemplos.

Qué es:

Extraer el nombre de la firma del correo electrónico; usar «Hola» como alternativa cuando no haya nombre.

Por qué aprender:

La personalización aumenta la calidad percibida de la respuesta.

Conceptos clave:

Extracción del nombre; alternativa elegante; saludo dinámico.

Qué es:

Un badge alto/medio/bajo derivado del score del vector store, para revisión interna.

Por qué aprender:

Indica qué borradores necesitan revisión humana antes de enviarse.

Conceptos clave:

Score → rango; insignia de confianza; clasificación para revisión.

← Inicio del curso Ruta 2: Dominio del agente →