这个品类的数据长什么样
化妆品品类的营销数据主要来源于金融机构合作美妆品牌的官方备案系统、成分供应商公开数据库、电商平台合规商品详情页，以及合作品牌提供的专属营销素材。更新节奏随品牌新品上市、合规政策调整及合作营销活动动态变化，单次更新的文档结构统一包含产品标识、备案编号、成分列表（含浓度标注）、适用肤质分类、功效说明、合规提示、包装规格与计价单位。数据字段多包含明确的单位标识，如成分浓度的百分比、包装容量的毫升/克、价格的元。
这些特征在「模型接入与配置」这一环带来什么约束
化妆品品类的数据包含带浓度标注的成分字段、固定枚举的肤质分类、强制合规提示语，且更新随新品上市、合作营销活动动态调整。这些特征要求模型接入时需配置足够的上下文长度以承载完整的产品文档，确保成分浓度等带单位的数值被完整解析。合规提示语属于金融机构营销的强制展示内容，需配置召回优先级确保其被优先纳入上下文。动态更新的数据源要求配置定时同步机制，避免使用过期备案数据。固定枚举的肤质分类字段，需配置向量召回的字段权重，优先匹配核心业务相关的营销场景。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
maxContext | 8000–12000 字符 | 承载完整的化妆品产品文档，确保成分、合规提示等长文本被完整纳入上下文，适配FastGPT v4.8及以上版本配置规范 |
llmModels | 与OneAPI绑定的模型标识完全一致 | 避免模型标识不匹配导致加载失败，确保调用时能正确路由到目标模型，适配FastGPT v4.8及以上版本配置格式 |
ONEAPI_API_BASE | 与部署的OneAPI服务地址完全一致 | 确保模型请求能正确发送到指定的中转服务，避免路由错误 |
PARSE_FILE_TIMEOUT_SECONDS | 300 秒 | 覆盖化妆品备案文档的解析耗时，避免因文档内容较多导致解析任务超时 |
recallTopK | 前 8–12 条 | 平衡召回的相关性与覆盖度，确保营销内容能覆盖成分、功效、合规等多维度信息 |
similarityThreshold | 0.75–0.85 | 过滤低相关性的召回结果，同时保留合规提示等必要的低相似度文本 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象：配置多个模型后，调用时仅使用
llmModels数组中的第一个模型，或提示模型标识不匹配错误。原因：未将llmModels数组中的模型标识与OneAPI或模型服务商的返回标识完全对齐，或未在配置文件中正确声明所有可用模型。 - 现象：知识库回答出现截断，无法完整展示产品成分或合规提示内容。原因：
maxContext配置值过小，无法承载完整的化妆品产品文档，导致上下文被提前截断。 - 现象：OneAPI接口验证通过，但发起提问后无模型响应。原因：
ONEAPI_API_BASE配置中遗漏了接口路径后缀，或llmModels中指定的模型未在OneAPI服务中完成挂载。
怎么确认配好了
- 登录FastGPT后台的模型管理页面，查看已配置的模型列表与
llmModels数组中的标识是否完全一致。 - 上传单份完整的化妆品产品备案文档，测试解析任务，确认解析耗时未超过配置的
PARSE_FILE_TIMEOUT_SECONDS值。 - 发起包含“成分浓度”“合规提示”关键词的测试提问，查看返回结果是否包含完整的相关字段内容。
- 查看OneAPI的接口调用日志，确认FastGPT发起的请求能正确路由到目标模型服务。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。