Cómo Escribir Prompts Efectivos para Agentes IA

Escribir prompts claros y estructurados ayuda a tu Agente IA a comportarse con mayor precisión y a responder de manera natural. Esta guía cubre cómo redactar mensajes efectivos para Agentes IA en respond.io, incluyendo tanto Instrucciones como Comportamiento.

Instrucciones vs. acciones

Redacción de instrucciones

Al crear instrucciones, estructúralas claramente para que el Agente IA siempre sepa quién es, cómo comportarse y qué pasos seguir. Se recomienda dividir las instrucciones en cuatro partes.

Nota: Las instrucciones del Agente IA admiten hasta 10,000 caracteres. Si excedes el límite, se te pedirá que acortes tus instrucciones antes de guardar.

Consejos para las instrucciones

Escribir instrucciones claras y estructuradas ayuda a que tu Agente IA actúe con coherencia. A continuación tienes un ejemplo de buenas prácticas para un Agente de Ventas para la Calificación de Clientes Potenciales y los consejos clave a seguir.

# CONTEXTO
* Estás chateando con alguien que está explorando nuestro producto (nuevo, que vuelve o que está navegando). Tu objetivo es guiarlos hacia el producto o plan adecuado.

# ROL & ESTILO DE COMUNICACIÓN
* Sé cálido, servicial y relajado—nunca insistente. Haz una pregunta a la vez. Mantén las respuestas cortas, claras y alentadoras.

# FLUJO PRINCIPAL
1. Saluda y da la bienvenida al Contacto (nombre del Contacto $contact.firstname). 
2. Pregunta, recopila y guarda los campos del Contacto: nombre, correo electrónico y teléfono (todos obligatorios).
3. Pregunta por sus necesidades: **"¿Tienes un presupuesto en mente? 🙂"**

## CALIFICAR CLIENTE POTENCIAL
1. **Calificado:** Si el presupuesto ≥ 100000, recomienda un producto según sus respuestas usando la Fuente de Conocimiento.
 1.1 Si muestran interés, pregunta: **“¿Quieres agendar una demo o hablar con alguien?”**
 1.2 Si la respuesta es sí, asigna a @Sales Team y actualiza la etapa del ciclo de vida a Hot Lead. Si no están listos, diles que estás aquí si necesitan ayuda más adelante.
2. **No calificado:** Si el presupuesto < 100000, sigue respondiendo cualquier pregunta que tengan.

# LÍMITES
1. No le informes al contacto que está calificado o no calificado. Continúa con el flujo de manera cordial.

• Usa términos canónicos (los nombres y acciones exactos de tu Espacio de trabajo):

  • Equipos/agentes: p.ej. @Support Team, @Sales Team, @Jane Doe

  • Acciones: p.ej. Asignar a, Cerrar conversación, Actualizar etapas del ciclo de vida, Actualizar campos del Contacto

  • Campos del Contacto: p.ej. Campo Nombre, Campo Correo electrónico, Campo Teléfono — para que los datos se guarden/actualicen correctamente

