这个品类的数据长什么样
本品类数据主要来自设计历史文件、器件与材料批次台账、MES系统、洁净环境监测设备、灭菌设备及检验校准系统。日常文档包含生产工艺规程、批生产记录、洁净区环境记录、灭菌批记录、检验报告、软件版本记录、不良事件与追溯资料。数据更新以每批产品或每台设备为单位，同时按固定环境监测计划同步更新。文档字段包含关键材料唯一标识、灭菌参数、洁净区温湿度、批次号、软件版本号等，部分文档需关联多组批次与监测数据。
这些特征在「文档解析与分块」这一环带来什么约束
本品类数据的高频更新、多源关联与强合规要求，对文档解析与分块带来多重约束。单批产品关联多组台账与监测数据，分块需保留批次与对应参数的上下文关联，避免拆分后无法追溯。关键字段如唯一标识、灭菌参数、洁净区温湿度需完整提取，分块边界需匹配文档内的批次节点，防止关键信息被截断。高频更新的单批文档需适配快速解析，避免过长分块导致的重解析资源浪费。部分文档需关联不良事件与追溯资料，分块时需保留跨文档的关联逻辑入口。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
chunkSize | 800–1200 字符 | 本品类文档包含多组关联字段，该区间可保留单批次关键参数与上下文，避免关键信息被截断 |
chunkSplitter | 按段落+语义分块 | 适配本品类文档的批次节点与字段结构，避免跨批次拆分内容 |
customPdfParse | 启用 | 适配本品类包含多页关联台账的PDF文档，可保留跨页的字段关联关系 |
PARSE_FILE_TIMEOUT_SECONDS | 600 秒 | 本品类部分灭菌批记录与追溯资料包含多页数据，该时长可覆盖完整解析流程 |
chunkSettingMode | 手动配置 | 针对单批文档的字段密度调整分块参数，适配不同类型的生产与监测文档 |
UPLOAD_FILE_MAX_SIZE | 1000 MB | 适配本品类包含多页灭菌记录与追溯资料的大型PDF文档 |
容易做错的三处
- 现象：上传灭菌批记录PDF后，解析结果中references字段为空。原因：未配置
customPdfParse适配多字段关联文档，默认解析逻辑未提取引用类字段。 - 现象：在FastGPT v4.17.0 中修改分块默认最大设置后，知识库上传仍使用原参数。原因：误修改了非核心配置文件，未在
chunkSettingMode中同步更新手动配置项。 - 现象：通过HTTP调用解析脚本上传图片后，解析结果未包含图片文本内容。原因：未在调用参数中指定图片解析模式，默认仅解析文本类文档。
怎么确认配好了
- 上传一份包含批次号与灭菌参数的测试PDF，查看解析结果中是否完整提取了关键字段。
- 进入知识库配置页面，确认
chunkSize的设置值与手动配置的参数一致。 - 上传一份超过500 MB的测试文档，确认解析任务未触发
UPLOAD_FILE_MAX_SIZE限制报错。 - 调用HTTP解析接口，传入包含图片的测试文件，确认返回结果包含图片提取的文本内容。
文中的配置项名称与取值区间需以所用版本的实际界面与文档为准。