故障排查GitHub issue2 分钟阅读排错/错误码

FastGPT 对话日志 chatId 展示需求与 API 核对方法

chatId 是应用内的会话标识,可用于核对请求、历史消息和日志。对话日志页面增加 chatId 的诉求来自历史 Issue;排查时先通过官方 API 确认会话标识及归属。

chatId 是应用内的会话标识,可用于核对请求、历史消息和日志。对话日志页面增加 chatId 的诉求来自历史 Issue;排查时先通过官方 API 确认会话标识及归属。

历史范围与已知事实

Issue #648 于 2023 年 12 月提出在日志页面展示 chatId,原记录只提供功能需求,具体界面开关和实现版本仍待对应版本证据确认。官方对话接口appIdchatId 和消息级 dataId 定义为不同层级的标识。

核对步骤

  1. 在业务后端为每段会话保存独立 chatId,并记录所属 appId 与业务用户。用户身份由业务登录与权限校验确定。
  2. 用该应用的凭证查询会话列表,再按 appIdchatId 读取消息,核对问题、回复及时间。
  3. 若使用 HTTP 节点记录标识,在正式会话中引用 chatId。官方HTTP 节点文档 说明测试模式下该系统变量缺省,因此应使用真实发布渠道复测。
  4. 对比当前版本的日志页面截图和实际接口响应,明确需求属于“界面展示标识”还是“后端定位会话”。需要定制展示时,以已核验的接口字段为依据。

验证结果

创建两个独立会话,确认各自的消息可由保存的 chatId 找回,并在业务后端验证跨用户访问会被拒绝。保留请求参数、版本和脱敏响应,作为界面问题的复现依据。