La mejora no es un salto: es una escalera. Subes un peldaño a la vez: primero lo que se rompe, luego lo que es ineficiente, luego a la calidad de salida y solo entonces la rendimiento. El diagrama muestra este orden de prioridad, desde la base (error) hasta la cima (velocidad).
Diagrama ilustrativo — recreación conceptual del orden de enhancement, no es una captura de pantalla real.
🪜 Filosofía de mejora por capas
Qué es: un workflow que «funciona» es básico y no presenta errores aparentes; uno que "funciona bien" gestiona casos extremos, ofrece una buena experiencia y es eficiente. La filosofía de enhancement consiste en cerrar esa distancia en capas — un cambio a la vez, paso a paso, para no sobrecargarte.
✓ Funciona BIEN
- ✓Casos extremos resueltos (sin coincidencia, correo automático).
- ✓Buena experiencia: formato, firma, tono.
- ✓Eficiente desde el disparador hasta el borrador.
✗ Solo "Funciona"
- ✗Falla con el primer caso fuera del happy path.
- ✗Responde incluso correos automáticos y no-reply.
- ✗Salida sin procesar, sin voz de marca ni personalización.
🧭 Por qué aprender
La mejora es iterativa y fluida: haz primero lo esencial, mantén una lista de «sería bueno tener», recoge feedback del mundo real, muéstralo a un grupo pequeño y solo entonces aplica nuevas rondas. La limpieza también es una mejora: organizar, etiquetar e incluso colorear nodos superpuestos cuenta.
🎯 Consejo práctico
Prueba todo después de cada cambio y guarda o haz una copia de seguridad a medida que avanzas. Vuelve a probar el flujo normal, prueba el caso extremo que corregiste y confirma que nada más se haya roto.
Conceptos clave
Un cambio a la vez.
Después de cada escalón.
Guarda el progreso.
Comentarios del mundo real.
📊 Orden de prioridad
Qué es: hay un orden claro para la mejora — error → lógica → calidad de la salida → rendimiento. Primero, lo que se rompe; después, lo ineficiente; luego, la experiencia y, por último, la velocidad. Saltarse este orden es perder tiempo.
Los cuatro escalones, en orden
Manejo de errores: qué se rompe
Casos que hacen que el workflow falle o produzca una respuesta incorrecta. Van primero: un correo bonito no sirve de nada si no se genera ningún correo (o se genera el correo equivocado).
Mejoras de lógica — lo que es ineficiente
Reglas que podrían ser más inteligentes: filtrar correos antiguos, ignorar los automáticos, crear una rama cuando no haya coincidencias.
Calidad de la salida — la experiencia
Cómo se siente el resultado: formato del correo electrónico, voz de marca, firma, personalización con el nombre del cliente.
Rendimiento: la velocidad
Qué tan rápido pasa del disparador al borrador. Optimiza al final, cuando el resto ya esté correcto y pulido.
🧭 Por qué aprender
Confirma siempre que el happy path siga funcionando antes y después de cambiar; así no culpas a tu nuevo cambio por un fallo que ya existía. El orden evita pulir algo que todavía no es confiable.
Conceptos clave
Qué falla.
Qué es ineficiente.
La experiencia.
La velocidad.
🛟 Alternativa cuando no hay coincidencias
Qué es: cuando el vector store no encuentra una política para responder: el agente no debe inventar. La solución: el agente emite un marcador de confianza («política encontrada» / «ninguna política»), un nodo de código interpreta, un IF se desvía y un nuevo borrador cortés dice "vamos a investigar y volveremos".
agente → marcador: "no policy found"
↓
nó de código → lê o marcador
↓
IF → política encontrada?
├─ sim → rascunho normal
└─ não → rascunho "vamos pesquisar
e retornar" (bem formatado)
🧭 Por qué aprender
Es la defensa n.º 1 contra las alucinaciones. Anticipa las preguntas de aclaración (umbral de coincidencia, mensaje alternativo, puntuación de relevancia) antes de pedir el cambio. Y verifica: una pregunta sobre "envío internacional" debe pasar al borrador de investigación, nunca a una respuesta inventada.
🎯 Consejo práctico
Prueba con una pregunta probablemente fuera de alcance y confirma que aparece el borrador de respaldo, no una alucinación. Extra: ese borrador suele tener mejor formato, con párrafos y saltos de línea.
Conceptos clave
Confianza en el system prompt.
Interpreta el marcador.
Ramifica el flujo.
"Vamos a investigar."
⏱️ Filtro por tiempo
Qué es: procesar solo correos electrónicos más recientes que hace X minutos, para no volver a procesar correos antiguos. En lugar de agregar un nodo para comprobar la hora, la IA descubre la sintaxis de búsqueda de Gmail y agrega un filtro "newer than" directamente en el trigger.
# pedido em linguagem natural: "Processe só e-mails dos últimos 10 minutos." # a IA adiciona ao gatilho: query: newer_than:10m # sem nó separado de checagem de tempo
✓ Ventaja
- ✓Filtro directo en el disparador: sin nodo adicional.
- ✓No vuelve a procesar correos antiguos de la bandeja de entrada.
- ✓Más ligero y rápido de ejecutar.
✗ Qué evitar
- ✗Crear un nodo redundante para verificar el tiempo.
- ✗Ventana tan corta que se pierden correos entre ejecuciones.
- ✗Ventana tan amplia que vuelve a procesar y duplica.
🧭 Por qué aprender
Muestra que la IA muchas veces encuentra una forma más elegante que la obvia: usar la query nativa de Gmail en vez de un nodo. Alinear el intervalo de tiempo con el intervalo de polling evita perder o duplicar correos electrónicos.
Conceptos clave
Sintaxis de Gmail.
Sin un nodo separado.
Ajústalo al polling.
Menos reprocesamiento.
🚫 Filtrar correos automáticos
Qué es: no todos los correos merecen una respuesta. Un nodo de código después del disparador detecta correos de fuera de la oficina, notificaciones de entrega, newsletters y remitentes no-reply/postmaster/bounce/marketing, agrega un booleano isAutomated y el motivo, y se ramifica para omitir. Esto crea tres puertas: ¿automático? → ¿soporte? → ¿coincidencia con la política?
⚠️ La trampa de la distinción entre mayúsculas y minúsculas
Un bug clásico: el filtro dejó pasar a un remitente no-reply@ porque el código leía los campos del encabezado en minúsculas, pero llegaban capitalizados. La corrección: comparar los dos casos. Un encabezado con distinción entre mayúsculas y minúsculas rompe los filtros silenciosamente.
# falha: header.toLowerCase() vs "No-Reply@..." # corrige: comparar lower E original
🧭 Por qué aprender
Evita borradores absurdos (responder a un «entrega completada») y gastar tokens sin necesidad. Cuando hay varios workflows visibles para la IA, nombra el workflow existente en la solicitud: una solicitud vaga puede hacer que la IA cree un workflow nuevo desde cero.
🎯 Consejo práctico
Para probar un filtro, necesitas enviar exactamente ese tipo de correo. Si pasa uno automático, copia el problema de vuelta a la IA y deja que corrija la sensibilidad a mayúsculas y minúsculas; vuelve a cargar n8n y prueba otra vez.
Conceptos clave
Booleano + motivo.
Auto → soporte → match.
Compara los dos casos.
El workflow existente.
🗣️ Voz y tono de marca
Qué es: ajustar el tono de las respuestas para que sea amigable, servicial, relajado y entusiasta. El cambio se realiza en dos lugares: el system prompt del agente de IA (respuestas técnicas) y el borrador de fallback "vamos a investigar". Aquí ya entramos en la capa de calidad de la salida.
🎨 Qué incluir en el system prompt
- •Estilo de saludo y apertura.
- •Directrices de tono («con conocimientos de tecnología, pero nunca condescendiente»).
- •Frases alentadoras y despedidas variadas.
🧭 Por qué aprender
El tono es lo que hace que la respuesta parezca "de la empresa" y no "de un robot genérico". Sé específico y referencia el workflow existente para que la IA lo edite, en vez de construir uno nuevo. Actualizar ambos lugares (agente y fallback) mantiene la voz coherente en cualquier camino.
🎯 Consejo práctico
Después de aplicarlo, envía un correo de prueba y lee el borrador como si fueras el cliente: ¿está presente la personalidad? ¿El tono es coherente entre la respuesta técnica y la alternativa?
Conceptos clave
Agente + alternativa.
Amigable y claro.
Haz referencia al workflow.
En todas las rutas.
👤 Personalización con el nombre del cliente
Qué es: extraer el nombre del cliente de la firma/cierre del correo electrónico (patrones como "Saludos, João" / "Gracias, Sara"), guardar en una variable y usar en el saludo, con fallback "Hola" cuando no hay una suscripción. Un nuevo nodo de código hace la extracción; el prompt del agente y los dos borradores pasan a usar el nombre.
padrões: "Abraços, João" / "Obrigada, Sara"
↓
variável nome = "João"
↓
saudação: "Olá João," # ou "Olá" se vazio
⚠️ Por qué aprender — «por eso se prueba»
La lógica de extracción/respaldo puede comportarse de forma inesperada: sin firma, puede terminar usando el nombre de la dirección de correo electrónico en vez de «Hola». Prueba con entradas extremas. La IA también puede hacer cambios que no pediste (reposicionar nodos); revísalos.
🎯 Consejo práctico
Envía un correo electrónico de prueba con una firma clara y otro sin ninguna. Confirma el saludo personalizado en el primero y el fallback "Hola" (y no el nombre del correo electrónico) en el segundo.
Conceptos clave
De la suscripción.
Reutilizada en los borradores.
Sin nombre → genérico.
Con y sin suscripción.
🟢 Indicador de confianza
Qué es: un insignia alto/medio/bajo a partir del score con el que la base de conocimiento coincidió — para revisión interna, adjunto al final del borrador. El agente emite el marcador (p. ej., alto > 0,8; medio 0,6–0,8; bajo < 0,6); un nodo de código lo interpreta y genera una insignia HTML (verde/amarilla/roja, gris cuando no hay coincidencia).
📶 La escala de confianza
score > 0,8
0,6 – 0,8
score < 0,6
sin match
🧭 Por qué aprender
El badge le da al revisor humano una señal rápida de cuánto confiar en el borrador antes de enviarlo, sin leerlo todo. Como con las demás mejoras, ancla la solicitud en el workflow existente con nombre para que la IA lo edite en vez de recrearlo. Es un ejemplo de calidad de salida pensada para quien opera el agente.
🎯 Consejo práctico
Prueba con un correo electrónico de price-match (generalmente una coincidencia parcial) para ver aparecer la insignia media/baja. La insignia es interna: te orienta en la revisión, no se envía al cliente.
Autocuración (opcional): ¿cuál debe ser el PRIMER nivel de enhancement, antes que los demás?
📌 Resumen del módulo
Próxima Ruta:
Ruta 2 — Dominio del agente de código: workflows agénticos, el framework WAT, MCP, skills y gestión de tokens.