Skip to content

Releases: labring/FastGPT

v4.14.7

12 Feb 08:43
76d6234

Choose a tag to compare

🚀 新增内容

  1. 基于上下文工程的 Agent 模式,适合长任务拆解的场景。(测试版) @YYH211 @c121914yu
  2. 临时增加 LLM 请求追踪,方便调试。会保留所有 LLM 的请求体和响应(默认保留 6 小时,通过LLM_REQUEST_TRACKING_RETENTION_HOURS 变量调整) @c121914yu
  3. 知识库搜索,支持指定 collectionIds 来进行筛选。 @newfish-cmyk
  4. 模型监控增加缓存命中率。 @c121914yu
  5. 分享链接,自定义鉴权模式下,finish 事件会传输 chatId。 @c121914yu
  6. 对话日志列表,增加仅看错误日志过滤选项。 @newfish-cmyk
  7. 对话日志列表,精准的过滤使用者。 @newfish-cmyk
  8. 依赖预检查,启动项目时进行infra/子服务有效性检测,便于准确定位不可用的服务。 @c121914yu
  9. MCP 服务解析时,支持解析 schema 中的 $ref 语法。 @ToukoYui
  10. 使用 LogTape 重构了日志系统,包括但不限于日志打印、日志采集和日志分析等。同时移除了 mongo 的日志存储,可使用 OTEL 收集器进行收集。 @xqvvu

⚙️ 优化

  1. Chat Agent 中工具选择和知识库选择 UX。 @c121914yu
  2. MCP 保存时,自动过滤掉多余的字段,避免 mongo4.x 不兼容。 @c121914yu
  3. 后端自动过滤掉未配置的工具,避免模型调用未配置的工具导致报错。采用相同的过滤函数,保证前后端逻辑一致性。 @c121914yu
  4. 增加对话日志模式,工作流 AI 模型的记忆选择。 @c121914yu
  5. 工具调用时,自动补充空的 arguments 成 "{}",避免部分模型服务商不支持空字符串导致报错。 @c121914yu
  6. 适配 kimi2.5 思考模式下工具调用。 @c121914yu
  7. 内网域名检查方式。 @c121914yu
  8. 工作流运行前,去除孤立的边。 @xuyafei1996
  9. 通过 API 调用工作流,传入文件链接时,不再采用根据链接推测类型的方式,直接保存输入的 type,确保文件类型 100% 正确。 @c121914yu

🐛 修复

  1. 工作流全局变量中,部分类型赋值错误的 defaultValueType。
  2. 工作流 AI 节点,思考输出值未正常渲染。
  3. 精确获取 MCP 单个子工具的权限,避免越权调用。
  4. 工具集 ToolName 避免数字开头导致工具调用失败。
  5. 简易应用转工作流,未复制一份头像。
  6. 导入工作流时,引用类型的模型字段被误判为无效模型而清空。
  7. Iphone safari 浏览器下,分享链接首次进入有概率触发 uid 为空的请求。
  8. MCP 暴露 Agent 时,无法传入文件链接。
  9. 创建 http 工具时,body 包含变量会报错 JSON 解析错误。
  10. 工作流切换 Tab 后画布自动定位失效。
  11. 工作流节点出现系统未捕获的错误时,未正确走报错捕获分支。

插件

  1. 新增获取用户信息工具。
  2. 增加 kimi2.5 模型预设。

代码质量

  1. 增加向量数据库集成测试。
  2. 完善 packages/global 单元测试,提高覆盖到 90+。

更新指南

1. 更新镜像

  • 更新 FastGPT 镜像 tag: v4.14.7
  • 更新 FastGPT 商业版镜像 tag: v4.14.7
  • 更新 fastgpt-plugin 镜像 tag: v0.5.3
  • mcp_server 无需更新
  • sandbox 无需更新
  • 更新 AIProxy 镜像 tag: 0.3.15
  • mongo 无需更新

2. 更新系统环境变量

更新了日志系统,包括但不限于日志打印、日志采集和日志分析等

# 移除环境变量
LOG_LEVEL=
STORE_LOG_LEVEL=
SIGNOZ_BASE_URL=
SIGNOZ_SERVICE_NAME=
SIGNOZ_STORE_LEVEL=

