Variables système
Les variables système sont utilisées pendant le runtime d'un agent pour accéder aux données des valeurs de variables, permettant une logique et des réponses dynamiques au sein de l'agent. Les utilisateurs peuvent rapidement référencer des variables en tapant {{ dans les champs de saisie de texte, les composants FlowAgent et les workflows. Lorsque l'agent est en cours d'exécution, les variables système sont automatiquement remplacées par leurs valeurs correctes ; si une valeur n'existe pas, elle sera vide.
Les variables système incluent les variables globales et les variables source utilisateur. Les valeurs des variables système ne peuvent pas être définies par les développeurs ; elles sont automatiquement attribuées par la plateforme GPTBots en fonction de l'environnement d'exécution actuel.
Variables globales
| Nom du champ | Type | Description |
|---|---|---|
| sys_dev_id | string | Identifiant développeur de l'agent |
| sys_agent_id | string | Identifiant de l'agent |
| sys_conversation_id | string | Identifiant de la conversation en cours |
| sys_anonymous_id | string | Identifiant anonyme de l'utilisateur interagissant avec l'agent, généralement l'identifiant utilisateur unique provenant d'une plateforme de canal tierce. Voir Logique de l'identifiant anonyme pour plus de détails. |
| sys_user_id | string | Identifiant utilisateur de la personne interagissant avec l'agent, défini par le développeur comme identifiant utilisateur unique |
| sys_lang | string | Langue utilisée dans le portail utilisateur |
| sys_conversation_source | string | Canal d'intégration de la conversation, tel que WhatsApp, Telegram, etc. Cela correspond au champ source dans les journaux. |
| sys_user_message_count | number | Nombre total de messages envoyés par l'utilisateur dans la conversation en cours |
Toutes les variables globales sont automatiquement attribuées par la plateforme GPTBots ; aucune attribution manuelle n'est requise.
Variables source utilisateur
Lorsque les utilisateurs envoient des messages via des navigateurs, WhatsApp, LINE et d'autres canaux, la plateforme source utilisateur fait référence à ce canal. Les valeurs des variables de la plateforme source utilisateur diffèrent selon le canal utilisé. Par conséquent, lors de l'utilisation de variables de la plateforme source utilisateur dans un agent, soyez attentif aux différences entre les plateformes.
La plateforme GPTBots continuera à prendre en charge davantage de variables de plateformes source utilisateur, telles que Telegram, Facebook, etc.
Variables navigateur
Les variables navigateur sont automatiquement obtenues et attribuées par la plateforme GPTBots lorsque les utilisateurs accèdent à des pages partagées, des espaces de travail, etc., via un navigateur. Aucune attribution manuelle n'est requise. Lorsque les utilisateurs envoient des messages via API, WhatsApp, LINE et d'autres canaux, les variables navigateur seront vides.
| Nom du champ | Type | Description |
|---|---|---|
| browser_info | string | Nom du navigateur |
| browser_lang | string | Langue actuellement utilisée par le navigateur |
| browser_os | string | Système d'exploitation |
| browser_timezone | string | Fuseau horaire |
| browser_region | string | Pays ou région |
| browser_current_url | string | URL de la page en cours |
| browser_source_url | string | URL de la page référente |
| browser_duration_of_stay | number | Durée de séjour sur la page en cours |
Propriétés WhatsApp
Les propriétés WhatsApp sont automatiquement obtenues et attribuées par la plateforme GPTBots uniquement lorsque les utilisateurs envoient des messages via le canal WhatsApp. Aucune attribution manuelle n'est requise.
| Nom du champ | Type | Description |
|---|---|---|
| wa_user_name | string | Surnom ou nom d'affichage de l'utilisateur WhatsApp |
| wa_user_id | string | Identifiant unique de l'utilisateur WhatsApp, généralement basé sur le numéro de téléphone de l'utilisateur (par exemple, suffixe de numéro de téléphone international @c.us) |
Propriétés Telegram
Les propriétés Telegram sont automatiquement obtenues et attribuées par la plateforme GPTBots uniquement lorsque les utilisateurs envoient des messages via le canal Telegram. Aucune attribution manuelle n'est requise.
| Nom du champ | Type | Description |
|---|---|---|
| tg_user_id | string | Identifiant unique de l'utilisateur Telegram, utilisé pour la distinction interne du système |
| tg_user_name | string | Surnom ou nom d'affichage de l'utilisateur Telegram, par exemple @username |
| tg_lang_code | string | Code de préférence linguistique de l'utilisateur Telegram, tel que en, zh-CN, etc. |
Propriétés LiveChat
Les propriétés LiveChat sont automatiquement obtenues et attribuées par la plateforme GPTBots uniquement lorsque les utilisateurs envoient des messages via le canal LiveChat. Aucune attribution manuelle n'est requise.
| Nom du champ | Type | Description |
|---|---|---|
| lc_org_id | string | Identifiant unique de l'organisation LiveChat |
| lc_chat_id | string | Identifiant unique de la conversation LiveChat, utilisé pour suivre l'ensemble de la conversation |
| lc_thread_id | string | Identifiant unique d'un fil spécifique au sein d'une conversation LiveChat, utilisé pour organiser les sous-thèmes ou les séquences de messages dans la conversation |
| lc_user_id | string | Identifiant unique de l'utilisateur final LiveChat, utilisé pour la distinction interne du système |