• Organiza tus instrucciones claramente:

  • Divide los pasos en orden lógico (Saludar → Preguntar → Decidir → Asignar)

  • Usa viñetas en lugar de párrafos (Shift + Enter para saltos de línea)

  • Usa encabezados (# H1, ## H2) para cada sección. Por ejemplo:

    # CONTEXTO
    # ROLES Y ESTILO DE COMUNICACIÓN
    # FLUJO PRINCIPAL
    ## FLUJO SECUNDARIO
    # LÍMITES

• Mantén el lenguaje claro y usable:

  • Escribe en inglés claro y conversacional (también funciona con otros idiomas si se preservan los términos canónicos)

  • Usa símbolos (=, <, :) para comparaciones o condiciones

  • Mantén la gramática/ortografía correctas

  • Usa emojis con moderación (para mantener un tono accesible pero profesional)

• Sé claro sobre las capacidades:

  • Indica lo que el Agente puede y no puede hacer

  • No sobrecargues las instrucciones con detalles → usa Acciones para la ejecución (p.ej. asignar, cerrar, actualizar campos)

• Organiza por flujos y escenarios:

  • Comienza con un flujo principal (p.ej. Saludar → Preguntar → Decidir → Asignar)

  • Divídelo en escenarios para situaciones comunes

    • Ejemplo: En el prompt del Agente de Ventas anterior, “Calificación de Cliente potencial” es su propio escenario

  • Esto hace que los prompts sean más fáciles de leer, actualizar y mantener

Escribir prompts de acción

Los prompts de acción se usan cuando el Agente IA realiza algo antes de enviar una respuesta — como asignar un chat o cerrar la conversación.

Deben ser breves, específicos y enfocados en la ejecución.

Cómo escribirlos

Para cada acción, describe:

• Cuándo debe ocurrir (la condición)

• Qué debe hacer el Agente

Consejos para acciones

Puedes indicarles a los Agentes IA qué hacer en dos lugares:

• Cuadro de instrucciones

  • Aquí normalmente escribes tus flujos paso a paso, p.ej. “Saludar → Preguntar → Asignar → Cerrar”.

  • Estas son instrucciones secuenciales, es decir, se ejecutan en orden como un guion.

• Configuración de Acciones

  • Aquí puedes configurar reglas no secuenciales, p.ej. “Si el usuario pide a un humano → Asignar a @Support Team”.

  • Estas no dependen del flujo; pueden activarse en cualquier momento.

Para la mejor precisión, se recomienda cubrir las acciones en ambos lugares (instrucciones y configuración de acciones). De este modo el Agente IA siempre sabe qué hacer.

Si solo las agregas en el cuadro de instrucciones, asegúrate de que las acciones respectivas estén habilitadas también — de lo contrario el Agente IA no podrá ejecutarlas, aunque tus instrucciones las mencionen.

Escribir prompts para seguimientos

Los Agentes IA pueden enviar automáticamente mensajes de seguimiento cuando un Contacto no responde después de un tiempo específico — ayudándote a mantener las conversaciones y aumentar la participación.

Para habilitar esto, agrega instrucciones de seguimiento claras en la sección Instrucciones de la página de configuración del Agente IA.

Aquí hay un ejemplo que muestra cómo un Agente IA maneja seguimientos, respuestas y el cierre de conversaciones:

Si el cliente no responde después de 2 minutos, envía un seguimiento suave como: "Hola, ¿sigues ahí? No hay prisa, solo estoy comprobando. Si aún no hay respuesta, cierra la conversación, actualiza el ciclo de vida a Cliente potencial frío y di: "Cerraré la conversación." ¡No dudes en escribirme cuando quieras continuar!

Cómo funciona esto:

• Después de 2 minutos sin respuesta, el Agente IA envía automáticamente el mensaje de seguimiento.

• Si el Contacto aún no responde después de eso, el Agente IA ejecuta las siguientes acciones definidas en tu prompt — cerrar la conversación, actualizar el estado del ciclo de vida y enviar el mensaje final.

• Si el Contacto responde antes de la última acción en tu prompt, todas las acciones de seguimiento restantes se cancelan y la conversación continúa con normalidad.

Este ejemplo muestra cómo puedes encadenar múltiples pasos en un único flujo de seguimiento dentro de tu prompt.

Conceptos básicos del seguimiento

• El Agente IA verifica si el Contacto no ha respondido después del tiempo que especifiques en tu prompt.

• Si no se recibe respuesta dentro de ese tiempo, el Agente IA envía el mensaje de seguimiento que defines.

• La secuencia de seguimiento se detiene automáticamente si:

  • El Contacto responde antes del tiempo programado

  • La conversación está desasignada o cerrada

  • El Agente IA determina que el Contacto ya no está interesado, ha dicho adiós o que se ha alcanzado el objetivo

Puedes incluir uno o varios seguimientos en tu prompt para manejar diferentes escenarios o pasos de escalamiento.

Si escribiste instrucciones de seguimiento antes de que se lanzara la función de seguimiento, necesitarás volver a guardar tu plantilla para que los cambios surtan efecto.

Límites de seguimiento

• Cada seguimiento debe programarse dentro de las 24 horas (1 día) del mensaje anterior.

• Puedes incluir hasta 5 seguimientos por prompt, cada uno con su propio tiempo, mensaje y acciones (p.ej., enviar un recordatorio, asignar un usuario o cerrar la conversación).

• El Agente IA seguirá los tiempos definidos en tu prompt, pero los mensajes enviados fuera de la ventana de 24 horas de WhatsApp pueden fallar en la entrega.

• Después del último seguimiento, el Agente IA continúa con las acciones pendientes definidas en tu prompt (p. ej., asignar o enviar mensajes).

Usar el optimizador de prompts

Al editar instrucciones o prompts de acción, puedes usar la herramienta de optimización de prompts para mejorar la claridad y la redacción sin cambiar la intención original.

Úsalo cuando:

• Quieres una versión más pulida o estructurada de tu prompt

• No estás seguro de cómo formular las cosas claramente

• Empiezas desde cero y quieres orientación

Simplemente haz clic en Optimize, revisa la reescritura sugerida y ajusta si es necesario.

Esto funciona tanto para instrucciones generales como para acciones específicas, como asignar conversaciones o cerrar chats.

Uso de variables

Las variables hacen que las respuestas se sientan personales y precisas.

Las variables pueden usarse tanto en instrucciones como en acciones — especialmente al recopilar o referenciar detalles del Contacto.

Uso de la variable @

La variable @ permite a los Agentes IA asignar una conversación a un equipo, un agente humano o otro Agente IA según las instrucciones o el prompt de acción.

Soporta enrutamiento que imita las asignaciones manuales hechas en la Bandeja de Entrada — lo que la hace especialmente útil en acciones con plantillas.

Consejos para variables

• Usa lógica clara en tus prompts de acción (p.ej. “Si el Contacto pregunta por precios, asigna a @Sales.”).

• Si es posible, alinea tu estructura de equipos del Espacio de trabajo con la forma en que quieres usar los Agentes IA para el enrutamiento.

Uso de variables de campos del Contacto en prompts

Puedes usar $contact.fieldName para referenciar dinámicamente la información existente de un Contacto. Estos son especialmente útiles cuando:

• Quieres que el Agente IA personalice su saludo o respuesta

• Necesitas verificar o confirmar detalles que el Contacto haya compartido anteriormente

• Quieres evitar pedir información que ya está disponible

Consejos para variables de campo del Contacto

Las variables de campos del Contacto personalizan las respuestas de tu Agente y le ayudan a guardar o actualizar los datos del cliente automáticamente.

• Qué sucede tras bambalinas: Cuando el Agente IA genera una respuesta, las variables se sustituyen por el valor real del perfil del Contacto.

  • Ejemplo: $contact.name → se convierte en “Wilson” en la conversación.

• Lo que la IA realmente ve: el Agente IA solo ve el valor (“Wilson”), no la etiqueta de la variable ($contact.name).

Por qué esto importa

• Si solo escribes “el correo que diste antes”, el Agente IA no sabrá que te referías a $contact.email — solo verá el valor (como wilson@email.com), y podría confundirse si se mencionan varios correos.

• Al referenciar siempre el nombre del campo y el valor (p.ej., Correo: $contact.email, Teléfono: $contact.phone), dejas muy claro a qué información te refieres.

• Si quieres que el Agente IA guarde o actualice un campo, sé explícito y menciona el ID del campo en tu prompt:

  • Ejemplo: “Guarda y actualiza el campo de correo si el usuario proporciona uno nuevo.”

Ejemplos de prompts

Ahora que aprendiste a estructurar prompts, usar variables y escribir instrucciones claras, veamos algunos ejemplos completos. Estos comparan prompts buenos vs malos para que veas cómo las mejores prácticas se aplican en la vida real.

Ejemplo 1

Buen prompt

# CONTEXTO
* Guía a los visitantes de la página de precios hacia el plan adecuado.

# ROL & ESTILO DE COMUNICACIÓN
* Cálido, conciso; una pregunta a la vez.

# FLUJO PRINCIPAL
1) Saluda al cliente usando su nombre: $contact.firstname
2) Pregunta y guarda **Campo Nombre**, **Campo Correo**, **Campo Teléfono**
3) Pregunta el presupuesto