# 新增以下 6 个日志控制变量
LOG_ENABLE_CONSOLE=true # 是否开启控制台打印
LOG_CONSOLE_LEVEL=debug # 控制台打印最低日志等级
LOG_ENABLE_OTEL=true # 是否开启 OTEL 日志收集
LOG_OTEL_LEVEL=info # OTEL 日志收集的最低日志等级
LOG_OTEL_SERVICE_NAME=fastgpt-client # 传递给 OTLP 收集器的服务名称
LOG_OTEL_URL=http://localhost:4318/v1/logs # 你的 OTLP 收集器的地址,不要把 /v1/logs 遗漏了

3. 更新系统插件

前往插件市场更新以下几个系统工具(如果 4.14.6 升级了,这里可以跳过)。可以直接下载zip 包解压后直接安装。

  • base64Decode:base64 解码转化
  • dallle3: dall-e 3 图片生成
  • docDiff: 文档差异对比
  • drawing: BI图表
  • gptImage: gpt 图片生成
  • markdownTransform: markdown 转换文件
  • mineru: Mineru pdf解析
  • minimax: minimax 对话
  • openrouterMultiModal: openrouter 多模态
  • stability: stability 图片生成

4. 执行升级脚本

从任意终端,发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 rootkey{{host}} 替换成FastGPT 域名

curl --location --request POST 'https://{{host}}/api/admin/initv4147' \
--header 'rootkey: {{rootkey}}' \
--header 'Content-Type: application/json'
  1. 会将对话日志中,含错误的记录添加到统计表里。

5. 接口更新

在新版本的对话记录中,value 值的 type 已被移除,/api/core/chat/getPaginationRecords暂时做了适配,请使用该 API 的用户尽快调整 value 解析方案,直接判断 text,tools等字段是否存在即可。

What's Changed

  • Sandbox move and vector test by @c121914yu in #6381
  • add collectionIds filter for metadata search by @newfish-cmyk in #6379
  • Sandbox server by @c121914yu in #6383
  • chore(deps): bump @modelcontextprotocol/sdk from 1.25.2 to 1.26.0 by @dependabot[bot] in #6384
  • Add share-link hideMenu flag and stabilize query typing by @Copilot in #6389
  • chore(deps): bump protobuf from 4.25.8 to 5.29.6 in /plugins/model/tts-cosevoice by @dependabot[bot] in #6390
  • chore(deps): bump axios from 1.13.2 to 1.13.5 by @dependabot[bot] in #6415
  • chore(deps): bump axios from 1.13.2 to 1.13.5 in /plugins/webcrawler/SPIDER by @dependabot[bot] in #6414
  • V4.14.7 features by @c121914yu in #6406

Full Changelog: v4.14.6.1...v4.14.7

v4.14.6.1

04 Feb 06:17
03890bc

Choose a tag to compare

变更说明

  1. 过滤空tag导致的获取系统插件失败
  2. 增加向量数据库集成测试
  3. API知识库兼容空文件名,防止导入失败

What's Changed

  • fix: nullish tag schema by @xqvvu in #6365
  • feat: vector integrationTest;feat: ob quantization by @c121914yu in #6366
  • feat(sandbox): introduce unified sandbox adapter architecture by @ctlaltlaltc in #6362
  • fix: set fallback file name while import documents from other api server by @xqvvu in #6372

New Contributors

Full Changelog: v4.14.6...v4.14.6.1

v4.14.6

31 Jan 06:35
8e8b5b4

Choose a tag to compare

更新指南

1. 更新镜像:

  • 更新 FastGPT 镜像 tag: v4.14.6
  • 更新 FastGPT 商业版镜像 tag: v4.14.6
  • 更新 fastgpt-plugin 镜像 tag: v0.5.0
  • mcp_server 无需更新
  • sandbox 无需更新
  • AIProxy 无需更新
  • mongo 无需更新

🚀 新增内容

  1. 系统工具可配置自定义的分类属性。 @FinleyGe
  2. 订阅套餐支持配置最大文件上传数量和大小。 @newfish-cmyk
  3. 插件市场支持批量更新插件。 @FinleyGe
  4. 云服务支持企微特定版接入。 @FinleyGe
  5. Seekdb 向量库预设配置。 @flying-dragon-ai

