用户概述

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

定义

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

匿名ID：
用户在三方平台（如：Telegram、WhatsApp、LINE等）与 Agent 进行对话时，GPTBots 会使用该三方平台为用户生成的平台用户ID作为匿名ID。

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

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

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

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

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

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

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

对话ID的生成原理

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

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