Variables del sistema

Las variables del sistema se utilizan durante el tiempo de ejecución de un agente para acceder a los valores de las variables, lo que permite implementar lógica y generar respuestas dinámicas dentro del agente. Se puede hacer referencia a las variables escribiendo {{ en campos de entrada de texto, componentes de FlowAgent y flujos de trabajo. Cuando el agente está en ejecución, las variables del sistema se sustituyen automáticamente por los valores correspondientes; si no existe un valor, la variable se mostrará vacía.
Las variables del sistema incluyen variables globales y variables de origen del usuario. Los valores de las variables del sistema no pueden ser establecidos por los desarrolladores; la plataforma GPTBots los asigna automáticamente en función del entorno de ejecución actual.

Variables globales

Nombre del campo	Tipo	Descripción
sys_dev_id	string	El ID de desarrollador del agente
sys_agent_id	string	El ID del agente
sys_conversation_id	string	El ID de la conversación actual
sys_anonymous_id	string	El ID anónimo del usuario que interactúa con el agente; normalmente, el identificador único del usuario procedente de un canal de terceros. Para obtener más información, consulte Lógica del ID anónimo.
sys_user_id	string	El ID de usuario de la persona que interactúa con el agente, definido por el desarrollador como identificador único de usuario
sys_lang	string	El idioma utilizado en el portal de usuario
sys_conversation_source	string	El canal de integración de la conversación, como WhatsApp, Telegram, etc. Esto coincide con el campo `source` en los registros.
sys_user_message_count	number	El número total de mensajes enviados por el usuario en la conversación actual

Todas las variables globales se asignan automáticamente por la plataforma GPTBots; no se requiere asignación manual.

Variables de origen del usuario

Cuando los usuarios envían mensajes a través de navegadores, WhatsApp, LINE y otros canales, el origen del usuario corresponde a ese canal. Los valores de las variables de la plataforma de origen del usuario difieren en función del canal utilizado. Por lo tanto, al utilizar variables de la plataforma de origen del usuario en un agente, se deben tener en cuenta las diferencias entre plataformas.

La plataforma GPTBots seguirá incorporando compatibilidad con más variables de plataformas de origen del usuario, como Telegram, Facebook, etc.

Variables del navegador

La plataforma GPTBots obtiene y asigna automáticamente las variables del navegador cuando los usuarios acceden a páginas compartidas, espacios de trabajo, etc., a través de un navegador. No se requiere asignación manual. Cuando los usuarios envían mensajes mediante la API, WhatsApp, LINE y otros canales, las variables del navegador estarán vacías.

Nombre del campo	Tipo	Descripción
browser_info	string	Nombre del navegador
browser_lang	string	Idioma actual utilizado por el navegador
browser_os	string	Sistema operativo
browser_timezone	string	Zona horaria
browser_region	string	País o región
browser_current_url	string	URL de la página actual
browser_source_url	string	URL de la página de referencia
browser_duration_of_stay	number	Duración de la estancia en la página actual

Propiedades de WhatsApp

Las propiedades de WhatsApp las obtiene y asigna automáticamente la plataforma GPTBots únicamente cuando los usuarios envían mensajes mediante el canal de WhatsApp. No se requiere asignación manual.

Nombre del campo	Tipo	Descripción
wa_user_name	string	Apodo o nombre para mostrar del usuario de WhatsApp
wa_user_id	string	Identificador único del usuario de WhatsApp, normalmente basado en el número de teléfono del usuario (p. ej., sufijo de número de teléfono internacional @c.us)

Propiedades de Telegram

Las propiedades de Telegram las obtiene y asigna automáticamente la plataforma GPTBots únicamente cuando los usuarios envían mensajes mediante el canal de Telegram. No se requiere asignación manual.

Nombre del campo	Tipo	Descripción
tg_user_id	string	Identificador único del usuario de Telegram, utilizado para la distinción interna del sistema
tg_user_name	string	Apodo o nombre para mostrar del usuario de Telegram, p. ej., @username
tg_lang_code	string	Código de preferencia de idioma del usuario de Telegram, por ejemplo, en o zh-CN.

Propiedades de LiveChat

Las propiedades de LiveChat las obtiene y asigna automáticamente la plataforma GPTBots únicamente cuando los usuarios envían mensajes mediante el canal de LiveChat. No se requiere asignación manual.

Nombre del campo	Tipo	Descripción
lc_org_id	string	Identificador único de la organización de LiveChat
lc_chat_id	string	Identificador único de la conversación de LiveChat, utilizado para realizar el seguimiento de toda la conversación
lc_thread_id	string	Identificador único de un hilo específico dentro de una conversación de LiveChat, utilizado para organizar subtemas o secuencias de mensajes dentro de la conversación
lc_user_id	string	Identificador único del usuario final de LiveChat, utilizado para la distinción interna del sistema