FastGPT V4.14.8.1版本升级操作与更新说明

版本更新概述

本页面针对FastGPT自部署的V4.14.8.1版本提供升级指导与更新说明，适用于已部署4.14.x系列版本的用户进行版本迭代。本次更新未新增核心功能模块，仅包含两项优化与一项bug修复：其一为优化api文件库接口的返回逻辑，当接口返回的title值缺失时，将自动fallback为url字段作为替代；其二为修复了工作流编排场景下，无法正常获取agent工具版本列表的问题，解决了部分用户在配置工作流时遇到的工具调用异常问题。

升级镜像操作步骤

完成版本升级需按要求调整对应服务的镜像tag，具体操作如下：

调整FastGPT主镜像与商业版镜像的tag为v4.14.8.1，替换原有的镜像版本配置；
更新sandbox服务的镜像tag为v4.14.8，确保沙盒环境与当前主版本兼容；
确认fastgpt-plugin、mcp_server、AIProxy、mongo这四类服务无需更新，保留其当前使用的镜像版本即可，无需额外修改配置；
完成镜像配置修改后，重启所有相关服务，使新的镜像版本生效。

升级注意事项

本次升级过程中需严格遵循指定的镜像tag配置，不可随意替换为其他未验证的版本，否则可能导致服务启动异常或功能异常。若升级后出现工作流中agent工具版本列表无法加载的问题，可优先检查sandbox镜像的tag是否为v4.14.8，以及FastGPT主镜像是否正确使用v4.14.8.1。此外，本次V4.14.8.1版本未涉及环境变量变更，无需额外调整系统的环境变量配置，避免因误改配置引发其他异常。对于已部署的4.14.x系列旧版本，直接按上述步骤替换镜像tag即可完成升级。