ユーザー概要

ユーザーとは、Agent/workflowとの対話を開始するエンドユーザーを指します。GPTBotsは、開発者が異なるユーザーに対して一意の識別ID（user_id）を設定することをサポートしています。このuser_idを通じて、異なるチャネル間でユーザーのアイデンティティを関連付け、クロスチャネルでのユーザー識別の統合、Toolsを介したビジネスクエリの実行、ユーザー属性やチャット履歴の管理などが可能になります。

ユーザーのCDP情報はAgent/workflowの下に保存され、同一ユーザーであっても異なるAgent/Workflow間でデータは相互に分離されています。

ユーザーシステム概要図

flowchart LR
 subgraph Col1["ユーザーソースプラットフォーム"]
        LC["Livechat"]
        IC["Intercom"]
        WG[" Widget "]
        TG["Telegram"]
  end
 subgraph Col2_5["ソースプラットフォームのサブChannel"]
        tgb01["TGBOT01"]
        tgb02["TGBOT02"]
  end
 subgraph Col2["匿名 ID"]
        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 -- 匿名IDを自動生成 --> a1
    IC -- 匿名IDを自動生成 --> a2
    WG -- 匿名IDを自動生成 --> a3
    TG -- サブchannelからのユーザー --> tgb01 & tgb02
    tgb01 -- 匿名IDを自動生成 --> tga1
    tgb02 -- 匿名IDを自動生成 --> tga2
    a1 -- user_idを設定 --> U1
    a2 -- user_idを設定 --> U1
    a3 -- user_idを設定 --> U2
    tga1 -- user_idを設定 --> U2
    tga2 -- user_idを設定 --> U2
    U1 -- 新規会話IDを生成 --> c1
    U1 -- 新規会話IDを生成 --> c2
    U2 -- 新規会話IDを生成 --> c3
    U2 -- 既存の会話IDを使用 --> c4
    c4 -- 期限切れの場合（＞60分）
    新規会話IDを自動生成 --> 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

• 匿名ID（anonymous_id）は、GPTBotsシステムサービスによってユーザーの利用プラットフォームに基づいて自動的に生成されます。
• user_idの設定はオプションです。開発者は、ビジネス要件に応じて、異なるチャネル間でのユーザー識別の関連付けやユーザー属性の共有を実現するために、ユーザーにuser_idを設定するかどうかを決定できます。

定義

ユーザー

エージェントと対話を行うエンドユーザーを指します。

ユーザーID（user_id）

企業の開発者がエンドユーザーに付与する一意の識別子です。API経由で特定の匿名IDにUserIdを設定することができます。UserIdの利用シーンや高度な使用方法についてはユーザーIDの設定をご参照ください。

• user_idはanonymous_idよりも優先度が高くなります
• 複数のanonymous_idを1つのuser_idに紐付けることが可能です

匿名ID（anonymous_id）

ユーザーがサードパーティプラットフォーム（Telegram、WhatsApp、LINEなど）でエージェントと対話する際、GPTBotsはそのプラットフォームのユーザー固有識別子をanonymous_idとして使用します。匿名IDの生成ロジックについては匿名IDの値設定ロジックをご参照ください。

サードパーティプラットフォーム

GPTBotsプラットフォームは現在、多数のサードパーティプラットフォームとの連携をサポートしています。Intercom、WebChat、LiveChat、Telegram、WhatsAppなどが含まれます。

会話ID（conversation_id）

会話ID（conversation_id）は、エージェント、会話タイプ、およびuser_id（またはanonymous_id）から生成される一意の識別子です。conversation_idは異なるビジネスシーンを分離する最小単位となり、通常複数のメッセージIDを含みます。

• conversation_idの自動有効期限は60分です。ただし、API経由で生成されたconversation_idには有効期限はありません
• サードパーティプラットフォームやウィジェットバブルなどのチャネルで生成されたconversation_idは、期限切れ後に新しいconversation_idが生成され、新しい対話が開始されます

メッセージID（message_id）

メッセージID（message_id）は、エージェントとユーザー間の1回の対話メッセージを識別するために使用され、対話の最小単位となります。

• message_idはGPTBotsプラットフォームによって生成され、開発者が独自に設定することはできません
• message_idはconversation_idに属し、1つのconversation_idは通常複数のmessage_idを含みます

会話タイプ

会話タイプ（conversation_type）は、ユーザーが会話を開始するシーンを識別するために使用されます。例：ワークスペース-Workflow、WhatsApp、API、ワークスペース-Searchなど。

会話ID（conversation_id）の生成原理

ユーザーがサードパーティプラットフォームを通じてエージェントとの会話を開始すると、システムはそのプラットフォームに基づいてanonymous_idを生成し、そのanonymous_idを基にconversation_idを自動生成して、ユーザーとエージェント間の1回の会話を管理します。

• 開発者がAPI経由で利用する場合は、まずconversation_idを生成してから、エージェント/Workflowとの対話を開始することができます
• API以外のチャネルプラットフォームでは、GPTBotsが自動的にconversation_idを生成します

匿名ID（anonymous_id）の値設定ロジック

GPTBots内蔵チャネルの匿名ID（anonymous_id）設定ロジック

GPTBotsプラットフォームにユーザーがログインしている場合、システムは自動的にその「GPTBotsアカウントID」をuser_idとして設定し、同時にanonymous_id（ブラウザフィンガープリントID）も自動的に関連付けます。

会話タイプ（conversation_type）

会話タイプ（conversation_type）は、ユーザーが会話を開始するシーンを識別し、conversation_typeフィールド値でシーンごとにログデータを検索できます。

⚠️ 注意：表内のフィールド値は、APIで会話リストを取得する際のフィルタ条件として利用できます。
LINEやTelegramなど複数チャネルを追加できるサードパーティプラットフォームでは、「Agent-ログ」で2階層の会話タイプによる絞り込みが可能です。
表内のフィールド値は、ユーザーID更新APIのanonymous_id_sourceフィールド値としても利用できます。