这个版本改了什么
包含重要更新、新增内容、优化与修复。重要更新:知识库导入数据API变更,新增chunkSettingMode、chunkSplitMode、indexSize可选参数。新增内容:知识库分块支持单独配置分块大小与索引大小,支持超大分块;新增自定义分隔符预设与换行符分割功能;外部变量改名为自定义变量,支持测试调试,分享链接中隐藏该变量;集合同步支持同步修改标题;团队成员管理重构,抽离主流IM SSO并支持自定义SSO接入,完善外部成员同步;支持oceanbase向量数据库,需配置环境变量OCEANBASE_URL;新增基于mistral-ocr与miner-u的PDF解析示例。优化项包括:导出对话日志支持导出成员名;优化邀请链接交互;无SSL证书复制失败时弹出手动复制提示;未内置ai proxy渠道可正常展示名称;升级nextjs版本至14.2.25;工作流节点数组字符串类型自动适配string输入,数组类型自动解析string输入为JSON;AI proxy日志优化,仅保留最后一份错误日志;优化个人信息与通知展示、模型测试loading动画;调整分块算法,增强跨处理符号连续性,代码块与表格分块使用LLM模型上下文作为分块大小以保证完整性。修复项包括:修复飞书和语雀知识库无法同步的问题;修复渠道测试时自定义请求地址优先的逻辑异常;修复语音识别模型测试未启用模型时的异常;修复管理员配置系统插件含其他应用时的鉴权异常;修复移除TTS自定义请求地址时需填写requestAuth字段的问题。
升级前要确认的事
可直接升级至v4.9.3,v4.9.2存在工作流数据类型转化错误。需提前做好数据库备份。使用了SSO或成员同步的商业版用户,且对接钉钉、企微的,需迁移现有SSO相关配置。需确认config.json文件中的systemEnv.pgHNSWEfSearch参数是否存在,商业版用户需确认后台系统配置-基础配置的相关项。
升级步骤(照做)
- 做好数据库备份。
- SSO迁移:使用SSO或成员同步的商业版用户,对接钉钉、企微的,先复制备份原商业版后台的相关配置项(如企微的AppId、Secret),再进行镜像升级;参考SSO文档部署sso-service并配置环境变量;升级镜像后,使用企微组织架构同步的用户需在商业版后台切换团队模式为“同步模式”。
- 配置参数变更:修改config.json文件中systemEnv.pgHNSWEfSearch参数名为hnswEfSearch;商业版用户升级镜像后,直接在后台系统配置-基础配置中进行变更。
- 更新镜像:更新FastGPT镜像tag为v4.9.2,更新FastGPT商业版镜像tag为v4.9.2,Sandbox镜像可不更新,AIProxy镜像修改为registry.cn-hangzhou.aliyuncs.com/labring/aiproxy:v0.1.4。
升级后怎么验证
可通过以下场景验证升级效果:验证知识库导入接口新增的三个参数是否生效;验证知识库分块配置、自定义分隔符功能是否正常;验证SSO及成员同步功能(针对商业版)是否正常;验证工作流节点数组类型处理逻辑是否正常;验证修复的飞书/语雀知识库同步、渠道测试、语音识别测试等问题是否解决;验证各优化项如对话日志导出成员名、邀请链接交互等功能是否正常。
来源: FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 部署与升级 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。