这个品类的数据长什么样
动力煤研报的数据源主要包括国内煤炭交易所的现货行情数据、行业协会的供需统计报告、券商能源领域研报及港口现货台账。更新节奏覆盖日度现货价格、周度港口库存、月度供需平衡表及季度行业趋势分析。文档结构通常包含核心指标卡片、供需走势图、政策解读板块，字段包含发热量（Q值，单位大卡/千克）、硫分、灰分、港口平仓价、坑口价等，单位多为元/吨。
这些特征在「引用来源与溯源」这一环带来什么约束
动力煤研报的多数据源、多更新频率特征要求溯源时必须明确标注来源类型与发布时间，避免混淆不同周期的行情数据。专业术语与固定字段的存在要求溯源内容需完整保留Q值、单位等关键信息，不能截断导致数据失真。长文档的结构化段落与表格分布，要求溯源需精准定位到具体文本块或表格位置。同时，不同数据源的格式差异，要求溯源逻辑适配结构化表格与自由文本两种内容形态。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
retrieveTopK | 前8-12条 | 动力煤研报的核心数据分散在多个来源，需要足够召回覆盖不同维度的专业内容 |
similarityThreshold | 0.65-0.75 | 动力煤研报存在大量专属专业术语，阈值过低会引入无关文档，过高则可能遗漏核心相关内容 |
referenceMode | fullChunk | 动力煤研报的核心数据多为结构化表格或连贯段落，完整块引用可保留单位、字段名等关键信息 |
showReference | 按场景配置为true或false | 适配不同业务场景下的溯源展示需求，部分轻量化场景可隐藏引用内容 |
referenceFieldWhitelist | ["title", "publishTime", "source", "contentChunk"] | 动力煤研报的溯源需明确标注文档标题、发布时间、来源机构与具体引用的文本内容 |
parseChunkSize | 800-1200字符 | 适配动力煤研报中供需表格与行情分析段落的常规长度，避免分块破坏数据完整性 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：调用API时返回
quote type error错误码。原因：传入的引用变量格式不符合校验规则，或未在referenceFieldWhitelist中配置正确的字段名。 - 现象：返回结果仅展示单个引用文件名。原因：
retrieveTopK参数设置过低，或召回策略未开启多文档关联召回，无法覆盖动力煤研报的多来源核心数据。 - 现象：无法隐藏知识库的引用内容。原因：未将
showReference参数设置为false，或前端渲染逻辑强制展示了引用模块。
怎么确认配好了
- 发起包含动力煤专业术语的测试查询，查看返回结果中是否包含明确的来源文件名、发布时间和引用文本块。
- 调用API接口，检查返回的
references字段是否包含多个符合动力煤研报特征的条目，涵盖交易所数据、券商研报等不同来源类型。 - 传入格式错误的引用变量，验证是否触发
quote type error报错，确认参数校验逻辑正常生效。 - 调整
showReference参数为false后发起查询，确认返回结果中不再包含引用相关的字段与内容。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。