这个品类的数据长什么样
该知识库服务于金融、保险、理财行业的白色家电营销获客场景，数据源主要包括品牌官方发布的产品规格书、营销推广文案、安装维护手册。更新节奏随新品发布、促销活动调整，无固定周期，新品上线时会批量更新全量参数内容，促销活动前会临时调整促销相关的话术与价格信息。文档按产品型号拆分归类，单份文档包含结构化参数字段与半结构化营销话术，参数字段包括型号、能效等级、外形尺寸、额定功率、建议零售价，对应单位分别为无、等级、毫米、瓦特、元。营销话术部分包含场景化使用建议、促销活动说明与用户常见问题解答，文档格式以PDF、Word为主。
这些特征在「知识库检索与召回」这一环带来什么约束
由于白色家电按型号拆分文档且包含结构化参数与营销话术，检索时需精准匹配用户提及的家电型号，避免跨型号召回无关内容。参数字段带有明确单位，检索时需保留单位关联，防止出现参数混淆的情况。营销内容随促销活动临时更新，需定期触发向量库重新构建，确保召回内容的时效性。不同型号的营销话术差异较大，需按型号维度分组召回，提升匹配精度。部分文档包含场景化使用建议，检索时需区分产品参数与使用场景内容，避免召回内容偏离营销获客目标。同时，白色家电的营销物料常包含促销期限标注，召回后需过滤已过期的促销文案，确保输出内容合规有效。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
召回条数 | 前6-8条 | 白色家电单型号营销内容较多，过多召回会超出上下文窗口，过少则无法覆盖完整参数与话术 |
相似度阈值 | 0.72-0.78 | 需区分精准的型号参数匹配与泛化的营销场景匹配，该区间可过滤低相关的跨型号内容 |
分段长度 | 800-1200字符 | 白色家电文档包含参数块与长文本营销话术，该分段长度可保留参数完整性与话术连贯性 |
重排返回条数 | 前3-4条 | 聚焦核心营销内容与关键参数，避免冗余信息干扰生成器输出 |
PARSE_FILE_TIMEOUT_SECONDS | 300秒 | 部分产品手册文档篇幅较长，需预留足够解析时间 |
maxContext | 8000字符 | 适配多型号参数与营销话术的上下文拼接需求，避免截断核心信息 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：调用
/api/v1/chat/completions接口时，指定appId后无法检索到知识库上传的内容。原因：未将目标知识库关联至对应appId，或接口请求中未携带正确的知识库绑定参数，或知识库未完成全量向量索引构建。 - 现象：生成的回答未附带检索段落的来源文档信息。原因：未开启知识库的溯源展示配置，或未在系统提示词中配置溯源内容的输出格式。
- 现象：检索召回的内容仅包含文本，未附带文档内的图片信息。原因：未启用文档解析阶段的图片向量化与关联存储设置，或生成提示词未明确要求引用图片内容。
怎么确认配好了
- 上传单款白色家电的产品手册与营销文案，查看解析后的文本分段与字段提取结果，确认型号、参数、营销话术被正确拆分归类。
- 发起包含具体家电型号与参数需求的查询，核对召回结果的匹配度与条数，调整配置项至符合业务场景的取值。
- 开启溯源展示配置后发起相同查询，确认回答中附带了检索段落的来源文档标识。
- 调用指定appId的接口，验证返回结果包含知识库内的白色家电相关内容，确认关联关系生效。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。