【保姆级教程】Dify+RAGFlow+LangBot搭建本地企业级智能客服系统,零代码也能轻松上手,建议收藏!

发布时间:2026/11/19 4:22:57

【保姆级教程】Dify+RAGFlow+LangBot搭建本地企业级智能客服系统,零代码也能轻松上手,建议收藏! 1. 为什么要在本地把 Dify、RAGFlow、LangBot 串起来如果你正在找一套能跑在自己服务器上、数据不出内网、还能同时接微信/飞书/钉钉的企业智能客服方案那 Dify RAGFlow LangBot 这个组合值得认真看一遍。Dify 负责对话流编排和智能体逻辑RAGFlow 负责知识库的 Embedding、召回与重排LangBot 则把各个聊天平台的事件协议翻译成 Dify 的 HTTP 调用再把回答原路推回去。三者跑在同一个 Docker 网络里不需要依赖任何外部 SaaS日志和文档全部留在本地硬盘。这套方案适合谁一是中小团队的技术负责人想给内部或客户做一套可控的问答系统二是独立开发者手里有文档资产但不想把数据交给第三方平台三是运维或后端同学被要求“搭一个能接多个渠道的客服机器人”但不想从零写适配层。零代码指的是业务编排层面不需要写代码Docker 命令和配置项还是要照着敲一遍的。我试过把这三件套跑通中间踩了几个网络不通、变量名对不上的坑下面按实际操作的顺序把每一步拆开讲。整个流程分六块先讲清楚问题场景和整体架构再把 TaoToken 的 Key/API 通道配好然后给出可复制的 docker-compose 和 config 骨架接着做三步验证再列常见报错最后给一个统一入口的 CTA。2. TaoToken 前置统一 Key 与 API 通道配置在开始编排之前先把模型调用的通道准备好。Dify 里无论是智能体还是工作流最终都要调大模型如果你有多个模型供应商Key 管理会很散。TaoToken 的作用是提供一个统一的 API 入口你只需要在 Dify 的模型供应商配置里填一个 Base URL 和一个 Key就能调用多个模型。先到官网注册并拿到 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后在控制台的 API Keys 页面创建一个新 Key复制保存。API 的基础地址是 https://taotoken.net/api 注意这个地址后面不加 UTM 参数直接用在代码和配置里。在 Dify 里的操作路径是右上角头像 → 设置 → 模型供应商 → 选择 OpenAI 兼容类型或自定义把 API Base 填成 https://taotoken.net/api API Key 填你刚创建的那串。保存后可以在模型列表里拉取可用模型选一个对话模型和一个 Embedding 模型分别用于生成和向量化。如果你后面要用 Coding Plan 做长期编码或 Agent 任务可以在控制台里单独开一个计划Key 是独立的不要和客服系统的 Key 混用。模型对话的调试入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这一步做完Dify 里就有了可用的模型通道RAGFlow 的 Embedding 也可以指向同一个 Base URL省去分别配置的麻烦。3. 可复制配置docker-compose 与各服务骨架3.1 整体网络规划三个服务要互通关键是网络。Dify 默认会创建一个名为dify_default的网络如果你用官方 compose 且项目名是 difyRAGFlow 和 LangBot 都要挂到这个网络上。RAGFlow 的容器名假设为ragflow-serverLangBot 的容器名为langbotDify 的 nginx 容器名为dify-nginx-1。后面所有内部调用都用容器名不用 localhost。先确认 Dify 的网络名docker network ls | grep dify如果输出里有dify_default说明网络已存在。如果没有检查你的 Dify compose 项目名把下面命令里的网络名替换成实际的。3.2 RAGFlow 的 compose 骨架RAGFlow 官方提供了 docker-compose这里给一个精简后的关键片段重点是网络和端口version: 3.8 services: ragflow-server: image: infiniflow/ragflow:latest container_name: ragflow-server ports: - 9380:9380 - 80:80 environment: - SVR_HTTP_PORT9380 - MYSQL_PASSWORDragflow123 - MINIO_PASSWORDminio123 - REDIS_PASSWORDredis123 volumes: - ./ragflow/data:/ragflow/data networks: - dify_default networks: dify_default: external: true启动命令docker compose -p ragflow -f docker-compose-ragflow.yaml up -d启动后访问http://localhost:80进入 RAGFlow 界面注册账号创建一个知识库上传你的文档PDF/Word/Markdown 都行选择 Embedding 模型时把 Base URL 指向 TaoToken 的 API 地址Key 填同一个。RAGFlow 会自动做分块、向量化和索引。3.3 LangBot 的 compose 与网络接入LangBot 的官方仓库在 GitHub 上下载后进入目录用自带的 compose 启动docker compose -p langbot -f docker-compose.yaml up -d启动后访问http://localhost:5300/register注册登录。接下来是最关键的一步把 LangBot 挂到 Dify 的网络里。docker network connect dify_default langbot验证网络是否通docker exec langbot curl -i http://dify-nginx-1/v1/如果提示 curl 没安装用下面命令装兼容 apt 和 apk 两种基础镜像docker exec -u 0 langbot sh -c apt-get update -qq apt-get install -y curl || apk add --no-cache curl装好后重新执行验证命令看到 HTTP 响应头就说明网络通了。3.4 Dify 侧的应用配置在 Dify 里创建一个应用类型选“工作流”或“智能体”。如果选工作流输出变量名一定要设为summaryLangBot 默认读这个字段。如果自己加了输入变量不要勾选“必填”否则 LangBot 传参时会报错。然后在应用的 API 页面创建一个 API Key复制保存。这个 Key 要填到 LangBot 的流水线配置里。3.5 LangBot 流水线配置进入 LangBot 后台创建流水线运行器选 Dify 服务基础 URL 填http://dify-nginx-1/v1/应用类型按你在 Dify 里创建的类型选API 密钥填上一步复制的 Key。保存后进入对话调试先关掉流式传输这样报错能更快看到。如果连接失败用下面命令看日志docker logs --tail 50 -f langbot把报错信息贴给 AI 分析通常问题集中在网络不通、Key 不对、变量名不匹配这三类。4. 三步验证召回测试、多轮联调、渠道回环4.1 知识库召回测试在 RAGFlow 的知识库页面找到“召回测试”功能输入一个你文档里明确有答案的问题比如“公司的报销流程是什么”。看返回的片段是否命中正确段落相似度分数是否合理。如果召回为空检查文档是否解析成功、Embedding 模型是否配置正确。这一步单独验证 RAGFlow不涉及 Dify 和 LangBot。4.2 多轮问答联调回到 Dify 的应用编排页面在对话框里连续问三个相关问题比如“报销流程是什么”→“需要哪些材料”→“审批要多久”。观察智能体是否能记住上下文工具节点是否能正确调用。如果第二轮就丢失上下文检查 Dify 的会话变量配置和记忆节点是否接上。4.3 渠道消息回环确认以钉钉为例。进入钉钉开放后台创建应用添加机器人消息接收模式选 Stream记下 RobotCode、Client ID、Client Secret。如果需要流式输出还要在卡片平台创建一个 AI 卡片模板记下模板 ID并在应用里开通卡片权限。回到 LangBot创建机器人填入上面四个值加模板 ID选择之前配好的流水线并启用。然后在钉钉里搜索机器人名字私聊发一条消息看是否收到回复。如果工作流类型一直没响应把流式输出关掉再试。改完配置后群聊里要把原机器人删除重新添加才生效私聊可以直接生效。三步都通过说明整条链路从知识库到渠道已经打通。5. 本篇常见错排查网络不通最常见的是 LangBot 没挂到dify_default网络。用docker network inspect dify_default看容器列表里有没有 langbot。如果没有重新执行docker network connect。curl 未安装LangBot 的基础镜像可能是 alpine没有 curl。用前面给的 apt/apk 兼容命令装一下。Dify 返回 401API Key 不对或没填。检查 LangBot 流水线里的 Key 是否和 Dify 应用 API 页面里的一致。工作流无响应输出变量名不是summary或者输入变量勾了必填。改成summary取消必填。钉钉群聊不生效改完 LangBot 配置后群里的机器人需要删除重新添加。私聊可以直接生效。RAGFlow 召回为空文档没解析完或者 Embedding 模型没配。等解析状态变成“已完成”再测试。流式输出卡住工作流类型关闭流式输出智能体类型可以开。端口冲突RAGFlow 默认占 80如果本机已有服务占用改 compose 里的端口映射。6. 统一入口与后续扩展整套系统跑起来后你得到的是一个本地企业客服中心知识侧往 RAGFlow 扔文档即可秒级生效业务侧在 Dify 画布拖节点就能查订单、调 API、写数据库渠道侧 LangBot 把同一套大脑挂到钉钉、飞书、企业微信、Discord 等多个平台对话日志全部留在本地。模型通道统一走 TaoTokenKey 和 Base URL 在 Dify 和 RAGFlow 里各配一次就行。后续如果要加渠道只需要在 LangBot 里新建机器人不用动 Dify 和 RAGFlow。如果要换模型在 TaoToken 控制台切换即可业务侧无感知。接入文档和 API Keys 管理入口接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content模型对话调试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Plan长期编码/Agenthttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句Dify 工作流类型在钉钉群里一定要关流式输出这个坑我踩过关了之后响应就正常了。改完 LangBot 配置记得在群里删掉机器人重新加私聊不用。
延伸阅读

