Variables del prompt y referencias a herramientas
Usa $ para insertar variables (como el nombre del contacto) y ! para referenciar acciones dentro de las instrucciones de tu agente.
Mira este paso en el video · Instrucciones: el editor
Las instrucciones de tu agente no tienen que ser texto estático. En el editor de Instrucciones puedes insertar variables que se rellenan solas con datos del contacto y referenciar las acciones (herramientas) que el agente puede ejecutar.
Los dos atajos del editor
En la pestaña Instrucciones, mientras escribes el prompt:
- Escribe
$para insertar una variable (por ejemplo el nombre del contacto). - Escribe
!para insertar una referencia a una acción (una herramienta del agente).
Al teclear cualquiera de los dos, aparece un autocompletado con las opciones disponibles. Elige una y queda como una "píldora" dentro del texto.
Variables más usadas
Las variables se agrupan por origen. Algunas frecuentes:
$contact.first_name— Nombre del contacto$contact.last_name— Apellido$contact.email— Email$contact.phone— Teléfono$contact.language— Idioma del contacto$workspace.name— Nombre del workspace$conversation.channel_type— Tipo de canal
En tiempo real, $contact.first_name se reemplaza por el nombre real de la persona. Si el dato está vacío, el agente simplemente lo omite.
Cómo insertar una variable
- Abre el agente y entra a la pestaña Instrucciones.
- Posiciona el cursor donde quieres el dato.
- Escribe
$y empieza a tipear (ej.:nombre). - Elige la variable del listado (ej.: Nombre).
- Guarda los cambios.
Ejemplo: Saluda al cliente por su nombre: $contact.first_name.
Cómo referenciar una acción
Las acciones son las herramientas que ya configuraste en la pestaña Acciones personalizadas (agendar una cita, etiquetar un contacto, crear una oportunidad, etc.).
- En el editor de Instrucciones, escribe
!. - Elige la acción del autocompletado.
- Explica cuándo debe usarla: "Si el cliente quiere una visita, usa !agendar_cita".
Referenciar la acción no la ejecuta: le dice al agente que esa herramienta existe y en qué momento conviene usarla.
Verificación
- Ve a la pestaña Sandbox.
- Escribe un mensaje que active el dato o la acción.
- Revisa el Trace: ahí ves los valores reales que se inyectaron y qué herramienta llamó el agente.
Si no funciona
- La variable sale vacía: ese contacto no tiene ese dato cargado; prueba con un contacto completo.
- No aparece el autocompletado: asegúrate de escribir
$o!como primer carácter del token, sin espacio antes. - La acción no se ejecuta: confirma que esté creada y activa en Acciones personalizadas; si la borraste o renombraste, la referencia en el prompt queda rota.
Consejos
- Personalizar con
$contact.first_namesube muchísimo la sensación de atención humana. - No abuses de las acciones: referencia solo las que el agente realmente necesita para esa conversación.
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.