Errores Comunes al Crear System Messages para Agentes en n8n

Crear un System Message efectivo es un arte, pero hay errores recurrentes que pueden hacer que tu agente en n8n falle, alucine o consuma demasiados recursos. Aquí detallamos los más frecuentes y cómo evitarlos.

1. Ambigüedad en las Instrucciones

El error más común es asumir que la IA "entenderá" lo que quieres sin decirlo explícitamente.

• Error: "Ayuda al cliente con lo que necesite."
• Problema: La IA no sabe los límites. Puede ofrecer descuentos? Puede hablar de política?
• Solución: "Tu objetivo es responder preguntas sobre los productos del catálogo adjunto. Si la consulta no está relacionada con ventas, redirige amablemente al tema."

2. Falta de Formato de Salida Estricto (JSON)

En n8n, a menudo necesitas que la respuesta de la IA sea procesada por otro nodo. Si la IA responde con texto libre cuando esperas JSON, el flujo se romperá.

• Error: "Dame los datos del usuario."
• Problema: La IA podría responder: "Claro, aquí tienes: Nombre: Juan, Edad: 30". Esto es difícil de parsear.
• Solución:

  <output_format>
  Responde EXCLUSIVAMENTE con un objeto JSON válido. No incluyas markdown ni texto adicional.
  {
    "name": "Juan",
    "age": 30
  }
  </output_format>

3. Sobrecarga de Información (Context Window Overflow)

Incluir manuales enteros de 50 páginas en el System Message.

• Error: Copiar y pegar todo el PDF de políticas de la empresa.
• Problema: Consumo excesivo de tokens (costoso y lento) y la IA puede "olvidar" instrucciones del inicio.
• Solución: Usa RAG (Retrieval-Augmented Generation) en n8n (Vector Store) para buscar solo la información relevante, o resume las políticas clave en el System Message.

4. No Definir "Guardrails" (Límites de Seguridad)

No decirle a la IA qué NO debe hacer.

• Error: Olvidar prohibir la invención de datos.
• Problema: La IA inventa precios o productos que no existen (alucinaciones).
• Solución:

  <constraints>
  - NO inventes precios. Si no encuentras el precio en la herramienta 'get_price', di que no lo sabes.
  - NO menciones a la competencia.
  </constraints>

5. Instrucciones Conflictivas

Dar órdenes que se contradicen entre sí.

• Error: "Sé muy breve" y "Explica detalladamente cada característica".
• Problema: La IA entrará en conflicto y el resultado será impredecible.
• Solución: Prioriza. "Sé breve en el saludo, pero detalla las características técnicas cuando se pregunten."

6. Ignorar el Uso de Herramientas (Tools)

No explicar cuándo o cómo usar las herramientas conectadas en n8n.

• Error: Asumir que la IA sabrá cuándo usar la herramienta de "Consultar Stock".
• Problema: La IA podría responder "Sí tenemos" sin verificar realmente.
• Solución: "ANTES de confirmar disponibilidad, DEBES ejecutar la herramienta 'check_stock'. Si la herramienta devuelve 0, informa que no hay stock."

7. Exceso de "Cortesía" (Ruido)

Usar lenguaje natural excesivo en el prompt.

• Error: "Por favor, si no es mucha molestia, podrías revisar si el usuario..."
• Problema: Gastas tokens innecesariamente y diluyes la instrucción importante.
• Solución: Sé imperativo y directo. "Revisa si el usuario..."

8. No Manejar Errores o Falta de Información

No decirle a la IA qué hacer cuando no sabe la respuesta.

• Error: Dejar abierto el caso de "información no encontrada".
• Problema: La IA intentará complacer al usuario inventando una respuesta plausible pero falsa.
• Solución: "Si la información no está en el contexto proporcionado, responde: 'Lo siento, no tengo esa información en este momento' y ofrece escalar a un humano."

Resumen

Error	Consecuencia en n8n	Solución Rápida
Salida de texto libre	Rompe nodos siguientes (JSON Parse)	Forzar estructura JSON/XML
Prompt gigante	Costos altos / Latencia	Resumir o usar Vector Store
Falta de límites	Alucinaciones (precios falsos)	Sección <constraints> clara
Ambigüedad	Respuestas inconsistentes	Verbos imperativos y ejemplos