Cómo escribir las instrucciones de tu agente de IA para que responda bien
Un agente de IA responde tan bien como sus instrucciones. Las prácticas que recomienda Anthropic: claridad, contexto, ejemplos, etiquetas y un rol definido.
Contratas a un asesor nuevo y el primer día le dices solo: “Atiende los WhatsApp”. Sin explicarle los productos, los precios, cómo saludar, qué hacer si alguien se queja ni cuándo pasar el caso a un supervisor. ¿Qué tan bien crees que lo va a hacer?
Con un agente de IA pasa exactamente lo mismo. El modelo puede ser brillante, pero sin buenas instrucciones improvisa. La buena noticia: escribir instrucciones efectivas tiene técnica, y Anthropic, la empresa detrás de Claude, la documenta en detalle.
¿Por qué importan tanto las instrucciones?
Porque son el manual de entrenamiento de tu agente. Según el resumen de ingeniería de prompts de Anthropic, ajustar el prompt es mucho más rápido que otros métodos de control del comportamiento del modelo y a menudo produce grandes mejoras en poco tiempo.
Antes de escribir, ten claro qué hace tu agente; si aún no lo tienes, lee qué es un agente de IA para WhatsApp.
¿Qué técnicas recomienda Anthropic?
Cinco, ordenadas de las más efectivas en general a las más específicas:
| Técnica | Qué significa en tu agente |
|---|---|
| Ser claro y directo | Decir exactamente qué hacer, sin suponer que lo adivina |
| Dar ejemplos | Mostrar dos o tres conversaciones modelo |
| Dejar razonar | Pedirle que piense antes de responder en casos complejos |
| Usar etiquetas XML | Separar instrucciones, datos y ejemplos con marcas claras |
| Asignar un rol | Definir quién es: “asesora comercial de una clínica en Bogotá” |
Según la guía de mejores prácticas de Anthropic, las etiquetas XML ayudan al modelo a interpretar sin ambigüedad prompts que mezclan instrucciones, contexto, ejemplos y datos variables.
¿Cómo se ve un buen conjunto de instrucciones?
Una estructura práctica para un agente de WhatsApp:
- Rol: quién es y a quién representa.
- Objetivo: qué debe lograr (resolver dudas, calificar, agendar).
- Información del negocio: productos, precios vigentes, horarios, zonas de cobertura.
- Reglas con su porqué: “no prometas fechas de entrega, porque dependen del inventario del día”.
- Cuándo pasar a una persona: quejas, pagos, casos fuera de la información.
- Ejemplos: dos o tres conversaciones bien resueltas.
- Formato: mensajes cortos, un solo mensaje por respuesta, trato de tú.
Error común: escribir solo prohibiciones (“no hagas esto, no digas aquello”). Funciona mejor decir qué hacer en su lugar y explicar el porqué: así el agente aplica el criterio en casos que no previste.
¿Por qué pedir respuestas en un solo mensaje?
Por experiencia del cliente y por costo. Un agente que parte cada idea en cinco burbujas cansa al cliente y, desde octubre de 2026, cada respuesta por la API de WhatsApp cuenta para el cobro; lo explicamos en el nuevo cobro de WhatsApp.
¿Cómo sé si mis instrucciones funcionan?
Probándolas con conversaciones reales y corrigiendo lo que falla.
- Revisa cada semana una muestra de conversaciones.
- Anota dónde respondió mal, inventó o no pasó el caso a tiempo.
- Ajusta la instrucción o agrega un ejemplo que cubra ese caso.
- Mantén actualizada la información del negocio: un precio viejo en las instrucciones es un precio viejo en cada respuesta.
Ojo: las instrucciones no reemplazan los datos. Si el agente necesita consultar inventario o agenda en tiempo real, debe conectarse a esos sistemas, por ejemplo con MCP o con flujos de n8n.
En resumen
Un agente de IA es tan bueno como sus instrucciones: rol claro, objetivo, información del negocio, reglas explicadas, ejemplos y un formato definido. Es el mismo onboarding que le darías a un asesor nuevo, escrito para que la IA lo siga cada vez. Diseñamos, probamos y ajustamos las instrucciones de tu agente en nuestro servicio de agentes de IA.
Preguntas frecuentes
¿Qué es un prompt de sistema?
Son las instrucciones permanentes que recibe un agente de IA: quién es, a quién atiende, qué puede y qué no puede hacer, y cómo debe responder.
¿Sirve darle ejemplos de conversaciones al agente?
Sí. Anthropic incluye el uso de ejemplos entre las técnicas más efectivas para orientar las respuestas.
¿Qué son las etiquetas XML en un prompt?
Son marcas como <instrucciones> o <ejemplo> que separan las partes del prompt. Según Anthropic, ayudan al modelo a interpretar sin ambigüedad prompts que mezclan instrucciones, contexto y ejemplos.
¿Cada cuánto debo revisar las instrucciones?
Cada vez que encuentres respuestas que fallan. Revisar conversaciones reales cada semana al principio es una buena práctica.
No te quedes con la teoría: aplícalo a tu negocio
Implementamos Agentes de IA de punta a punta, con tu operación real. La primera conversación no tiene costo.