## ESCENARIOS
* Si el presupuesto ≥ 100000 → Recomienda un plan; pregunta por demo
  - Si sí → **Asignar a @Sales Team**; **Actualizar etapas del ciclo de vida** → **Hot Lead**
* Sino → Responde preguntas; mantén el chat útil

# LÍMITES
* Puede: Recomendar, **Asignar a**, **Actualizar campos del Contacto**, **Actualizar etapas del ciclo de vida**
* No puede: Ofrecer descuentos ni aceptar pagos

Por qué funciona esto:

• Encabezados claros, flujo principal, escenarios.

• Rápido de leer, fácil de mantener.

Prompt malo

¡Hola, bienvenido! obtén su info y presupuesto, recomienda algo, quizá pásalo a ventas si son grandes. 
Si no están seguros, simplemente continúa la conversación y no digas que están calificados ni nada por el estilo. lo resolveremos después y lo cerraremos.

Por qué esto no funciona:

• Sin encabezados, sin secciones, sin secuencia.

• Los lectores deben adivinar el orden y las acciones.

Ejemplo 2

Buen prompt

# CONTEXTO
* Prioriza problemas del producto y enrútalos correctamente.

# ROLES Y ESTILO DE COMUNICACIÓN
* Tranquilo, profesional, amable 🙂

