MaxKB 快速上手：零基础十分钟跑通企业级 AI 智能体

MaxKB 快速上手零基础十分钟跑通企业级 AI 智能体【免费下载链接】MaxKB MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKBMaxKB 是开源的企业级智能体平台解决企业 AI 落地中技术门槛高、部署成本高的问题上传一份文档就能建成 RAG 知识库再串起工作流让大模型基于你的资料回答业务问题。本教程带你完成一次真实部署跑通第一个知识库问答。一分钟看懂它是什么、能做什么 MaxKBMax Knowledge Brain是一个企业级智能体平台。 它把三件事做到一个平台里RAG 检索问答、工作流编排、MCP 工具调用。 适合想快速搭出「业务问答 / 智能客服」、又不想自建模型管道的团队。 一个核心卖点模型中立公有云大模型和本地私有模型都能接还可以零代码嵌入你现有的业务系统。从零到一最快启动路径 先确认环境要求系统Linux / macOS / Windows 均可能运行 Docker 即可依赖组件只需 DockerPostgreSQL5432、Redis6379已打包在官方镜像里无需你手工安装端口对外只需要 8080 一个 Web 入口端口第一步获取项目并启动服务。直接在终端执行这条命令它会一次完成拉取镜像、创建容器、启动服务docker run -d --namemaxkb --restartalways -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb如何确认成功执行docker ps看到 maxkb 容器处于 Up 状态再执行docker logs maxkb出现MaxKB started日志即代表初始化完成。首次启动要初始化数据库和内置模型请耐心等一两分钟。第二步访问入口。打开浏览器访问http://127.0.0.1:8080。看到登录页就说明服务已就绪用默认账号admin/MaxKB123..登录即可进入管理后台。源码开发模式可选如果你想从源码跑起来先看 CLAUDE.md装好依赖后在终端执行python main.py devWeb 服务会监听 8080 端口同样在浏览器打开http://127.0.0.1:8080验证。第一次上手跑通一个小场景 场景把一份产品手册变成能问答的机器人。第一步建知识库。登录管理后台进入「知识库」模块新建知识库类型选「通用类型」上传你的手册文档。等到文档状态显示分块、向量化完成这一步才算成功。第二步建应用。先在「模型」模块添加一个大模型选聊天类型再到「应用」模块新建一个「简易」类型应用关联刚才的知识库并选好模型。第三步验证。在应用的测试窗口里问一个手册里明确写到的问题。回答正确、且能给出知识出处就说明整条链路跑通了。应用里有 3 个最关键的参数值得你先认识top_n每次提问召回知识库片段的数量默认 3similarity相似度阈值默认 0.6越高命中越严格search_mode检索方式默认 embedding向量检索常见问题与避坑️问8080 端口被占用启动失败怎么办把启动命令里的-p 8080:8080改成-p 8081:8080然后访问http://127.0.0.1:8081。容器内部端口始终是 8080只改左侧映射即可。问源码模式下web 起来了但文档向量化任务不执行python main.py dev只启动了 Web 服务。另开一个终端执行python main.py dev celery文档解析、向量化等异步任务都靠它处理详见 CLAUDE.md。问源码模式报No config file found或连不上数据库需要走环境变量模式设置MAXKB_CONFIG_TYPEENV并补齐MAXKB_DB_NAME、MAXKB_DB_HOST、MAXKB_REDIS_HOST等变量完整清单见 conf.py。问文档上传成功了为什么聊天答不上来先检查文档状态是否全部执行成功如果已成功仍不命中把similarity阈值调低或调大top_n让模型召回更多知识库内容。从容器启动到第一次知识库问答你已经跑通 MaxKB 的核心闭环。接下来可以去 USE-CASES.md 看看别人怎么用工作流和 MCP 工具扩展场景更多细节查阅 README_CN.md 与 CLAUDE.md。【免费下载链接】MaxKB MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKB创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考