⚙️ 优化

功能优化

  1. 工作流触摸板移动时,遇到输入框后会被强制阻拦。 @newfish-cmyk
  2. 工作流粘贴节点,精确按鼠标位置粘贴。 @newfish-cmyk
  3. 精确移除请求 LLM 时多余的系统字段,避免部分模型接口报错。 @c121914yu

代码质量

  1. useRequest2 替代 useRequest。 @FinleyGe

🐛 修复

  1. 系统工具工具集设置系统密钥后,子工具无法读取到设置的系统密钥 @FinleyGe
  2. 日期选择器溢出问题,增加了动态位置适配。 @newfish-cmyk
  3. 工作流编排页面系统工具“探索更多”跳转地址错误 @FinleyGe
  4. 模型头像缺省值 /imgs/model/huggingface.svg 路径错误 @FinleyGe
  5. 设置工具标签时过滤多余的空值 @FinleyGe

插件

  1. 添加飞书多维表格的引导教程文档 @LBP97541135 @FinleyGe
  2. 企微相关的插件:获取企微企业 access_token; 企微智能表工具集 @FinleyGe @LBP97541135
  3. 新增模型 qwen-flash @c121914yu
  4. 调整 qwen3-max 和 qwen-plus 的预设参数 @c121914yu

What's Changed

New Contributors

Full Changelog: v4.14.5.1...v4.14.6

v4.14.5.1

19 Jan 11:17
8450a44

Choose a tag to compare

更新指南

1. 更新镜像:

  • 更新 FastGPT 镜像tag: v4.14.5.1
  • 更新 FastGPT 商业版镜像tag: v4.14.5.1
  • 更新 fastgpt-plugin 镜像 tag: v0.4.0
  • mcp_server 无需更新
  • Sandbox 无需更新
  • AIProxy 无需更新
  • mongo 无需更新

2. 执行升级脚本

从任意终端,发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 rootkey{{host}} 替换成FastGPT 域名

curl --location --request POST 'https://{{host}}/api/admin/initv41451' \
--header 'rootkey: {{rootkey}}' \
--header 'Content-Type: application/json'
  1. 迁移系统工具的系统密钥配置

🚀 新增内容

  1. Markdown 表格支持导出 csv。@c121914yu

⚙️ 优化

  1. 工作流触摸板移动时,遇到输入框后会被强制阻拦。@c121914yu
  2. 工作流粘贴节点,精确按鼠标位置粘贴。@c121914yu
  3. 精确移除请求 LLM 时多余的系统字段,避免部分模型接口报错。@c121914yu
  4. 使用 path.extname 从 URL 获取文件扩展名 @c121914yu

🐛 修复

  1. 系统工具工具集设置系统密钥后,子工具无法读取到设置的系统密钥 @FinleyGe
  2. 密码类型的全局变量,必填规则校验错误。@newfish-cmyk
  3. 时间类型的全局变量,选择月份被遮挡。@newfish-cmyk
  4. 手动复制弹窗,换行丢失。@newfish-cmyk
  5. 未传入文件上传类型变量,对话接口报错。@newfish-cmyk

What's Changed

Full Changelog: v4.14.5-fix...v4.14.5.1

v4.14.5-fix

10 Jan 16:37
fb0143a

Choose a tag to compare

修复内容