更多相关文章

2026/11/19 0:15:31

声光告警系统可靠性设计:PoE供电与网络物理层避坑指南

1. 声光告警系统为什么总在关键时刻掉链子做过弱电工程或者机房运维的人,大概都遇到过这种让人血压飙升的场景:消防联动测试的时候,烟感已经报了警,主机也给出了信号,但现场的声光报警器就是不亮不响。你跑到现场一看&…

2026/11/16 14:55:54

做网站win7好用么?选型哪家好?实战避坑指南

做网站win7好用么?选型哪家好?实战避坑指南 模板网站太丑,功能又不够用,想自己折腾又怕被坑?很多老板在选建站环境时,总纠结做网站win7好用么,甚至直接问建站公司哪家好。别急着下结论,咱们先聊聊真实场景。…

2026/11/19 4:20:48

大邑电工证哪里报考全流程办理指南郑州报考避坑指南

大邑电工证哪里报考全流程办理指南郑州报考避坑指南 实操考试心里没底怕挂科,是很多准备考电工证的朋友最担心的事。特别是像你这样的应届工程类毕业生,面对第一次接触的特种作业考试,不知道从哪里下手,担心流程复杂、怕挂科、怕花钱打水漂,甚至担心报名…

2026/11/19 4:20:48

珠海电工证操作证丢了怎么补办 内部消息全知道

