这个品类的数据长什么样
燃气营销相关数据主要来自燃气运营方的官方物料，包含三类核心内容：阶梯气价调整通知、开户/续费/储值优惠活动文案、安全用气与客服问答文档。数据更新节奏差异明显：临时营销活动按周或月更新，价目调整通知按季度或年度更新，安全指南每季度迭代。文档结构包含固定字段：活动生效日期、适用行政区域、气价档位（单位为元/立方米）、储值返利比例、安全提示等级，部分长文档包含多段落的场景化说明。
这些特征在「知识库检索与召回」这一环带来什么约束
数据来源分散且更新节奏差异大，要求检索系统支持按标签分类召回，避免不同类型内容混淆。专属字段如适用区域、生效日期、气价档位、储值返利比例，要求检索环节需支持字段级过滤，否则会返回跨区域、过期或不匹配返利比例的无效内容。文档长度跨度大，短则数十字的问答，长则数千字的价目通知，要求分段策略需适配不同长度的文档，避免拆分关键数值或场景信息。临时更新的营销内容需高频增量索引，平衡检索时效性与系统资源消耗。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
召回条数 | 前8条 | 燃气营销内容单条文档长度差异大，过多召回会超出上下文窗口，导致关键信息被截断 |
相似度阈值 | 0.72–0.80 | 燃气相关关键词语义接近但场景不同，如「阶梯气价」与「气价调整」，阈值过低会引入无关结果 |
分段长度 | 800–1200 字符 | 燃气价目通知类文档较长，分段过短会拆分气价档位等关键数值信息，影响检索匹配精度 |
增量更新触发间隔 | 每6小时 | 临时营销活动更新频率高，长期价目表更新频率低，该间隔可平衡更新成本与时效性 |
字段过滤开关 | 开启 | 燃气内容包含「适用区域」「生效日期」等专属字段，需按字段精准召回，避免返回跨区域或过期内容 |
重排返回条数 | 前3条 | 营销内容需优先展示最相关的活动或通知，减少用户筛选成本 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：调用
api/v1/chat/completions接口时，指定知识库标签后未返回对应内容。原因：未在请求体中正确携带kbTags或kbIds参数，或标签名称与知识库配置的标签完全不匹配。 - 现象：代码运行节点的变量选择面板无法显示知识库引用选项。原因：未提前在应用配置中绑定目标知识库，或绑定的知识库未完成首次索引构建。
- 现象：检索结果返回多条内容，但未按匹配度排序。原因：未开启重排功能，或
重排返回条数配置值大于召回条数，导致排序逻辑失效。
怎么确认配好了
- 在应用调试界面上传1条燃气小区专属价目通知文档，开启字段过滤后检索「XX小区气价」，核对结果仅返回该小区相关内容。
- 在知识库管理界面查看增量更新日志，确认临时营销活动文档在配置的
增量更新触发间隔内完成索引更新。 - 调用
api/core/datas接口创建知识库集合，核对返回的id字段与界面显示的集合ID一致。 - 在调试窗口输入查询词，查看检索结果的
score值是否落在配置的相似度阈值区间内。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。