非常重要!请 4.14.0~4.14.5 版本的用户立即升级至该版本。或者通过网关规则,禁用所有 {{FastGPT host}}/api/plugin/* 的请求。

  1. 移除废弃的 plugin 转发接口,该接口存在攻击插件服务风险。

What's Changed

Full Changelog: v4.14.5...v4.14.5-cve

v4.14.5

09 Jan 10:19
c99ad97

Choose a tag to compare

更新指南

1. 修改存储桶环境变量

该版本除了支持 minio 以外,还增加支持了原生 OSS 和 COS, 所以需要修改相关环境变量修改成新的命名。

新增变量

STORAGE_VENDOR=minio 
STORAGE_REGION=us-east-1
STORAGE_ACCESS_KEY_ID=minioadmin
STORAGE_SECRET_ACCESS_KEY=minioadmin
STORAGE_PUBLIC_BUCKET=fastgpt-public
STORAGE_PRIVATE_BUCKET=fastgpt-private
STORAGE_EXTERNAL_ENDPOINT=http://192.168.0.2:9000 # 一个服务器和客户端均可访问到存储桶的地址,可以是固定的宿主机 IP 或者域名,注意不要填写成 127.0.0.1 或者 localhost 等本地回环地址(因为容器里无法使用)
STORAGE_S3_ENDPOINT=http://fastgpt-minio:9000 # 协议://域名(IP):端口

移除旧的变量

  • S3_EXTERNAL_BASE_URL
  • S3_ENDPOINT
  • S3_PORT
  • S3_USE_SSL
  • S3_ACCESS_KEY
  • S3_SECRET_KEY
  • S3_PUBLIC_BUCKET
  • S3_PRIVATE_BUCKET

2. 更新镜像:

  • 更新 FastGPT 镜像tag: v4.14.5
  • 更新 FastGPT 商业版镜像tag: v4.14.5
  • 更新 fastgpt-plugin 镜像 tag: v0.4.0
  • mcp_server 无需更新
  • Sandbox 无需更新
  • AIProxy 无需更新

3. 执行升级脚本

从任意终端,发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 rootkey{{host}} 替换成FastGPT 域名

curl --location --request POST 'https://{{host}}/api/admin/initv4145' \
--header 'rootkey: {{rootkey}}' \
--header 'Content-Type: application/json'
  1. 重试所有失败的 S3 删除任务
  2. 为所有 share 类型的 OutLink 记录添加 showFullText 字段
  3. 重命名字段:
  • showNodeStatus -> showRunningStatus
  • responseDetail -> showCite
  • showRawSource -> canDownloadSource

🚀 新增内容

  1. 工作流画布增加演示模式,同时优化折叠模式样式,优化工作流线重叠问题。 @newfish-cmyk
  2. 工作流增加嵌套应用快速跳转按钮。 @c121914yu
  3. 工作流导出支持选择过滤/不过滤敏感信息。 @xqvvu
  4. 对话记录使用侧改成软删除,增加从日志管理里删除对话记录。 @newfish-cmyk
  5. 更新Agent/工具时,会更新其上层所有目录的更新时间,以便其会排在列表前面。 @newfish-cmyk
  6. 门户页支持配置单个应用运行可见度。 @newfish-cmyk
  7. 导出单个知识库集合分块接口。 @xqvvu
  8. 升级 Mongo5.x 至 5.0.32 解决CVE-2025-14847@c121914yu
  9. 邮箱配置,支持配置安全模式以及端口号。 @FinleyGe

⚙️ 优化

  1. 优化获取 redis 所有 key 的逻辑,避免大量获取时导致阻塞。 @c121914yu
  2. MongoDB, Redis 和 MQ 的重连逻辑优化。 @c121914yu
  3. 变量输入框禁用状态可复制。 @c121914yu
  4. LLM 请求空响应判断,排除敏感过滤错误被误认为无响应。 @c121914yu
  5. 完善 AI 对话和工具调用的错误提示,提供更多原始数据。 @c121914yu
  6. 增大文件解析接口的请求大小限制为 10MB。 @c121914yu
  7. 对话回复下方的引用列表,仅显示 AI 实际引用的知识库内容。 @newfish-cmyk
  8. 更新 MCP SDK 版本。 @c121914yu
  9. Chats 表索引,减少冗余,增加条件索引。 @c121914yu

🐛 修复

  1. 重要 - 工作流并行合并后,可能导致重复运行问题。 @c121914yu
  2. MCP 工具创建时,使用自定义鉴权头会报错。 @newfish-cmyk
  3. 获取对话日志列表时,如果用户头像为空,会抛错。 @c121914yu
  4. chatAgent 未开启问题优化时,前端 UI 显示开启。 @c121914yu
  5. 加载默认模型时,maxTokens 字段未赋值,导致模型最大响应值配置为空。 @c121914yu
  6. S3 文件清理队列因网络稳定问题出现阻塞,导致删除任务不再执行。 @c121914yu
  7. 对话日志接口适配 mongo4.x 语法。 @c121914yu
  8. 变量更新节点将文件 URL 字符串数组错误转换为对象数组。 @newfish-cmyk
  9. 多个表单输入节点共享 sessionStorage 导致默认值不显示。@newfish-cmyk
  10. 代码运行节点切换语言后,AI 仍使用旧语言生成代码。@newfish-cmyk
  11. 多个自定义反馈节点并发写入触发数据库写入冲突。@newfish-cmyk
  12. 交互节点后续的自定义反馈节点写入失败。@newfish-cmyk

What's Changed

New Contributors

Full Changelog: v4.14.4...v4.14.5

V4.14.4-cve

17 Dec 09:46
463b02d

Choose a tag to compare

变更说明

  1. 修复 CVE-2025-55184,可能存在的 DOS 攻击。
  2. 修复创建 MCP 时,使用自定义请求头报错。

What's Changed

Full Changelog: v4.14.4...v4.14.4-cve

V4.14.4

16 Dec 05:07
0e36765

Choose a tag to compare

🚀 新增内容

  1. 工具调用支持配置流输出 @c121914yu
  2. AI 积分告警通知。 @FinleyGe
  3. 对话日志支持展示 IP 地址归属地。 @xqvvu
  4. 对话日志支持展示应用版本名(如果对话中途修改成最新版本,则会被修改成最新版本) @c121914yu
  5. 对话日志支持按点赞点踩过滤,并在对话详情里可以快速定位到赞/踩的记录。 @newfish-cmyk
  6. 通过 API 上传本地文件至知识库,保存至 S3。同时将旧版 Gridfs 代码全部移除。 @xqvvu
  7. 新版订阅套餐逻辑。 @newfish-cmyk
  8. 支持配置对话文件白名单。 @newfish-cmyk
  9. S3 支持 pathStyle 和 region 配置。 @xqvvu
  10. 支持通过 Sealos 来进行多租户自定义域名配置。 @xqvvu
  11. 工作流中引用工具时,文件输入支持手动填写(原本只支持变量引用)。 @c121914yu
  12. 支持网络代理(HTTP_PROXY,HTTPS_PROXY) @xqvvu

⚙️ 优化

  1. 增加 S3 上传文件超时时长为 5 分钟。 @c121914yu
  2. 问题优化采用 JinaAI 的边际收益公式,获取最大边际收益的检索词。 @YYH211
  3. 用户通知,支持中英文,以及优化模板。 @FinleyGe
  4. 删除知识库采用队列异步删除模式。 @c121914yu
  5. LLM 请求时,图片无效报错提示。 @c121914yu
  6. completions 接口,非 stream 模式, detail=false 时,增加返回 reason_content。 @c121914yu
  7. 增加对于无效的 S3 key 检测。 @xqvvu
  8. 删除应用和知识库时,强制要求输入名称校验。 @c121914yu
  9. Mongo 慢操作日志,可以准确打印集合名和操作内容。 @c121914yu
  10. 分享链接,自定义鉴权返回的 uid,强制要求长度小于 200(太长会影响文件上传)。 @xqvvu

🐛 修复

  1. 循环节点数组,取消过滤空内容。
  2. 工作流工具,未传递自定义 DataId,导致测试运行时,查看知识库提示无权限。
  3. 对话 Agent 工具配置中,非必填的布尔和数字类型无法直接确认。
  4. 工作台卡片在名字过长时错位。
  5. 分享链接中url query 中携带全局变量时,前端 UI 不会加载该值。
  6. window 下判断 CSV 文件异常。
  7. 模型测试时,如果模型未启动,会导致无法被测试。
  8. MCP header 中带特殊内容时,会抛错。
  9. 工作流引用其他 Agent 时,切换版本号后未及时更新 UI。
  10. http 节点使用值为空字符串的全局变量时,值会被替换为 null。
  11. 判断器节点折叠时,连线断开。
  12. 节点调试时,单选和多选类型的变量无法展示选项。
  13. 发布渠道文档链接定位错误。
  14. Checkbox 在禁用状态时,hover 样式错误。
  15. 模型头像缺失情况下,默认 huggingface.svg 图标显示错误。
  16. 日志导出时,结束时间会多出一天。
  17. 表单输入,前端默认值未传递到实体值。
  18. 工具调用时,未传递 max_tokens 参数。
  19. 工作流判断器 value 值,未结合 condition 来综合获取数据类型。
  20. 非直接分块模式的知识库数据,引用阅读器导航顺序异常。引用阅读器只会加载同一页。

更新指南

1. 更新镜像:

  • 更新 FastGPT 镜像tag: v4.14.4
  • 更新 FastGPT 商业版镜像tag: v4.14.4
  • 更新 fastgpt-plugin 镜像 tag: v0.3.4
  • mcp_server 无需更新
  • Sandbox 无需更新
  • AIProxy 无需更新

2. 执行升级脚本

从任意终端,发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 rootkey{{host}} 替换成FastGPT 域名

curl --location --request POST 'https://{{host}}/api/admin/initv4144' \
--header 'rootkey: {{rootkey}}' \
--header 'Content-Type: application/json'
  1. 将 4.14.3 中,遗留的 Dataset/local 接口上传的文件,也迁移到 S3 中。
  2. 全量计算旧的 chat 中的反馈,增加 flags 值便于筛选。该函数执行较慢,所以放到异步执行,接口不会返回结果,请关注日志中是否打印:Migration feedback completed!

What's Changed

Full Changelog: v4.14.3...v4.14.4

v4.14.3

27 Nov 03:55
8880556

Choose a tag to compare

更新指南

1. 更新镜像:

  • 更新 FastGPT 镜像tag: v4.14.3
  • 更新 FastGPT 商业版镜像tag: v4.14.3
  • 更新 fastgpt-plugin 镜像 tag: v0.3.3
  • mcp_server 无需更新
  • Sandbox 无需更新
  • AIProxy 无需更新

2. 执行升级脚本

从任意终端,发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 rootkey{{host}} 替换成FastGPT 域名

curl --location --request POST 'https://{{host}}/api/admin/initv4143' \
--header 'rootkey: {{rootkey}}' \
--header 'Content-Type: application/json'

会将原系统 MongoDB 的 GridFS 中的所有知识库文件迁移到 S3 中,包含文本数据集和图片数据集,但不包括文档(如 .docx)里解析出来的图片。

🚀 新增内容

  1. 知识库文件迁移至 S3(全部使用文件的地方均已迁移)。@xqvvu
  2. 全局变量支持文件上传。@newfish-cmyk
  3. 表单输入节点支持密码、开关、时间点、时间范围、文件上传、对话模型选择。@newfish-cmyk
  4. 插件输入支持多选、时间点、时间范围、内部变量。@newfish-cmyk
  5. 系统插件,插件市场中会提示是否有新版本,并提供更新按键。@FinleyGe
  6. 工作流运行 QPM 限制。@FinleyGe

⚙️ 优化

  1. 工作流工具,文件上传输入 UX 优化。@c121914yu
  2. 添加权限表校验中间件,增强权限表鲁棒性。@FinleyGe

🐛 修复

  1. 工作流调试预览窗口,重新渲染导致输入丢失。@newfish-cmyk
  2. S3 服务与主服务相同 Origin 的域名会导致对 S3 的文件请求 URL 被错误替换,产生 404 报错。@xqvvu

插件

  1. 工具更新逻辑,提供一个计算的 version 值来判断更新 @FinleyGe
  2. 微信公众号工具集:允许同时上传多篇文档到草稿箱 @FinleyGe
  3. 修复工具缓存没有被正确刷新 @FinleyGe
  4. 修复开发模式下刷新缓存导致静态文件重新上传 @FinleyGe
  5. 修复修复上传 pkg 后图片没有被正确上传的问题 @FinleyGe

What's Changed

Full Changelog: v4.14.2...v4.14.3

V4.14.2-fix

21 Nov 02:27
c1c2b46

Choose a tag to compare

变更说明

  1. 修复升级脚本中,对于社区版旧数据会报错。

What's Changed

Full Changelog: v4.14.2...v4.14.2-fix