Configuración del Agente IA (zona horaria, formato, opciones)

El agente IA tiene varias opciones de configuración agrupadas en el panel de edición (Gestión → Agentes IA → Editar). En esta guía explicamos las más importantes, empezando por la configuración regional (zona horaria y formato de fecha) que afecta directamente a cómo el agente responde sobre fechas y horas.

Configuración regional (zona horaria y formato de fecha)

Cada agente IA tiene dos selectores que definen cómo entiende y comunica el tiempo:

Los encuentras en Configuración Básica al editar el agente:

Configuración Básica
├── Nombre del Agente
├── Zona horaria ← aquí
├── Formato de fecha ← aquí
└── Descripción

Jerarquía: organización, workspace, agente

MuseRelay tiene una estructura jerárquica:

Organización
├── Workspace 1
│ ├── Agente A
│ └── Agente B
└── Workspace 2
└── Agente C

La configuración regional vive a dos niveles:

1. A nivel de organización (todos los agentes heredan por defecto) — se configura en Configuración → Organización.
2. A nivel de agente (override opcional) — el agente puede tener zona/formato propios que ignoran la organización.

Cascada de resolución

Para cada agente, el sistema resuelve la configuración en este orden:

1. ¿El agente tiene valor propio? → usa ese.
2. Si está en "Heredar" → ¿tiene valor la organización? → usa el de la organización.
3. Si ambos están vacíos → fallback:
   • Zona horaria → UTC.
   • Formato de fecha → en_US.

Ejemplo práctico

Una cadena de tiendas con organización "Screen Art" configurada como Europe/Madrid + es_ES:

Qué cambia exactamente con la zona horaria

La zona horaria del agente afecta a todas las variables _local del prompt y al bloque de contexto inyectado automáticamente. Ejemplo con la misma hora real (17 abril 2026, 15:47 UTC):

Bloque de contexto automático

Independientemente de si usas variables en tu prompt o no, el sistema siempre prepende al inicio del prompt del agente este bloque antes de enviarlo al modelo:

## Contexto actual (inyectado por el sistema, no modificar)
- Hora actual: 15:47 (Europe/Madrid)
- Fecha: viernes, 17 de abril de 2026
- Mañana: sábado, 18 de abril de 2026
- Zona horaria del agente: Europe/Madrid
- Locale de formato: es_ES

Esto garantiza que el agente siempre sabe la fecha y hora real, sin depender de que tú acuerdes de usar variables.

Recomendaciones

• Por defecto, deja los selectores del agente en "Heredar" y configura la zona en la organización. Así todos los agentes usan la misma configuración y solo tocas un sitio al cambiar.
• Override solo cuando haga falta: si una misma organización atiende varios países, crea agentes con override por zona (un agente por país).
• Para audiencias internacionales donde el horario del cliente importa, considera crear una organización por país — es el patrón más limpio en multi-tenant.
• Cambios en caliente: si editas la zona horaria del agente o la organización, el modelo ve los valores nuevos en la siguiente conversación. No hay que reiniciar nada.

️ Otras opciones de configuración del agente

Además de la región, el panel de edición del agente tiene:

• Nombre y descripción — cómo se llama tu agente y qué hace.
• Configuración de prompt — el system prompt que define el comportamiento. Ver Variables del prompt.
• Variables personalizadas — tus variables propias en JSON (por ejemplo {{empresa}}, {{horario_tienda}}).
• Calendario MuseRelay — para que el agente reserve, cambie y cancele citas en tu agenda.
• Configuración avanzada — streaming, máximo de tokens, creatividad (temperature).

Cada una se documenta por separado en esta sección.

Tiempo de respuesta (temporizador)

Por defecto el agente responde al momento. En Agentes IA → editar → Tiempo de respuesta puedes hacer que espere antes de contestar: útil en email, para que no parezca una respuesta automática, o para dar margen a tu equipo a contestar primero.

• Tiempo general: en minutos u horas (accesos rápidos: inmediato, 1 min, 5 min, 15 min, 1 h). 0 = inmediato.
• Por canal: WhatsApp, Instagram, Messenger, Telegram y Email pueden tener su propio tiempo. Vacío = usa el general; 0 = inmediato en ese canal. Ejemplo: inmediato en WhatsApp y 10 minutos en email.
• Variar un poco el tiempo: suma o resta hasta un 20 % al azar para que no responda siempre al minuto exacto.
• La espera cuenta desde el primer mensaje del cliente: si escribe varias veces, la IA responde todo junto a la hora prevista.
• Si alguien del equipo contesta antes (o pausa la IA), la IA no responde. En la bandeja verás «La IA responderá a las…».
• Máximo 24 horas; en WhatsApp, Instagram y Messenger 23 horas, para responder dentro de su ventana de 24 horas.
• No se aplica al chatbot web ni a las llamadas, que responden siempre al momento.

Preguntas frecuentes

¿Quién ve qué hora? Diferencia entre chatbot embed y panel de agentes

Una pregunta habitual: la configuración regional del agente, ¿a quién afecta exactamente?. La respuesta es importante porque el agente IA y los humanos que ven las conversaciones pueden estar en zonas horarias distintas.

Dos interfaces, dos reglas distintas

Por qué el chatbot embed usa la zona del navegador

Si un cliente de CDMX lee el chat en su web:

• Su reloj marca 09:15.
• Si el bot le muestra "te respondo a las 09:15" → coincide con su reloj .
• Si le mostrara "te respondo a las 16:15" (hora Madrid) → confusión .

Es lo que hacen WhatsApp, Messenger, Telegram, Slack: cada uno ve la hora en su propio huso. Cero configuración, cero confusión para el cliente final.

Por qué el panel de agentes usa la zona del agente/operador

El operador humano de MuseRelay está trabajando y necesita ver las horas en su zona laboral. Si atiende desde Madrid pero un cliente mexicano escribió a las 02:15 CDMX (09:15 Madrid), el operador quiere ver "09:15 Madrid" para saber cuándo responder.

Por eso, en el panel interno, el sistema usa la siguiente cascada:

1. Zona horaria del usuario operador (si la tiene).
2. Zona horaria de la organización.
3. Fallback a Europe/Madrid.

Separadores de día estilo chat moderno

El chatbot embed agrupa mensajes por día usando la zona del navegador del cliente, igual que WhatsApp o Telegram:

─────── Hoy ───────
14:30 Mensaje 1
14:32 Mensaje 2

─────── Ayer ───────
09:15 Mensaje 3

─── miércoles 15 de abril ───
11:00 Mensaje 4

─── 2 de marzo de 2026 ───
Mensaje antiguo

Reglas de los separadores:

• "Hoy" → mensajes del día actual del visitante.
• "Ayer" → día anterior.
• Día de semana + fecha → últimos 7 días.
• Fecha completa → más antiguos.

Cada mensaje individual muestra solo la hora (14:30). El separador ya dice qué día es, así que no se repite.

Resumen visual

Así todos ven la hora que les es útil, sin pisarse.

Si la IA no puede responder

Si un día la IA no puede contestar (por ejemplo, porque se han acabado los créditos o falla el proveedor), tus clientes reciben un aviso neutro en su idioma, sin mencionar el motivo. En la sección Si la IA no puede responder puedes añadir un email y/o un teléfono de contacto para que se incluyan en ese aviso. Más detalles en Créditos de IA: avisos y qué pasa si se acaban.