珠海电工证操作证丢了怎么补办 内部消息全知道 学历不高怕报不上名?别急,珠海电工证操作证丢了怎么补办?我来告诉你 内部消息 ,让你省心又省钱。 为什么学历不高也能报考珠海电工证操作证? 很多人总觉得 珠海电工证操作证…

2026/11/19 4:20:48

学校没有电工证吗?保姆级教程帮你理清报考全流程

学校没有电工证吗?保姆级教程帮你理清报考全流程 之前考的证在外省能不能转过来?这个问题其实很多电工朋友都遇到过,尤其是像我们漯河的在职建筑工人,跨省工作频繁,证书的互通性直接影响到我们能否顺利上岗。今天就用 保姆级教程…

2026/11/19 4:20:48

湖南哪里考电工证好在哪考别再踩坑了

湖南哪里考电工证好在哪考别再踩坑了 实操考试心里没底怕挂科,这是很多想考电工证的朋友们最真实的心理状态。尤其是湖南地区的学员,面对复杂的考试流程、不清晰的考试标准和不确定的通过率,难免会感到焦虑。其实,只要选对地方、掌握方法,考试通过不是难…

2026/11/19 4:15:40

南阳哪个技校办电工证网上查询怎么操作最靠谱

南阳哪个技校办电工证网上查询怎么操作最靠谱 证书过期了不知道怎么复审延期,这事儿真让人头疼。尤其是在南阳,不少电工从业者都遇到过这种情况,尤其是在项目赶工期的时候,证件一过期,别说干活,连进场都成问题。如果你正好也在为电工证网上查询和复审发…

2026/11/18 21:12:58

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/18 21:55:23

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/19 0:04:42

深圳电工证培训考场模拟考试题库:郑州报考避坑指南

深圳电工证培训考场模拟考试题库:郑州报考避坑指南 证书过期了不知道怎么复审延期,很多人在遇到这个问题的时候才意识到特种作业证的重要性。其实,不管是电工证、焊工证还是高处作业证,这些证书不仅是上岗的“通行证”,更是法律对安全操作的硬性要求。尤…

2026/11/19 0:04:42

天津电工证查询入口多少钱能报上名

天津电工证查询入口多少钱能报上名 学历不高怕报不上名?别急,天津电工证查询入口其实没你想的那么难。今天咱们就来聊聊,怎么用最低的门槛、最少的钱,把电工证拿下来,还能查得到、用得上。 电工证到底值不值?先搞清楚它的作用…

2026/11/18 12:37:05

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/18 1:15:04

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