Mejores prácticas: escribir prompts efectivos y checklist de testing
Cómo redactar las instrucciones del sistema de tu agente de IA y un checklist para probarlas antes de publicar.
Mira este paso en el video · Cómo escribir buenas instrucciones
Las Instrucciones del sistema (el prompt) son lo que define cómo piensa, responde y actúa tu agente de IA. Un buen prompt es la diferencia entre un bot que confunde al cliente y uno que resuelve. Esta guía reúne prácticas concretas para escribir prompts efectivos en Omnifox y un checklist para probarlos antes de publicarlos.
Dónde se escribe el prompt
Abre tu agente en Agentes de IA y entra a la pestaña Instrucciones. Ahí está el campo Instrucciones del sistema, con Plantillas de instrucciones (Ventas, Soporte, FAQ, Recepción y más), Variables insertables y el botón Optimizar con IA.
Cómo escribir un buen prompt
- Define el rol y el objetivo en la primera línea. Ej: "Eres el asistente de ventas de [empresa]. Tu meta es calificar al cliente y agendar una demo."
- Dale contexto del negocio: qué vende la empresa, horarios, políticas, lo que NO debe prometer.
- Marca límites claros. Dile qué hacer cuando no sabe algo: "Si no tienes el dato, ofrece transferir a un humano" en lugar de inventar.
- Usa variables en vez de texto fijo: inserta Nombre del contacto, Idioma, Canal, Fecha de hoy desde el panel Variables. Así el mensaje se personaliza solo.
- Indica el tono y el formato: respuestas cortas, sin tecnicismos, una pregunta por vez. El Tono también se ajusta en la pestaña Comportamiento.
- Lista las acciones disponibles. Si el agente tiene herramientas (agendar cita, actualizar contacto, transferir), explica cuándo usar cada una.
- Evita instrucciones contradictorias. "Sé breve" y "explica en detalle" en el mismo prompt confunden al modelo.
Cuando tengas un borrador, usa Optimizar con IA: genera una Versión optimizada del prompt que puedes revisar y aplicar.
Checklist de testing (antes de publicar)
Usa el Sandbox (Probador en vivo) del agente. Recorre esta lista:
- Saludo y caso feliz: el agente se presenta bien y resuelve la consulta típica.
- Pregunta fuera de alcance: ¿deriva a humano en lugar de inventar?
- Datos faltantes: ¿pide la info que necesita antes de actuar?
- Personalización: carga un contacto real con Cargar contacto real y verifica que use su nombre/idioma.
- Herramientas: ¿dispara la acción correcta (agendar, etiquetar, transferir) en el momento correcto?
- Tono e idioma: ¿responde en el idioma del cliente y con el tono definido?
- Mensajes hostiles o ambiguos: ¿mantiene la calma y no se sale del rol?
- Largo de respuesta: ¿respeta el límite de Máx. tokens por respuesta?
Reinicia la conversación con Reiniciar conversación entre escenarios para que el historial no contamine la prueba.
Si no funciona
- El agente ignora una instrucción: ponéla más arriba y más explícita; los modelos priorizan lo que está al principio.
- Inventa datos: agrega una regla anti-alucinación y conecta una Base de conocimiento.
- Respuestas demasiado largas: baja el Máx. tokens por respuesta en la pestaña Comportamiento.
Tips
- Cambia una sola cosa a la vez y vuelve a probar: así sabes qué causó la mejora.
- Guarda versiones: el Historial de la pestaña Instrucciones te deja comparar y volver atrás.
Artículos relacionados
Artículos relacionados
-
Crear tu primer agente de IA
Aprende qué hace un agente de IA en Omnifox, cómo darle instrucciones, conectarlo a un canal y probarlo en el sandbox antes de que hable con clientes reales.
-
Cómo escribir buenas instrucciones para tu agente de IA
Aprende a redactar instrucciones claras para que tu agente de IA responda con el tono, los límites y las acciones correctas.
-
Guía completa de los Agentes de IA
Los Agentes de IA a fondo, en 65 capítulos: crear, instrucciones, herramientas, conocimiento, comportamiento, probador, bandeja, flujos, analítica y consumo, con cada opción explicada.
-
Conectar tu agente de IA a WhatsApp, Instagram, Messenger y el chat web
Un agente sin canales no atiende a nadie. Conéctalo a tu WhatsApp, Instagram, Messenger o al chat de tu sitio web desde la sección Conexiones, y enciéndelo para que empiece a responder.
-
Empieza aquí: los Agentes de IA en 8 minutos
Lo esencial de los Agentes de IA en un video corto: crear un agente, sus instrucciones, herramientas, conocimiento, canales, el probador, el horario y el paso a una persona.