🚀 新增内容
- 基于上下文工程的 Agent 模式，适合长任务拆解的场景。(测试版) @YYH211 @c121914yu
- 临时增加 LLM 请求追踪，方便调试。会保留所有 LLM 的请求体和响应（默认保留 6 小时，通过
LLM_REQUEST_TRACKING_RETENTION_HOURS变量调整） @c121914yu - 知识库搜索，支持指定 collectionIds 来进行筛选。 @newfish-cmyk
- 模型监控增加缓存命中率。 @c121914yu
- 分享链接，自定义鉴权模式下，finish 事件会传输 chatId。 @c121914yu
- 对话日志列表，增加仅看错误日志过滤选项。 @newfish-cmyk
- 对话日志列表，精准的过滤使用者。 @newfish-cmyk
- 依赖预检查，启动项目时进行infra/子服务有效性检测，便于准确定位不可用的服务。 @c121914yu
- MCP 服务解析时，支持解析 schema 中的 $ref 语法。 @ToukoYui
- 使用 LogTape 重构了日志系统，包括但不限于日志打印、日志采集和日志分析等。同时移除了 mongo 的日志存储，可使用 OTEL 收集器进行收集。 @xqvvu
⚙️ 优化
- Chat Agent 中工具选择和知识库选择 UX。 @c121914yu
- MCP 保存时，自动过滤掉多余的字段，避免 mongo4.x 不兼容。 @c121914yu
- 后端自动过滤掉未配置的工具，避免模型调用未配置的工具导致报错。采用相同的过滤函数，保证前后端逻辑一致性。 @c121914yu
- 增加对话日志模式，工作流 AI 模型的记忆选择。 @c121914yu
- 工具调用时，自动补充空的 arguments 成 "{}"，避免部分模型服务商不支持空字符串导致报错。 @c121914yu
- 适配 kimi2.5 思考模式下工具调用。 @c121914yu
- 内网域名检查方式。 @c121914yu
- 工作流运行前，去除孤立的边。 @xuyafei1996
- 通过 API 调用工作流，传入文件链接时，不再采用根据链接推测类型的方式，直接保存输入的 type，确保文件类型 100% 正确。 @c121914yu
🐛 修复
- 工作流全局变量中，部分类型赋值错误的 defaultValueType。
- 工作流 AI 节点，思考输出值未正常渲染。
- 精确获取 MCP 单个子工具的权限，避免越权调用。
- 工具集 ToolName 避免数字开头导致工具调用失败。
- 简易应用转工作流，未复制一份头像。
- 导入工作流时，引用类型的模型字段被误判为无效模型而清空。
- Iphone safari 浏览器下，分享链接首次进入有概率触发 uid 为空的请求。
- MCP 暴露 Agent 时，无法传入文件链接。
- 创建 http 工具时，body 包含变量会报错 JSON 解析错误。
- 工作流切换 Tab 后画布自动定位失效。
- 工作流节点出现系统未捕获的错误时，未正确走报错捕获分支。
插件
- 新增获取用户信息工具。
- 增加 kimi2.5 模型预设。
代码质量
- 增加向量数据库集成测试。
- 完善 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'- 会将对话日志中，含错误的记录添加到统计表里。
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