2026 年 1 月 8 日，maxkb 开源企业级智能体平台正式推出 v2.5.0 版本。
在 MaxKB v2.5.0 社区版中，模块架构迎来重要演进：原“应用”模块全面升级为“智能体”模块，支持大语言模型自主执行完整业务流程（包括自动调用工具、MCP 及嵌套智能体）；新增“模板中心”，用户可通过预置模板快速创建智能体；高级智能体中所有 AI 能力节点均新增异常分支输出能力，显著增强流程健壮性与容错能力。知识库能力方面，工作流知识库新增工作流导入/导出功能，实现跨环境配置复用。资源治理方面，知识库、工具、模型列表统一新增“查看关联资源”入口，直观呈现资源依赖图谱，助力高效运维与精准溯源。
X-Pack 增强包升级方面，MaxKB 在登录策略中新增第三方用户默认角色自动分配机制，并引入登录失败账户锁定功能，双重加固身份认证安全防线，有效抵御暴力破解攻击。
亮点更新
■ 智能体重构：“应用”模块全面进化为“智能体”模块
MaxKB v2.5.0 社区版将原有“应用”模块整体升级为“智能体”模块，“简易应用”与“高级编排”同步更名为“简易智能体”与“高级智能体”。其中，简易智能体首次集成自主调用 MCP、外部工具及子智能体三大核心能力，用户无需深度配置即可驱动大语言模型完成复杂企业任务，大幅跃升智能体的自主决策水平与端到端执行闭环能力。
▲图 1 MaxKB “应用” 模块升级为 “智能体” 模块
▲图 2 简易智能体支持自主调用 MCP、工具和智能体
■ 模板中心上线：覆盖高频场景的智能体与知识库工作流模板库
MaxKB v2.5.0 社区版正式发布“模板中心”功能，入口位于“智能体”页面左上角。用户可直接从中选取适配业务需求的智能体或知识库工作流模板，仅需在编排界面配置模型、知识库等基础参数，即可一键部署，加速典型业务场景的智能化落地。
为持续丰富模板生态、共建开放社区，MaxKB 热忱欢迎广大开发者参与模板共建：
● 开发规范：请严格遵循官方发布的模板开发标准，构建兼容 MaxKB 的智能体或知识库工作流模板；
● 提交流程：完成开发后，将模板推送至 GitHub 官方仓库（https://www.php.cn/link/c87532b4c0c78e92fdfd956ecc21e165。
▲图 3 智能体的 “模板中心” 功能
▲图 4 知识库的 “模板中心” 功能
CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
■ 高级智能体 AI 节点全面支持异常分支处理
v2.5.0 社区版中，高级智能体所有 AI 能力节点均新增异常分支输出通道，支持为异常路径定制专属响应逻辑（如自动重试、返回兜底值等）。该机制避免单点异常引发整条流程中断，借助细粒度异常控制策略，显著提升智能体运行稳定性与流程可控性。
▲图 5 高级智能体中所有 AI 能力节点新增异常分支输出功能
■ 工作流知识库支持工作流配置导入/导出
MaxKB v2.5.0 社区版为工作流知识库新增工作流导入与导出能力。导入时仅需上传标准格式文件，即可秒级复用已有流程配置。该功能极大简化了开发、测试、生产等多环境间的工作流迁移流程，也便于团队沉淀并共享最佳实践，全面提升部署效率与协作质量。
▲图 6 工作流知识库新增导入 / 导出工作流功能
■ 知识库、工具、模型资源新增“关联关系可视化”功能
v2.5.0 社区版中，知识库、工具、模型等核心资源均新增“查看关联资源”快捷入口。用户点击即可一览该资源所依赖的上游组件及被下游调用的全部对象，清晰呈现资源拓扑结构，辅助运维人员快速诊断故障根因、优化资源配置，切实提升后台管理效能。
▲图 7 知识库、工具、模型资源新增 “查看关联资源” 功能
■ 登录安全增强：支持第三方用户默认角色绑定与失败锁定（X-Pack）
MaxKB v2.5.0 专业版与企业版在登录设置中新增两项关键安全能力：第三方用户登录时可自动分配预设角色；连续登录失败达到阈值后自动锁定账号。双管齐下，强化账户访问控制，筑牢企业数据安全边界。
▲图 8 MaxKB 登录设置页面
其他新增功能
■ 问答页面：用户提交反馈时可填写详细说明信息；
■ 智能体：对话日志详情页支持展示用户提交的反馈内容；
■ 智能体：基本信息节点的输入参数组件新增多行文本框、单行选项卡、单行多选卡类型；
■ 智能体：自定义工具节点的输入参数支持 boolean 类型定义；
■ 知识库：工作流知识库文档导入过程支持实时取消操作；
■ 工具：参数配置对话框中新增 JSON 文本框与滑块控件；
■ 文件夹：支持按名称、创建时间及自定义拖拽顺序进行排序；
■ 用户管理：创建新用户时可预设其默认资源访问权限；
■ 用户管理（X-Pack）：支持批量分配角色与批量删除用户。
功能优化
■ 智能体：高级智能体起始节点新增全局变量 {{global.chat_user_group}}，用于识别对话用户所属分组；
■ 知识库：命中测试接口由 GET 升级为 POST 请求，提升安全性与兼容性；
■ 文件夹：支持按用户角色设置访问权限；
■ API Key：系统级 API Key 实现用户级隔离，保障密钥使用安全；
■ 问答页面：历史聊天记录取消 20 条上限限制，支持全量查看；
■ 问答页面：最后一条提问支持编辑后重新提交；
■ 问答页面（X-Pack）：第三方对话用户登录后均可主动退出当前会话；
■ 系统：全面优化 UI 界面交互与视觉体验。
问题修复
■ 安全漏洞：修复文件上传功能可能导致的 XSS 攻击风险；
■ 安全漏洞：修复工具模块中 Python 动态加载 DLL 绕过沙箱限制的问题；
■ 安全漏洞：修复 Celery 中反序列化不受信 Pickle 对象可能触发远程代码执行（RCE）的隐患；
■ 工具：修复 SMTP 邮件发送功能被误判拦截的问题；
■ 智能体：修复 MCP 节点工具选择下拉框滚动条失效问题；
■ 智能体：修复 MCP 调用与工具节点执行详情内容超出视口的样式异常；
■ 智能体：修复子智能体无法接收父智能体传递的视频文件问题（#4568）；
■ 知识库：修复分段详情页中视频组件溢出容器区域的显示缺陷（#4542）；
■ 知识库：修复分段详情页打开时所有嵌入视频自动播放的问题。
源码地址：点击下载
