Vue d'ensemble des utilisateurs

Les utilisateurs désignent les utilisateurs finaux qui initient des conversations avec les Agents/workflows. GPTBots permet aux développeurs d'attribuer des identifiants uniques à différents utilisateurs. Grâce à cet ID utilisateur (user_id), les identités peuvent être reliées entre différents canaux, permettant la consolidation d'identité cross-canal, les requêtes métier via les Outils, ainsi que la gestion des attributs et historiques de discussion des utilisateurs.

Les informations CDP (Customer Data Platform) de l'utilisateur sont stockées sous chaque Agent/workflow, les données étant isolées pour un même utilisateur sur différents Agents/Workflows.

用户体系示意图

flowchart LR
 subgraph Col1["Plateforme source"]
        LC["Livechat"]
        IC["Intercom"]
        WG[" Widget "]
        TG["Telegram"]
  end
 subgraph Col2_5["Sous-canal de la plateforme source"]
        tgb01["TGBOT01"]
        tgb02["TGBOT02"]
  end
 subgraph Col2["ID anonyme"]
        a1["lc0001"]
        a2["ic0001"]
        a3["wg0001"]
        tga1["tb0001"]
        tga2["tg0001"]
  end
 subgraph Col3["UserId"]
        U1["ABC123"]
        U2["ABC456"]
  end
 subgraph Col4["ConversationId"]
        c1["c001"]
        c2["c002"]
        c3["c003"]
        c4["c004"]
        c5["c005"]
  end
 subgraph Col5["Agent/Workflow"]
        Bot["Agent
        Workflow"]
  end
    LC -- Générer un ID anonyme --> a1
    IC -- Générer un ID anonyme --> a2
    WG -- Générer un ID anonyme --> a3
    TG -- Utilisateur du sous-canal --> tgb01 & tgb02
    tgb01 -- Générer un ID anonyme --> tga1
    tgb02 -- Générer un ID anonyme --> tga2
    a1 -- Définir user_id --> U1
    a2 -- Définir user_id --> U1
    a3 -- Définir user_id --> U2
    tga1 -- Définir user_id --> U2
    tga2 -- Définir user_id --> U2
    U1 -- Générer un nouvel ID de conversation --> c1
    U1 -- Générer un nouvel ID de conversation --> c2
    U2 -- Générer un nouvel ID de conversation --> c3
    U2 -- Utiliser l'ID de conversation existant --> c4
    c4 -- Si expiré (>60 minutes)
    Générer un nouvel ID de conversation --> c5
    c1 --> Bot
    c2 --> Bot
    c3 --> Bot
    c4 --> Bot
    c5 --> Bot

     LC:::redStyle
     IC:::blueStyle
     WG:::greenStyle
     TG:::purpleStyle
     tgb01:::purpleStyle
     tgb02:::purpleStyle
     a1:::redStyle
     a2:::blueStyle
     a3:::greenStyle
     tga1:::purpleStyle
     tga2:::purpleStyle
     U1:::userGray
     U2:::userGray
     c1:::redStyle
     c2:::blueStyle
     c3:::greenStyle
     c4:::purpleStyle
     c5:::purpleStyle
    classDef userGray fill:#f5f5f5,stroke:#e6e6e6,color:#222
    classDef redStyle fill:#ffd6d6,stroke:#ffbdbd,color:#222
    classDef blueStyle fill:#dff0ff,stroke:#cfeaff,color:#222
    classDef greenStyle fill:#ecffd9,stroke:#d5ffb3,color:#222
    classDef purpleStyle fill:#f1e0ff,stroke:#e1c7ff,color:#222
    style Col1 stroke:#757575

• L'ID anonyme (anonymous_id) est généré automatiquement par le service système GPTBots en fonction de la plateforme source de l'utilisateur.
• La définition d'un user_id est facultative. Les développeurs peuvent choisir de définir un user_id selon leurs besoins métier pour permettre l'association d'identité et le partage d'attributs entre différents canaux.

Définitions

Utilisateur

Un utilisateur désigne un utilisateur final qui interagit avec un Agent.

ID utilisateur (user_id)

Identifiant unique attribué aux utilisateurs finaux par les développeurs d'entreprise. Via l'API, les développeurs peuvent définir un UserId pour un anonymous_id. Pour les scénarios d'utilisation et les applications avancées de UserId, veuillez consulter Définir l'ID utilisateur.

• Le user_id prévaut sur le anonymous_id
• Plusieurs valeurs anonymous_id peuvent être associées simultanément à un même user_id

ID anonyme (anonymous_id)

Lorsque les utilisateurs interagissent avec un Agent via des plateformes tierces (telles que Telegram, WhatsApp, LINE, etc.), GPTBots utilise l'identifiant unique de la plateforme comme anonymous_id. Pour plus de détails sur la logique de génération des IDs anonymes, veuillez consulter [Logique de génération des IDs anonymes](## Anonymous ID Generation Logic).

Plateformes tierces

La plateforme GPTBots prend actuellement en charge l'intégration des Agents avec de nombreuses plateformes tierces, dont Intercom, Webchat, LiveChat, Telegram, WhatsApp, etc.

ID de conversation (conversation_id)

L'ID de conversation (conversation_id) est un identifiant unique généré conjointement par l'Agent, le type de conversation et le user_id (ou anonymous_id). Il sert d'unité minimale pour isoler différents scénarios métier (contenant généralement plusieurs IDs de message).

• Le conversation_id expire automatiquement après 60 minutes, sauf pour ceux générés via le canal API, qui n'ont pas de limite de temps.
• Pour les plateformes tierces et les canaux widget, lorsqu'un conversation_id expire, un nouveau est généré pour démarrer une nouvelle conversation.

ID de message (message_id)

L'ID de message (message_id) identifie un échange de message unique entre un Agent et un utilisateur, représentant l'unité minimale de conversation.

• Le message_id est généré par la plateforme GPTBots et ne peut pas être personnalisé par les développeurs.
• Le message_id appartient à un conversation_id, un même conversation_id contenant généralement plusieurs message_id.

Type de conversation

Le type de conversation (conversation_type) identifie le scénario dans lequel un utilisateur initie une conversation, tel que Espace de travail-Workflow, WhatsApp, API, Espace de travail-Recherche, etc.

Principe de génération de l'ID de conversation

Lorsque les utilisateurs initient des conversations avec un Agent via des plateformes tierces, le système génère un anonymous_id basé sur la plateforme de l'utilisateur, puis crée automatiquement un conversation_id basé sur cet anonymous_id pour contenir un échange de dialogue entre l'utilisateur et l'Agent.

• Lors de l'utilisation de l'API, les développeurs doivent d'abord générer un conversation_id avant d'initier des conversations avec un Agent/Workflow.
• Pour les canaux hors API, GPTBots génère automatiquement le conversation_id.

Logique de génération des IDs anonymes

Les IDs anonymes servent à identifier de façon unique les utilisateurs sur les différentes plateformes et canaux intégrés. Le tableau suivant décrit la logique de génération des IDs anonymes pour chaque plateforme :

Logique de l'ID anonyme pour les canaux intégrés GPTBots

Pour les canaux intégrés GPTBots, les IDs anonymes sont générés à partir de l'empreinte du navigateur :

Lorsqu'un utilisateur est connecté à la plateforme GPTBots, son ID de compte GPTBots est automatiquement défini comme user_id et lié à l'anonymous_id (ID d'empreinte navigateur).

Types de conversation et IDs de source

• Type de conversation (conversation_type) : Identifie le canal d'intégration par lequel une conversation est initiée (ex. : Espace de travail, API, Iframe, WhatsApp, LINE, etc.). Ce champ permet de filtrer les données de logs par type de canal.
• ID de source (source_id) : Identifie le sous-type du canal d'intégration (ex. : différents IDs de canal LINE, différents IDs de bot Telegram). Ce champ permet de filtrer les logs par sous-canal.

⚠️ Remarque : Les valeurs de champ dans les tableaux ci-dessus peuvent être utilisées comme critères de filtre lors de la consultation des données de conversation via l'API : Obtenir la liste des conversations.
Pour les plateformes tierces telles que LINE et Telegram prenant en charge plusieurs sous-canaux, l'"Agent-Log" permet un filtrage à deux niveaux par type de conversation.