Visión general de variables

Las variables se refieren a valores a los que pueden acceder todos los agentes durante toda la ejecución del agente. Al introducir variables mediante {{, los agentes pueden implementar lógica y respuestas dinámicas. Las variables permiten la personalización y configuración flexibles de los agentes, respuestas personalizadas para distintos usuarios y la activación de diferentes lógicas de negocio en función de los valores de las variables.
alt text
En el agente de GPTBots, las variables se clasifican en variables globales, variables de origen del usuario, atributos de usuario y variables personalizadas.

Variables globales: Se generan automáticamente por la plataforma GPTBots, como el id de conversación, el recuento de conversaciones, la marca de tiempo, etc.
Variables de origen del usuario: Las proporciona la plataforma GPTBots en función del tipo de plataforma (WhatsApp, web, LINE, etc.) desde la que el usuario inicia la conversación, como el apodo del usuario, el id de usuario de la plataforma, etc.
Variables personalizadas: Las definen los desarrolladores y son datos con alcance de sesión válidos únicamente durante una sola conversación, como el dominio del sitio web actual, las preferencias del usuario, etc.
Atributos de usuario: Datos con alcance de usuario definidos por el desarrollador bajo el agente, utilizados para almacenar información relacionada con el usuario, como el id de usuario, el nombre de usuario, el correo electrónico, etc.

mindmap
  root((Tipos de variables))
    Variables globales
      Generadas automáticamente por el sistema de GPTBots
      Ejemplo: id de conversación, marca de tiempo.
      Válidas en todas las conversaciones
    Variables de origen del usuario
      Recuperadas por el sistema de GPTBots según la plataforma del usuario
      Ejemplo: Navegador, WhatsApp, LINE.
      Las variables difieren según el canal de origen
    Atributos de usuario
      Definidos por los desarrolladores
      Ejemplo: Nombre de usuario, género, edad.
      Relativamente fijos, no se modifican con frecuencia
      Datos con alcance de usuario, se pueden almacenar y referenciar de forma permanente
    Variables personalizadas
      Definidas por los desarrolladores
      Ejemplo: Dominio del sitio web actual, estado del usuario.
      Alcance de sesión, valores temporales válidos solo para la conversación actual
      Se pueden configurar mediante API, widget e iframe

Tipo de variable	Definición	Origen	Alcance	Duración	Método de configuración	Ejemplo	Persistente
Variables globales	Variables a nivel de sistema	Generadas automáticamente por GPTBots	Todas las conversaciones y usuarios	Permanente	Generadas por el sistema	id de conversación, marca de tiempo, etc.	✅ Sí
Variables de origen del usuario	Variables a nivel de canal	Recuperadas automáticamente según el canal del usuario	Usuarios dentro del canal específico	Sesión	Asignadas por el sistema	Navegador, WhatsApp, LINE, etc.	❌ No
Atributos de usuario	Variables a nivel de usuario, definidas de forma personalizada por los desarrolladores	Definidas por el desarrollador	Un único usuario, a través de múltiples conversaciones	A largo plazo, actualizables	API	id de usuario, nombre de usuario, correo electrónico, etc.	✅ Sí
Variables personalizadas	Variables a nivel de conversación, definidas de forma personalizada por los desarrolladores	Definidas por el desarrollador	Conversación actual (`conversation_id`)	Alcance de sesión, actualizables	API, Widget, Iframe...	Dominio del sitio web actual, preferencias del usuario, etc.	❌ No