Qué es una variable
Una variable es un marcador entre llaves dobles, como{{contact.first_name}}. Por ejemplo, si escribes Hola {{contact.first_name}} y el contacto se llama Juan, el agente enviará “Hola Juan”.
Puedes usar variables en cualquier campo de texto de Agent Studio: indicaciones del nodo de agente de IA, nodos de generación de texto, entradas de herramientas, mensajes y campos de condiciones. Haz clic en la flecha del campo para abrir el selector de variables, o escribe {{ a mano.
Para qué sirve
- Construyes una vez y reutilizas: el mismo agente funciona con los datos de cada contacto sin cambios.
- Sin actualizaciones manuales: si cambias tu teléfono o dirección, se actualiza en todos los lugares donde lo usas.
- Personalización automática: nombres y datos del CRM aparecen solos en las conversaciones.
- Fecha y hora al momento: el agente sabe qué día y hora es.
- Ejecución segura: si una variable no tiene valor, queda en blanco y el agente sigue funcionando.
Categorías de variables
Valores personalizados
Los creas una vez y los usas donde quieras. Por ejemplo, con la clavesupport_email y el valor [email protected], puedes escribir en el agente: “Si necesitas ayuda, escribe a {{custom_values.support_email}}”. Si más adelante cambias el correo, se actualiza en todas partes.
Además, los flujos de trabajo que usan la acción Agente de IA pueden actualizar valores personalizados durante la ejecución con la herramienta Actualizar valor personalizado.
Datos del formulario
Las variables de formulario solo tienen valor cuando el agente arranca con el disparador Formulario enviado.
Contacto
Si la ficha del contacto cambia, la próxima vez que se ejecute el agente usará los datos actualizados.Variables de contacto o variables de ejecución
- Las variables de contacto leen datos ya guardados en el CRM. Úsalas si la información existe antes de que empiece la conversación.
- Las variables de ejecución (runtime) guardan datos temporales que se recogen durante la conversación actual. Úsalas si el dato se obtiene en el momento, por ejemplo con un nodo de captura.
Cómo usar variables en tu agente
1
Crea tus valores personalizados
Ve a Configuración → Valores personalizados, haz clic en Agregar valor personalizado, escribe el nombre y el valor y haz clic en Crear.
2
Abre el agente
Ve a IA → Agent Studio y abre el agente que quieres personalizar.
3
Inserta la variable
Haz clic en un campo de indicación o mensaje, abre el selector con la flecha (o escribe
{{), elige la categoría (Cuenta, Valores personalizados, Ahora mismo, Datos del formulario o Contacto) y haz clic en la variable.4
Guarda y prueba
Haz clic en Guardar y luego en Probar. Ejecuta una conversación de ejemplo y confirma que las variables muestran los datos correctos. Si alguna sale en blanco, revisa que el dato exista en el CRM o en la configuración de tu cuenta.
5
Publica
Cuando todo funcione, promueve el agente a producción.
Preguntas frecuentes
¿Qué pasa si elimino un valor personalizado que usa el agente?
¿Qué pasa si elimino un valor personalizado que usa el agente?
La variable devuelve un valor vacío. No genera un error.
¿Qué pasa si una variable no tiene valor?
¿Qué pasa si una variable no tiene valor?
Queda en blanco y el agente sigue funcionando con normalidad.
¿Puedo usar campos de oportunidades o tareas?
¿Puedo usar campos de oportunidades o tareas?
Por ahora las fuentes disponibles son Cuenta, Valores personalizados, Ahora mismo, Datos del formulario y Contacto.
¿Las variables de fecha y hora respetan mi zona horaria?
¿Las variables de fecha y hora respetan mi zona horaria?
Sí. Usan la zona horaria configurada en tu cuenta.
¿Puedo usar variables de formulario en cualquier agente?
¿Puedo usar variables de formulario en cualquier agente?
Solo tienen valor cuando el agente arranca con el disparador Formulario enviado.
¿Importan las mayúsculas en los nombres de las variables?
¿Importan las mayúsculas en los nombres de las variables?
Sí. Usa exactamente las claves que aparecen en el selector de variables.
Artículos relacionados
Disparadores para agentes de flujo
Arranca tu agente con formularios, etiquetas o chats.
Nodo enrutador
Usa variables para decidir el siguiente paso.
Agentes de flujo en Agent Studio
Conoce el constructor y sus nodos.
Prueba y depura agentes
Comprueba que tus variables se resuelven bien.