在 FastGPT v4.17.2 中，对话记录留存可以走接口拉取、导出、外部系统归档三条路径，它们各自解决不同的问题。接口拉取适合按需读取与程序化处理，导出适合一次性或周期性带走数据，外部系统归档适合把记录纳入既有存储与治理体系。选择之前先确认调用方式、字段范围与权限边界，再决定由谁承担长期保存责任。
接口拉取：按需读取与程序化处理的边界
接口拉取指通过 openapi/chat 相关接口获取对话记录，适合需要把记录接入自有程序、做二次处理或按条件查询的场景。它的边界在于调用方要自行处理分页、时间范围与字段解析，记录是否长期保存取决于调用方是否落库。使用前需要核对接口的鉴权方式、请求参数与返回结构，确认返回内容是否包含所需的对话标识、消息角色与时间信息。若记录量较大，还要考虑分页遍历的完整性与重复读取的处理。接口拉取不替代存储，它提供的是读取通道，调用方需要明确自己是否承担保存责任，以及保存周期与清理策略。对于需要实时同步或按事件触发的场景，接口拉取可以作为数据入口，但后续的持久化与检索能力由调用方自行建设。
三种留存方式比较
下表按方案、适用条件、需要核对的点三个维度，对接口拉取、导出、外部系统归档做并列比较。表中内容只描述方式本身的边界，不涉及具体客户、效果数字或价格。
| 方案 | 适用条件 | 需要核对的点 |
|---|---|---|
| 接口拉取 | 需要程序化读取、按条件查询或实时同步对话记录 | 鉴权方式、分页与时间范围、返回字段、调用方是否落库 |
| 导出 | 需要一次性或周期性带走记录，用于离线查看或交接 | 导出范围、文件格式、字段完整性、导出频率与存放位置 |
| 外部系统归档 | 已有日志、数据仓库或工单系统，需要统一治理记录 | 对接方式、字段映射、写入权限、保留周期与访问控制 |
| 接口拉取加外部系统归档 | 既要程序化读取，又要长期保存与统一检索 | 两段链路的衔接、去重规则、失败重试与数据一致性 |
比较时先看记录要解决什么问题：临时查看、程序处理还是长期治理。三种方式可以组合，组合时要把读取链路与保存链路分开核对，避免把读取通道当成存储方案。
导出与外部系统归档：带走与纳入治理的边界
导出指把对话记录以文件或数据集形式取出，适合离线查看、交接或迁移场景。它的边界在于导出是一次性动作，导出后的文件由使用方自行保管，FastGPT 侧不继续承担该文件的保存与更新。使用前需要核对导出范围、字段是否完整、格式是否便于后续读取，以及导出频率与存放位置。外部系统归档指把对话记录写入既有的日志系统、数据仓库或工单系统，适合需要统一检索、保留周期管理与访问控制的组织。它的边界在于对接方式与字段映射需要双方确认，写入权限、保留周期与访问控制由外部系统决定。归档之后，记录的查询与治理在外部系统进行，FastGPT 侧只负责提供数据来源。若同时使用接口拉取与外部系统归档，需要核对两段链路的衔接、去重规则与失败重试，确保记录不重复也不遗漏。