部署与升级官方文档3 分钟阅读部署与升级

FastGPT V4.12.2版本升级说明与操作指南

本次版本新增四项功能:向量模型并发请求可单独设置,默认值为1,避免不支持并发的模型出错,可在模型配置中调整;对话页支持管理员配置精选应用,用于向团队成员推荐;对话页首页支持管理员配置团队常用的快捷应用;支持关闭团队的对话首页。

这个版本改了什么

本次版本新增四项功能:向量模型并发请求可单独设置,默认值为1,避免不支持并发的模型出错,可在模型配置中调整;对话页支持管理员配置精选应用,用于向团队成员推荐;对话页首页支持管理员配置团队常用的快捷应用;支持关闭团队的对话首页。 本次版本优化六项内容:增加工作流独立分支异常检测;向量模型维度超过1536时截断将强制归一化,其他维度的归一化由配置决定,减少自动判断的计算量;模型提供商配置移至plugin sdk中;封装LLM调用函数,简化LLM请求和工具调用;优化工作流调度代码,避免深度递归;优化工作流递归判断,对递归线分组检测,适配更多连线样式。 本次版本修复十一项问题:独立对话页部分UI异常;独立对话页无法渲染插件交互;独立对话页使用二级路由时默认地址错误;多选选择器导致页面崩溃;移动端分享链接异常加载登录态对话页导航;用户同步可能出现写冲突问题;无法完全关闭系统套餐,存在空对象默认值导致鉴权异常;工作流添加团队应用时搜索无效;应用版本ref字段错误导致无法正常使用;Oceanbase批量插入时未正确返回插入的id;交互节点与工具集存在冲突,导致交互节点后工具集无法正常使用。 本次版本更新一项工具:Doc2x工具响应值异常问题已修复。

升级前要确认的事

需更新的镜像包括FastGPT、FastGPT商业版、fastgpt-plugin,对应镜像tag分别为v4.12.2-fix3、v4.12.2-fix3、v0.1.11。mcp_server、Sandbox、AIProxy无需更新,保留原有版本即可。

升级步骤(照做)

  1. 更新 FastGPT 镜像 tag: v4.12.2-fix3
  2. 更新 FastGPT 商业版镜像 tag: v4.12.2-fix3
  3. 更新 fastgpt-plugin 镜像 tag: v0.1.11
  4. 不更新 mcp_server、Sandbox、AIProxy 的版本。

升级后怎么验证

可通过以下方式验证功能是否正常:检查向量模型配置页面,确认并发请求参数可设置;登录对话页,测试管理员配置精选应用、快捷应用及关闭团队对话首页功能;测试工作流,确认独立分支异常检测、递归判断功能正常;验证独立对话页的UI显示、插件交互渲染、二级路由加载均正常;测试多选选择器,确认页面无崩溃;移动端测试分享链接,确认导航加载正常;测试用户同步、系统套餐关闭、工作流添加团队应用搜索、应用版本ref字段、Oceanbase批量插入、交互节点与工具集调用功能;确认Doc2x工具响应值正常。

来源: FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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