这个品类的数据长什么样
焦煤智能尽调报告的数据来源包括国内煤炭工业协会公开监测数据、主产区矿企生产台账、核心港口商检报告及期货交割备案信息。数据更新节奏分多维度：现货出库与港口库存数据每日更新，行业供需周报每周发布，季度性交割质检报告按月更新。文档形态包含单份10至50页的PDF质检尽调文档，以及批量结构化的Excel/CSV台账，核心字段包含矿点名称、生产批次、干基灰分、干基挥发分、全硫含量、发热量、交割等级与出库日期，其中发热量单位为兆焦/千克，全硫含量以干基计，单位为毫克/千克。
这些特征在「部署与升级」这一环带来什么约束
焦煤数据的多源混合结构与差异化更新节奏，要求部署阶段需配置多源数据适配模块，区分每日、每周、月度的同步任务调度规则。单份文档页数跨度大且包含带特定单位的结构化字段，需调整文件解析的超时阈值与分段解析参数，避免长文档解析中断。特定字段的单位要求需在前置清洗环节配置标准化校验规则，防止非标准数值流入知识库。升级阶段需兼容原有定时同步任务的配置迁移，避免因版本更新导致数据同步链路中断，同时需保留历史对话关联的数据源映射关系，防止数据关联逻辑失效。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
PARSE_FILE_TIMEOUT_SECONDS | 600 秒 | 焦煤尽调PDF文档最长可达50页，常规解析时长超出默认阈值 |
UPLOAD_FILE_MAX_SIZE | 1000 MB | 批量焦煤台账Excel文件可能包含多批次历史数据，单文件体积较大 |
TEXT_EMBEDDING_MODEL | 按4.9.0官方推荐的开源文本模型 | 适配4.9.0版本的模型加载逻辑，匹配焦煤数据的字段语义 |
maxContext | 8000–12000 字符 | 尽调报告包含多字段的详细描述，需保留足够上下文用于关联字段查询 |
召回条数 | 前 8 条 | 焦煤数据字段多且业务关联紧密，需召回足够数量的关联条目支撑分析 |
PARSE_SEGMENT_LENGTH | 1500–2000 字符 | 长文档分段需保留字段关联性，避免跨段解析丢失字段对应关系 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：前端对话窗口刷新后对话记录消失，后台管理界面可查完整历史对话，前端无明确报错提示。原因：升级版本时未迁移
chat_history_storage的存储配置，或版本更新重置了默认存储路径，导致前后台对话记录关联逻辑断裂。 - 现象：上传焦煤尽调PDF文档后，解析任务显示超时失败，后台日志返回
504 Gateway Timeout状态码。原因：未调整PARSE_FILE_TIMEOUT_SECONDS配置，默认时长不足以解析最长50页的尽调文档。 - 现象：私有化部署后前端页面底部仍显示官方二维码，无法移除。原因：未修改
FRONTEND_SHOW_QRCODE的配置项为false，或未在部署脚本中覆盖该环境变量。
怎么确认配好了
- 执行单份50页的焦煤尽调PDF解析任务，核对解析后的文档分段是否保留完整字段关联，无跨段丢失的关键信息。
- 触发预设的每日与每周同步任务，核对同步结果是否匹配数据源的更新节奏，无遗漏或重复同步的记录。
- 查看知识库的字段校验日志，确认所有导入的焦煤数据均符合预设的单位与格式要求。
- 升级版本后，登录前端对话界面查看历史对话记录，确认记录完整展示且可正常加载。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。