# FLUJO PRINCIPAL
1) Saluda al cliente con su nombre: $contact.firstname
2) Pide un resumen breve y los pasos que ya intentó

## ESCENARIOS
* Urgente (acceso bloqueado | pérdida de datos | corte) → **Asignar a @Support Team**; establece expectativas
* No urgente → Proporciona pasos/documento de ayuda; si se resuelve **Cerrar conversación**; si no, **Asignar a @Support Team**

# LÍMITES
* Puede: Compartir guías.
* No puede: Acceder a facturación, restablecer contraseñas, cambiar la propiedad.

Por qué esto funciona:

• Inglés limpio y profesional con términos precisos.

• Las acciones, equipos y campos canónicos se usan tal cual.

Prompt malo

hola, por favor ayuda al usuario con los problemas
- si es urgente, avisa al equipo técnico. 
- Obtén nombre/correo/teléfono si puedes. 
- si son VIP, envía al equipo de ventas. Cierra cuando termines y márcalo como cliente potencial caliente

Por qué esto no funciona:

• Jerga/errores tipográficos (“pls”, “suppot teem”), acciones vagas, capitalización inconsistente.

• No hay nombres de equipo canónicos ni verbos de acción.

Ejemplo 3

Buen prompt

# CONTEXTO
* Maneja solicitudes de funciones empresariales y las transferencias.

# ROLES Y ESTILO DE COMUNICACIÓN
* Transparente, no insistente.

# FLUJO PRINCIPAL
1) Pregunta y actualiza: **Campo Nombre**, **Campo Correo**, **Campo Teléfono**
2) Confirma necesidades y presupuesto

## PASOS DE ACCIÓN (Orden correcto)
* Demo solicitada Y presupuesto ≥ 100000:
  1) Recomienda el plan; confirma demo
  2) **Asignar a @Sales Team**
  3) **Actualizar etapas del ciclo de vida** → **Cliente potencial caliente**
  4) Resume los siguientes pasos; confirma
  5) **Cerrar conversación**
* Solo información / no listo:
  - Comparte una vista general; mantén preguntas y respuestas
  - **Cerrar conversación** solo después de que confirmen que terminaron

# LÍMITES
* Puede: Recomendar planes. 
* No puede: Ofrecer descuentos, modificar contratos.

Por qué esto funciona:

• Cada acción tiene prerrequisitos y un orden exacto.

• Listas de pasos separadas eliminan la ambigüedad.

Prompt malo

Si alguien pide funciones empresariales:
- cierra el chat para mantenerlo ordenado
- luego márcalos como cliente potencial caliente y más tarde asígnalos a ventas si responden de nuevo.
- Obtén el correo si es necesario.

Por qué esto no funciona:

• Asigna antes de identificar; actualiza el ciclo de vida aleatoriamente; cierra demasiado pronto.

• No hay disparadores claros para cada acción.