用户概述

用户是指 Agent 发起对话的终端用户，GPTBots 支持开发者为不同用户设置唯一身份标识ID，通过该用户IDuser_id可以在不同渠道之间进行用户 身份关联，实现跨渠道用户身份合并、 通过 Tools 实现业务业务查询、维护用户属性和聊天记录等。

定义

用户

用户是指与 Agent 产生对话的终端用户。

用户ID（user_id）

由企业开发者为终端用户所赋予的身份唯一标识ID，通过 API 接口支持开发者为某个匿名ID设置UserId。UseId 的使用场景和高级用法请参考设置用户ID。

• userId＞匿名ID
• 多个匿名ID可以同时属于一个userId。

匿名ID（anonymous_id）

用户在三方平台（如：Telegram、WhatsApp、LINE等）与 Agent 进行对话时，GPTBots 会使用该三方平台的用户惟一标识符作为anonymous_id。 匿名ID的生成逻辑请参考[匿名ID取值逻辑](## 匿名ID取值逻辑)。

三方平台

GPTBots 平台当前支持将 Agent 集成至众多三方平台，包含：intercom 、webchat、 livechat 、 telegram 、 WhatsApp 等

对话ID（conversation_id）

对话ID 即conversationID用于标识用户与Agent的一次对话场景，是不同业务场景隔离的最小单位（通常包含多个消息ID）。

• conversationID 的自动过期时间为 60分钟,但通过 API 渠道生成的conversationID 没有过期时间。
• 三方平台和部件气泡等渠道所生成的conversationID在过期后会再次生成一个全新的conversationID开启一轮新对话。

消息ID（message_id）

消息ID 即messageID用于标识 Agent 与用户的一次对话消息，是 Agent 与用户的一次对话的最小单位。

• messageID 是由 GPTBots 平台生成的，开发者无法自定义messageID。
• messageID 归属于conversationID，一个 conversationID通常包含多个messageID。

对话ID（conversation_id）的生成原理

当用户通过三方平台与 Agent 发起对话时，系统会根据用户所在的三方平台，为用户生成的匿名ID，并基于匿名ID自动生成conversationID用于承载用户与 Agent 的一轮对话。

• 开发者通过 API 方式使用时，必须先生成conversationID，再传入conversationID参数方可发起与 Agent 的对话。
• 非 API 的其他渠道平台，GPTBots 会自动生成conversationID，生成的具体业务流程如下：
  

三方平台匿名ID（anonymous_id）取值逻辑

GPTBots内置渠道匿名ID（anonymous_id）取值逻辑

GPTBots 平台对话ID（conversation_id）来源字段值列表

对话ID（conversation_id）由 agent_id 和 user_id / anonymous_id 生成，不同的渠道的用户所生成的对话ID的类型会被标记为不同的来源字段值。通过来源字段值可以分渠道查询聊天记录数据。