FastGPT V4.9.7版本升级内容与操作指引

这个版本改了什么

本次升级包含新增功能、体验优化与问题修复。新增功能包括：知识库回答段落末尾增加引用；MCP工具支持HTTP Streamable协议；MCP server支持编辑工具名以适配不支持中文名的客户端；工作流右键可自动对齐节点；支持生产环境自定义"config.json"路径；API调用可传递特殊chatId NORECORDHISTORIES跳过历史记录存储；支持Rerank模型按量计费；新增套餐兑换码功能；新增支付宝支付支持；新增短链数据埋点；新增Jina AI模型系统配置。 优化内容包括：Doc2x文档解析增加报错信息捕获与超时时长；调整PG vector查询语句强制使用向量索引；对话时间统计准确返回工作流整体运行时间；从ai_proxy获取音频解析时长；AI模型Token值优先采用API usage，为空时采用GPT3.5的估算方式；优化对话日志list接口适配单个对话框大量对话场景。 修复内容包括：调整文件上传分块大小限制避免超出MongoDB限制；修复使用记录仪表盘无法获取指定成员使用统计的问题；修复仪表盘接口因未考虑时区导致的统计异常；修复LLM模型测试接口无法测试未启用LLM、且会去除模型自定义请求地址的问题；修复Copy app权限问题；限制导出对话记录单条消息上限1000组避免导出失败；修复工作流变量下一段文本仍为工作流变量不触发渲染的问题；修复调试知识库检索模块提示无权操作知识库的问题；修复文本内容提取节点默认值赋值逻辑问题；修复分享链接强制返回嵌套应用中引用内容的问题；修复知识库集合元数据过滤时同名标签使用$and筛选无结果的问题；修复应用列表权限配置可能出现index刷新的问题。

升级前要确认的事

升级前需完成FastGPT相关业务数据的完整备份，确保数据安全。

升级步骤（照做）

1. 更新FastGPT镜像tag: v4.9.7-fix2
2. 更新FastGPT商业版镜像tag: v4.9.7
3. mcp_server无需更新
4. Sandbox无需更新
5. 更新AIProxy镜像tag: v0.1.8

升级后怎么验证

1. 确认各服务镜像版本与指定tag一致
2. 发起知识库问答，验证回答段落末尾是否新增引用内容
3. 调用API时传递chatId为NORECORDHISTORIES，验证未生成历史记录
4. 测试工作流右键对齐节点功能是否正常
5. 测试LLM模型测试接口，验证未启用模型可正常测试且自定义请求地址保留

来源： FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 部署与升级 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。