Variables de contexto de prompts
¿Qué son las variables de contexto?
Las variables de contexto son marcadores de posición dentro de los prompts que se reemplazan por valores reales en tiempo de ejecución. Permiten interacciones dinámicas y personalizadas sin necesidad de personalización manual para cada usuario o situación.
Una variable de contexto tiene la forma {VARIABLE_NAME}. Cuando el agente procesa el prompt, la variable se reemplaza por su valor real.
Ejemplo: "¡Hola {USER_FIRST_NAME}! Hoy es {TODAY_DATE}." se convierte en "¡Hola John! Hoy es 5 de marzo de 2026."
Variables de contexto disponibles
| Variable | Se reemplaza por | Valor de ejemplo | Resolución |
|---|---|---|---|
| {USER_NAME} | Nombre completo del usuario | John Smith | Por conversación |
| {USER_FIRST_NAME} | Nombre de pila del usuario | John | Por conversación |
| {USER_EMAIL} | Correo electrónico del usuario | john@example.com | Por conversación |
| {USER_ACCOUNT_NAME} | El nombre de la cuenta vinculada al contacto de un usuario de portal (vacío para usuarios internos sin contacto) | Acme Properties | Por conversación |
| {CONVERSATION_ID} | El Id del registro de la conversación actual — útil para instrucciones de auditoría | aX0… | Por conversación |
| {USER_CONTEXT_DATA} | Un bloque con formato que describe al usuario actual (lo usan los prompts integrados) | — | Por conversación |
| {RECORD_CONTEXT_DATA} | El bloque de contexto del registro de la página en la que se ejecuta la conversación | — | Por conversación |
| {TODAY_DATE} | La fecha de hoy | 2026-03-05 | Al ensamblar (apto para caché) |
| {AGENT_NAME} | El Nombre visible del agente | Asistente de ventas | Al ensamblar (apto para caché) |
| {AGENT_CHANNEL} | El canal en el que se ejecuta la conversación | Internal | Al ensamblar (apto para caché) |
| {USER_LANGUAGE} | La configuración regional de idioma de Salesforce del usuario | es_MX | Al ensamblar (apto para caché) |
| {USER_LANGUAGE_CODE} | Solo la parte del idioma de la configuración regional | es | Al ensamblar (apto para caché) |
Uso de variables de contexto en los prompts
Las variables de contexto se pueden usar en cualquier tipo de prompt y en cualquier campo:
"¡Hola {USER_FIRST_NAME}! Soy {AGENT_NAME}, tu asistente de ventas personal. ¿Cómo puedo ayudarte a cerrar negocios hoy?"
"Al responder a {USER_FIRST_NAME}, usa su estilo de comunicación preferido: directo y conciso. Incluye siempre {TODAY_DATE} en cualquier estimación de plazos."
"El usuario {USER_NAME} ({USER_EMAIL}) está accediendo a este agente en la conversación {CONVERSATION_ID}. Registra todas las interacciones por cumplimiento. Escala a la gerencia las solicitudes de datos confidenciales."
Ejemplos de personalización
Agente de ventas con personalización
Sin variables (genérico):
"Eres un asistente de ventas que ayuda a cerrar negocios."
Con variables (personalizado):
"Eres el asistente de ventas personal de {USER_FIRST_NAME}. Ayuda a {USER_FIRST_NAME} a cerrar negocios, gestionar oportunidades y hacer seguimiento del progreso. Hoy es {TODAY_DATE}."
Cada usuario recibe una personalidad adaptada a él.
Agente de soporte con contexto de fecha
Sin variables:
"Ayuda a los clientes a resolver solicitudes de servicio."
Con variables:
"Ayuda a los clientes a resolver solicitudes de servicio. Fecha actual: {TODAY_DATE}. Al hablar de plazos, haz referencia siempre a esta fecha actual. Responde en el idioma del usuario ({USER_LANGUAGE})."
Tus propios tokens de plantilla se dejan intactos
Las doce variables anteriores son las que resuelve REDA AI. Si tu organización tiene su propio sistema de
plantillas —tokens que rellenas desde otro sitio, o que dejas para que los complete una persona—
escríbelos con llaves dobles, por ejemplo {{ORG_NAME}}.
REDA AI no resuelve los tokens de llaves dobles, y a las herramientas asistidas por IA se les indica
expresamente que los dejen intactos: tanto el
Optimizador de prompts como Crear agente con
IA reciben la instrucción de conservar cada token {{…}} tal cual:
sin eliminarlo, resolverlo, renombrarlo ni rellenar un valor. Así un prompt puede pasar por una optimización
sin perder tus marcadores.
Conviene tener clara la distinción: las llaves simples son de REDA AI y se sustituyen al ensamblar; las llaves dobles son tuyas y sobreviven intactas.
Disponibilidad de las variables por canal
Las variables de agente y fecha se resuelven en todos los canales. Las variables de usuario dependen de que haya una persona autenticada:
- Canales Interno y API — las variables de usuario se resuelven a partir del usuario de Salesforce en ejecución.
- Canal Comunidad — las variables de usuario se resuelven a partir del usuario del portal; {USER_ACCOUNT_NAME} se rellena con la cuenta vinculada a su contacto.
- Widget externo — no hay una persona autenticada, así que las variables de usuario se eliminan: se reemplazan por texto vacío, nunca se envían a la IA y nunca se muestran literalmente. Escribe los prompts de este canal para que se lean con naturalidad sin las variables de usuario.
Un nombre de variable desconocido (un error de escritura, o una variable que no existe) es distinto: no se reemplaza y llega a la IA literalmente — consulta la sección de solución de problemas más abajo.
Prácticas recomendadas para las variables de contexto
Las variables deben mejorar la interacción. Evita usarlas en exceso — un prompt con {USER_FIRST_NAME} mencionado en cada frase resulta forzado. Úsalas con moderación para una personalización natural.
Verifica la disponibilidad de las variables — Antes de usar una variable en un agente de widget externo, confirma que esté disponible en ese canal. PRUÉBALA en producción para asegurarte de que las variables se reemplacen correctamente.
Maneja con elegancia cuando falten variables — Escribe prompts que funcionen incluso si una variable no se reemplaza. Ejemplo: "¡Hola {USER_FIRST_NAME}! (o quienquiera que seas)" frente a "¡Hola {USER_FIRST_NAME}!" (que falla si falta la variable).
Usa fechas que consideren la zona horaria — {TODAY_DATE} respeta la zona horaria y la configuración regional del usuario. Úsala para cualquier instrucción sensible al tiempo. Evita las fechas codificadas de forma fija.
Respeta la privacidad del usuario — No expongas {USER_EMAIL} a menos que sea necesario. Usa {USER_FIRST_NAME} para personalizar sin compartir datos de más.
Patrones comunes
"¡Hola {USER_FIRST_NAME}! Te damos la bienvenida de nuevo. Hoy es {TODAY_DATE}."
"Estás asistiendo a {USER_NAME} de {USER_ACCOUNT_NAME}. Adapta tus respuestas a su rol y nivel de experiencia. Hoy es {TODAY_DATE}."
"Registra todas las interacciones. Usuario: {USER_NAME}, Correo: {USER_EMAIL}, Conversación: {CONVERSATION_ID}, Fecha: {TODAY_DATE}."
"El idioma del usuario es {USER_LANGUAGE}. Responde en ese idioma y usa sus convenciones. Hoy es {TODAY_DATE}."
Solución de problemas con las variables
Verifica que el nombre de la variable sea exactamente correcto (distingue entre mayúsculas y minúsculas). {USER_FIRST_NAME} funciona; {User_First_Name} no. Recuerda también que en el canal Widget externo las variables de usuario se reemplazan por texto vacío.
Valor inesperado en una variable — Algunas variables dependen de la configuración de Salesforce. {USER_LANGUAGE} se basa en el idioma de Salesforce del usuario. Si es incorrecto, actualiza el idioma en su configuración personal.
La variable aparece literalmente en la respuesta — Si el prompt contiene {UNKNOWN_VAR}, la IA podría devolverla tal cual. Usa únicamente variables de la lista disponible.
Preguntas frecuentes
Por ahora, solo puedes usar las variables predefinidas que se listan arriba. No se admiten variables personalizadas. Si necesitas contexto adicional, usa campos de contexto o pasa los datos a través de la configuración del agente.
Las variables funcionan en los prompts. Los campos de contexto usan nombres de API de campo de Salesforce y no admiten variables. Para el mapeo dinámico de campos, usa prompts con descripciones de campos en su lugar.
Si el nombre de un usuario no está definido ({USER_FIRST_NAME} está vacío), la variable se reemplaza por una cadena vacía. Escribe prompts que manejen esto con elegancia, o haz que la variable sea opcional: "¡Hola {USER_FIRST_NAME} (o amigo)!"
No. Las etiquetas de los chips de sugerencias son estáticas. Puedes usar variables en el campo Mensaje (lo que se envía al hacer clic), pero no en la Etiqueta (el texto del botón).
Próximos pasos
Revisa la creación de prompts para ver ejemplos de variables en acción, o explora las prácticas recomendadas de prompts para más orientación.