这次我们来看一个名为“悟空 AICRM”的项目它本质上是一个基于大语言模型LLM的智能客户关系管理CRM系统。简单来说它能让你的客服、销售或市场团队拥有一个AI大脑自动处理客户咨询、生成销售话术、分析客户意向。最吸引人的是它提供了完整的Docker部署方案这意味着你可以在自己的服务器或本地电脑上一键拉起整套服务完全掌控数据和流程。对于技术团队而言核心价值在于开箱即用、私有化部署、支持API集成。你不用再为复杂的Python环境、模型下载、服务编排头疼Docker Compose已经帮你打包好了前后端、数据库和AI模型服务。本文将带你从零开始完成“悟空 AICRM”的完整Docker部署并验证其核心功能。无论你是想搭建一个内部AI助手还是为现有业务系统接入智能对话能力这套方案都值得一试。1. 核心能力速览在动手部署前我们先快速了解“悟空 AICRM”能做什么以及部署它需要什么。能力项说明项目类型基于大语言模型的智能CRM系统核心功能智能对话、客户意图识别、销售话术生成、知识库问答、工单处理部署方式Docker Docker Compose 一键部署硬件门槛最低配置2核CPU4GB内存。推荐配置4核CPU8GB内存以上。如需本地运行大模型需额外考虑GPU显存。显存要求取决于所选AI模型。如果使用内置的较小模型如ChatGLM3-6B至少需要6-8GB GPU显存。如果使用云端API如OpenAI、通义千问则对本地显存无要求。是否支持CPU是但推理速度会较慢适合轻量级测试。是否支持API是。提供完整的RESTful API可供其他业务系统调用。是否支持批量任务是支持批量导入客户数据、批量进行客户意向分析。启动方式通过docker-compose up -d命令一键启动所有服务。管理界面提供Web管理后台用于配置模型、管理知识库、查看对话记录等。适合场景企业私有化AI客服部署、销售团队AI辅助、内部知识问答系统搭建。从表格可以看出这个项目的亮点在于一体化和易部署。它不是一个单纯的模型而是一个包含用户界面、业务逻辑、数据存储和AI能力的完整应用。2. 适用场景与使用边界在部署之前明确它能解决什么问题以及不能用在什么地方可以帮你更好地规划。适合谁用中小企业技术负责人希望快速为业务部门部署一个可控、低成本的AI对话系统无需从零开发。开发者/技术爱好者想学习如何将LLM与实际业务系统CRM结合了解Docker化AI应用的架构。有私有化部署需求的团队对数据安全敏感不希望客户对话数据经过第三方服务器。能解决什么问题自动化客户接待7x24小时响应常见问题减轻人工客服压力。销售线索筛选与孵化自动分析客户对话识别购买意向并打分或分类。标准化话术支持为销售新人实时生成符合场景的专业回复建议。企业内部知识库将产品文档、规章制度导入员工可快速查询。使用边界与注意事项模型能力限制最终效果严重依赖底层大模型的能力。如果使用较小的本地模型在复杂逻辑、多轮对话或专业领域上可能表现不佳。冷启动问题系统需要“喂养”知识上传文档、配置话术才能更好地回答特定领域问题。合规与隐私客户数据虽然私有化部署但仍需确保你获取和使用客户对话数据的合法性遵守相关隐私法规。生成内容审核AI生成的内容可能存在事实性错误或不妥表述关键场景需加入人工审核环节。模型版权若使用第三方商用模型API如GPT-4需确保拥有合法使用权限。3. 环境准备与前置条件部署“悟空 AICRM”需要一套基础环境。请确保你的服务器或本地电脑满足以下条件。3.1 系统与Docker环境操作系统推荐Linux (Ubuntu 20.04/22.04, CentOS 7/8)或Windows 10/11 (需安装WSL2)。macOS也支持。Docker Engine版本20.10.0或更高。这是运行容器的基础。Docker Compose版本v2.0.0或更高。用于编排和启动多个服务。Git用于拉取项目代码。如何检查在终端中执行以下命令# 检查Docker版本 docker --version # 检查Docker Compose版本 docker compose version # 检查Git版本 git --version如果未安装需要先进行安装。以Ubuntu为例# 更新软件包索引 sudo apt-get update # 安装Docker sudo apt-get install docker.io docker-compose git -y # 启动Docker服务并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 将当前用户加入docker组避免每次用sudo sudo usermod -aG docker $USER # 退出终端重新登录使组生效3.2 硬件与网络CPU与内存如核心能力速览所述建议4核8GB以上。内存不足会导致容器启动失败或运行缓慢。磁盘空间至少预留20GB可用空间用于存放Docker镜像、模型文件如果本地部署、数据库和日志。网络服务器需要能访问互联网以下载Docker镜像和可能的模型文件。如果使用云端模型API则需要能访问对应服务商如OpenAI的网络。端口确保以下端口未被占用或准备好修改项目配置。80或8080Web前端访问端口。3000后端API服务端口常见。3306MySQL数据库端口内部使用通常不对外暴露。4. 安装部署与启动方式一切就绪我们开始部署。整个过程围绕Docker Compose进行非常清晰。4.1 获取项目代码首先将“悟空 AICRM”的代码仓库克隆到本地。# 假设项目仓库地址为请根据实际项目地址替换 git clone https://github.com/xxx/wukong-aicrm.git # 进入项目目录 cd wukong-aicrm重要由于输入材料未提供确切的项目仓库地址此处为示例。在实际操作中你需要找到该项目的官方或开源仓库地址进行替换。通常这类项目会在GitHub、Gitee等平台发布。4.2 配置环境变量大多数Docker化项目通过环境变量文件.env进行配置。在项目根目录下通常会有.env.example或config.example.yaml之类的示例文件。复制示例配置文件cp .env.example .env编辑.env文件使用vim、nano或任何文本编辑器打开根据注释修改关键配置。nano .env核心配置项说明以下为常见项请以实际文件为准# 数据库配置 MYSQL_ROOT_PASSWORDyour_strong_password_here MYSQL_DATABASEaicrm MYSQL_USERaicrm_user MYSQL_PASSWORDaicrm_password # 后端服务配置 API_HOST0.0.0.0 API_PORT3000 # 前端服务配置 WEB_PORT8080 # AI模型配置关键 # 模式选择local本地模型 或 api云端API LLM_PROVIDERlocal # 如果选择 local需指定本地模型名称和路径 LOCAL_MODEL_NAMEchatglm3-6b LOCAL_MODEL_PATH/app/models/chatglm3-6b # 如果选择 api需配置API Key和Base URL # OPENAI_API_KEYsk-xxx # OPENAI_API_BASEhttps://api.openai.com/v1 # 或者使用国内模型 # DASHSCOPE_API_KEYsk-xxx重点LLM_PROVIDER的选择决定了部署复杂度和资源需求。local模式需要提前下载好大模型文件并挂载到容器内。对显存/内存要求高但数据完全本地无网络依赖。api模式无需本地模型直接调用如OpenAI、通义千问、智谱AI等云端服务。部署简单但会产生API费用且对话数据会出境若使用国外服务。4.3 启动所有服务配置完成后使用一条命令启动所有容器。# 在项目根目录docker-compose.yml所在目录执行 docker-compose up -d参数-d表示在后台运行。执行后会发生什么Docker会从镜像仓库拉取Pull项目所需的各个镜像如MySQL、Redis、后端、前端。根据docker-compose.yml和.env的配置创建并启动多个容器。容器之间会建立网络使得前端能访问后端后端能访问数据库和AI模型服务。4.4 查看服务状态与日志启动后检查服务是否正常运行。# 查看所有容器状态 docker-compose ps你应该看到所有服务的状态State都是Up。如果某个服务启动失败查看其日志定位问题# 查看所有服务的日志 docker-compose logs # 查看特定服务如后端的日志 docker-compose logs backend4.5 访问Web管理界面如果一切顺利现在可以通过浏览器访问AICRM的管理界面了。地址http://你的服务器IP:WEB_PORT例如如果你在本地部署且WEB_PORT8080则访问http://localhost:8080如果在云服务器部署需将localhost替换为服务器的公网IP并确保安全组/防火墙放行了该端口。首次访问通常会进入初始化页面可能需要设置管理员账号密码或进行一些基础配置。5. 功能测试与效果验证服务跑起来后我们需要验证核心功能是否正常。我们从最基本的操作开始。5.1 基础登录与系统检查登录管理后台使用初始化时设置的管理员账号登录。检查系统状态在管理后台的“系统状态”或“仪表盘”页面查看数据库连接是否正常。AI模型服务状态是否就绪显示“已连接”或类似状态。各服务组件如Redis是否在线。5.2 AI对话功能测试这是核心功能。在系统中找到“对话测试”、“智能客服”或类似的入口。测试用例1通用知识问答操作在对话窗口输入“你好请介绍一下你自己。”预期AI应能生成一段自我介绍说明它是悟空AICRM的智能助手。成功标准能收到一段连贯、合理的文本回复无报错。测试用例2业务场景测试需先配置知识库前置在“知识库管理”中上传一份简单的产品PDF文档或添加几条产品QA。操作输入一个文档中明确存在的问题例如“你们的产品支持哪些支付方式”预期AI应能根据上传的知识库内容给出准确或相关的答案。成功标准答案来源于知识库而非通用模型知识。这验证了RAG检索增强生成功能是否生效。5.3 客户与工单管理测试创建测试客户在“客户管理”中手动添加一个测试客户填写姓名、电话等基本信息。发起模拟对话在该客户的详情页模拟一次客户咨询。系统应能记录完整的对话历史。创建工单基于某次对话尝试创建一个工单例如“客户反馈登录问题”并指派给某个客服角色。检查工单状态流转是否正常。5.4 批量任务测试批量导入客户准备一个CSV文件包含姓名,手机号,邮箱等字段。在系统找到“批量导入”功能上传该文件。系统应能解析并导入客户数据提供成功/失败报告。批量分析如果功能存在选中多个客户执行“批量意向分析”操作。系统应能异步处理并更新客户的意向标签或评分。6. 接口 API 与批量任务对于开发者通过API集成是更常见的用法。我们来验证后端API是否可用。6.1 API服务状态检查通常后端API会提供一个健康检查端点。# 使用curl测试API健康状态 curl http://localhost:3000/health # 或 curl http://localhost:3000/api/health预期返回{status: ok}或类似JSON表明API服务运行正常。6.2 核心API调用示例假设我们需要通过API让AI回答一个问题。步骤1获取认证Token如果API需要curl -X POST http://localhost:3000/api/auth/login \ -H Content-Type: application/json \ -d {username:admin, password:your_admin_password}从返回的JSON中提取access_token。步骤2调用对话APIcurl -X POST http://localhost:3000/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer YOUR_ACCESS_TOKEN \ -d { model: gpt-3.5-turbo, # 这里应与后台配置的模型名称一致 messages: [{role: user, content: 北京明天的天气怎么样}], stream: false }参数说明model: 指定使用的模型需与系统配置匹配。messages: 对话历史是一个数组。stream: 是否使用流式输出true/false。预期返回{ id: chatcmpl-xxx, choices: [{ index: 0, message: { role: assistant, content: 我是一个AI助手无法提供实时天气信息... } }] }6.3 批量任务API集成思路系统本身可能提供批量处理的API端点。如果没有常见的工程化做法是编写脚本用Python读取客户列表CSV。循环调用针对每个客户调用对话API传入预设的调研问题。结果收集将AI的回复解析并存储到数据库或新的CSV中。加入容错在脚本中加入重试机制和日志记录。import pandas as pd import requests import time import logging logging.basicConfig(levellogging.INFO) API_URL http://localhost:3000/api/chat/completions TOKEN YOUR_TOKEN_HERE headers {Authorization: fBearer {TOKEN}, Content-Type: application/json} def ask_ai(question): payload { model: gpt-3.5-turbo, messages: [{role: user, content: question}], stream: False } try: resp requests.post(API_URL, jsonpayload, headersheaders, timeout60) resp.raise_for_status() return resp.json()[choices][0][message][content] except Exception as e: logging.error(fAPI调用失败: {e}) return None # 读取客户数据 df pd.read_csv(clients.csv) results [] for idx, row in df.iterrows(): client_name row[name] # 构造针对该客户的问题 question f假设你是销售向{client_name}介绍我们的核心产品用一段话。 answer ask_ai(question) results.append({client: client_name, ai_response: answer}) time.sleep(1) # 避免请求过快 # 保存结果 pd.DataFrame(results).to_csv(batch_ai_results.csv, indexFalse) logging.info(批量任务完成。)7. 资源占用与性能观察部署完成后需要关注系统的资源消耗这对长期稳定运行至关重要。7.1 查看容器资源占用使用Docker命令可以方便地查看各个容器的CPU、内存使用情况。# 查看所有容器的实时资源占用类似Linux top命令 docker stats这个命令会动态显示每个容器的CPU百分比、内存使用量/限制、网络IO等。重点关注内存MEM USAGE如果某个容器尤其是运行AI模型的容器内存使用持续接近其限制可能导致服务崩溃。7.2 性能影响因素AI模型选择这是最大的性能变量。本地70B模型和6B模型对显存和速度的需求是天壤之别。并发请求量如果多人同时使用对话功能后端和AI模型容器的压力会增大。需要根据实际并发数调整容器资源限制在docker-compose.yml中配置deploy.resources。知识库规模当知识库文档非常多时检索阶段可能会变慢。考虑对向量数据库进行性能优化或分库。数据库性能MySQL容器如果未配置合适的缓存在大量日志写入时可能成为瓶颈。7.3 如何降低资源占用如果使用本地模型如果发现资源紧张可以尝试量化模型使用4-bit或8-bit量化版本的模型能显著减少显存占用精度损失通常可接受。使用更小模型从ChatGLM3-6B切换到更小的模型如Qwen1.5-1.8B。启用CPU推理如果对响应速度要求不高可以强制在CPU上推理通常通过环境变量如DEVICEcpu设置。调整Docker资源限制在docker-compose.yml中为模型服务容器设置明确的内存和CPU限制防止其占用所有主机资源。8. 常见问题与排查方法部署过程中难免遇到问题这里汇总一些常见情况。问题现象可能原因排查方式解决方案docker-compose up失败提示Cannot connect to the Docker daemonDocker服务未启动或当前用户无权限。运行systemctl status docker和groups $USER。启动Docker服务sudo systemctl start docker。将用户加入docker组后需重新登录终端。前端页面无法访问连接被拒绝1. 容器未成功启动。2. 端口被占用或防火墙阻止。3. 前端容器内部服务出错。1.docker-compose ps查看状态。2.netstat -tlnp | grep :8080查看端口。3.docker-compose logs frontend查看前端日志。1. 根据日志修复启动错误。2. 修改.env中的端口号或关闭占用端口的进程。3. 检查前端构建是否成功。后台提示“AI模型服务未连接”1. AI模型容器启动失败。2. 网络配置错误后端无法访问模型服务。3. 模型文件缺失或路径错误。1.docker-compose logs llm-service容器名可能不同查看模型服务日志。2.docker network inspect检查容器网络。3. 进入模型容器检查文件docker exec -it container_id ls /app/models。1. 根据日志解决依赖或配置问题。2. 确保docker-compose.yml中服务在同一个自定义网络内。3. 确认模型文件已正确下载并挂载。对于local模式这是最常见的问题。API调用返回401/403错误1. 未提供Token或Token过期。2. Token格式错误。检查请求头中的Authorization字段。重新登录获取有效Token并确保在请求头中正确添加Bearer YOUR_TOKEN。对话响应速度极慢1. 使用CPU推理。2. 模型过大硬件性能不足。3. 知识库检索文档过多。1. 查看模型服务日志确认运行设备。2. 使用docker stats观察资源瓶颈。3. 测试不启用知识库的纯对话速度。1. 如有GPU配置使用GPU。2. 换用更小的量化模型。3. 优化知识库对文档进行切分和索引。批量导入客户失败1. CSV文件格式不正确编码、列名。2. 数据库字段约束不满足如唯一键重复。1. 查看导入失败的报告通常会有错误行提示。2. 查看后端容器日志。1. 使用UTF-8编码确保列名与模板一致。2. 清理CSV中的重复数据或空行。通用排查流程看日志docker-compose logs [service-name]是定位问题的第一选择。查状态docker-compose ps确认所有服务都是Up状态。进容器docker exec -it container_id /bin/bash进入容器内部检查配置文件、进程和文件是否存在。验网络在一个容器内ping另一个容器的服务名检查网络连通性。9. 最佳实践与使用建议为了让“悟空 AICRM”稳定、安全地运行这里有一些经验之谈。首次部署从简第一次尝试强烈建议使用LLM_PROVIDERapi模式并配置一个可用的云端大模型API如DeepSeek、通义千问等。这能绕过本地模型部署的复杂性和硬件要求让你快速验证业务流程。使用默认端口避免修改过多配置。数据持久化与备份在docker-compose.yml中确保MySQL、Redis等有状态服务的数据卷volumes配置指向了宿主机的持久化目录如./data/mysql:/var/lib/mysql。定期备份./data目录和重要的上传文件如知识库文档。生产环境安全加固修改默认密码务必修改.env文件中的数据库root密码、应用管理员密码。限制访问通过防火墙或云安全组仅允许必要的IP访问管理后台端口如8080和API端口如3000。启用HTTPS使用Nginx反向代理并配置SSL证书避免数据明文传输。容器更新关注项目更新定期拉取新镜像并重启服务以获取功能更新和安全补丁。模型与知识库优化知识库质量上传给AI的文档要清晰、结构好。杂乱无章的文档会导致检索效果差。建议先整理成QA对或分段清晰的Markdown。提示词工程在系统后台的“模型配置”或“提示词模板”中精心设计系统提示词System Prompt这能极大地影响AI在业务场景中的表现。效果迭代上线后从对话日志中找出回答不佳的案例分析是知识库缺失、提示词问题还是模型能力边界然后针对性优化。合规使用明确告知用户正在与AI交互。对AI生成的关键业务信息如价格、政策进行人工复核。妥善保管对话日志建立数据保留和删除政策。10. 总结与下一步通过以上步骤你应该已经成功在本地或服务器上部署了“悟空 AICRM”系统并对其核心功能、API调用和资源管理有了基本了解。这个项目的最大优势在于提供了一个开箱即用的、Docker化的AI业务应用框架极大地降低了技术集成门槛。最值得尝试的点快速验证AICRM场景如果你有一个想法想看看AI能否赋能你的客户服务用这个项目几天内就能搭出可演示的原型。学习Docker化AI应用架构它的docker-compose.yml是很好的学习样本展示了如何将LLM服务、Web应用、数据库组合在一起。最先应该验证的功能对话流畅性用api模式测试多轮对话是否连贯。知识库问答上传一份产品手册测试AI能否准确回答基于文档的问题。数据流转走通“客户咨询 - AI回复 - 生成工单”这个核心业务流程。最容易踩的坑本地模型文件如果选择local模式模型下载、路径配置、格式兼容是主要障碍。务必仔细阅读项目文档关于模型准备的说明。端口冲突默认端口可能被占用学会查看日志和修改.env配置。资源不足尤其是内存8GB内存运行本地6B模型可能很吃力监控docker stats是关键。后续可以探索的方向集成更多模型尝试接入不同的云端或本地模型对比效果和成本。自定义开发基于其提供的API开发新的前端界面或将其对话能力嵌入到你的现有网站、小程序、APP中。流程自动化结合Zapier、n8n或钉钉/飞书机器人将AI识别的客户意向自动同步到你的CRM或通知销售。建议将本文作为部署手册收藏在实际操作时按章节查阅。遇到具体问题优先查看项目本身的Issue和文档通常能找到解决方案。
基于Docker的悟空AICRM私有化部署指南：从零搭建智能CRM系统
这次我们来看一个名为“悟空 AICRM”的项目它本质上是一个基于大语言模型LLM的智能客户关系管理CRM系统。简单来说它能让你的客服、销售或市场团队拥有一个AI大脑自动处理客户咨询、生成销售话术、分析客户意向。最吸引人的是它提供了完整的Docker部署方案这意味着你可以在自己的服务器或本地电脑上一键拉起整套服务完全掌控数据和流程。对于技术团队而言核心价值在于开箱即用、私有化部署、支持API集成。你不用再为复杂的Python环境、模型下载、服务编排头疼Docker Compose已经帮你打包好了前后端、数据库和AI模型服务。本文将带你从零开始完成“悟空 AICRM”的完整Docker部署并验证其核心功能。无论你是想搭建一个内部AI助手还是为现有业务系统接入智能对话能力这套方案都值得一试。1. 核心能力速览在动手部署前我们先快速了解“悟空 AICRM”能做什么以及部署它需要什么。能力项说明项目类型基于大语言模型的智能CRM系统核心功能智能对话、客户意图识别、销售话术生成、知识库问答、工单处理部署方式Docker Docker Compose 一键部署硬件门槛最低配置2核CPU4GB内存。推荐配置4核CPU8GB内存以上。如需本地运行大模型需额外考虑GPU显存。显存要求取决于所选AI模型。如果使用内置的较小模型如ChatGLM3-6B至少需要6-8GB GPU显存。如果使用云端API如OpenAI、通义千问则对本地显存无要求。是否支持CPU是但推理速度会较慢适合轻量级测试。是否支持API是。提供完整的RESTful API可供其他业务系统调用。是否支持批量任务是支持批量导入客户数据、批量进行客户意向分析。启动方式通过docker-compose up -d命令一键启动所有服务。管理界面提供Web管理后台用于配置模型、管理知识库、查看对话记录等。适合场景企业私有化AI客服部署、销售团队AI辅助、内部知识问答系统搭建。从表格可以看出这个项目的亮点在于一体化和易部署。它不是一个单纯的模型而是一个包含用户界面、业务逻辑、数据存储和AI能力的完整应用。2. 适用场景与使用边界在部署之前明确它能解决什么问题以及不能用在什么地方可以帮你更好地规划。适合谁用中小企业技术负责人希望快速为业务部门部署一个可控、低成本的AI对话系统无需从零开发。开发者/技术爱好者想学习如何将LLM与实际业务系统CRM结合了解Docker化AI应用的架构。有私有化部署需求的团队对数据安全敏感不希望客户对话数据经过第三方服务器。能解决什么问题自动化客户接待7x24小时响应常见问题减轻人工客服压力。销售线索筛选与孵化自动分析客户对话识别购买意向并打分或分类。标准化话术支持为销售新人实时生成符合场景的专业回复建议。企业内部知识库将产品文档、规章制度导入员工可快速查询。使用边界与注意事项模型能力限制最终效果严重依赖底层大模型的能力。如果使用较小的本地模型在复杂逻辑、多轮对话或专业领域上可能表现不佳。冷启动问题系统需要“喂养”知识上传文档、配置话术才能更好地回答特定领域问题。合规与隐私客户数据虽然私有化部署但仍需确保你获取和使用客户对话数据的合法性遵守相关隐私法规。生成内容审核AI生成的内容可能存在事实性错误或不妥表述关键场景需加入人工审核环节。模型版权若使用第三方商用模型API如GPT-4需确保拥有合法使用权限。3. 环境准备与前置条件部署“悟空 AICRM”需要一套基础环境。请确保你的服务器或本地电脑满足以下条件。3.1 系统与Docker环境操作系统推荐Linux (Ubuntu 20.04/22.04, CentOS 7/8)或Windows 10/11 (需安装WSL2)。macOS也支持。Docker Engine版本20.10.0或更高。这是运行容器的基础。Docker Compose版本v2.0.0或更高。用于编排和启动多个服务。Git用于拉取项目代码。如何检查在终端中执行以下命令# 检查Docker版本 docker --version # 检查Docker Compose版本 docker compose version # 检查Git版本 git --version如果未安装需要先进行安装。以Ubuntu为例# 更新软件包索引 sudo apt-get update # 安装Docker sudo apt-get install docker.io docker-compose git -y # 启动Docker服务并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 将当前用户加入docker组避免每次用sudo sudo usermod -aG docker $USER # 退出终端重新登录使组生效3.2 硬件与网络CPU与内存如核心能力速览所述建议4核8GB以上。内存不足会导致容器启动失败或运行缓慢。磁盘空间至少预留20GB可用空间用于存放Docker镜像、模型文件如果本地部署、数据库和日志。网络服务器需要能访问互联网以下载Docker镜像和可能的模型文件。如果使用云端模型API则需要能访问对应服务商如OpenAI的网络。端口确保以下端口未被占用或准备好修改项目配置。80或8080Web前端访问端口。3000后端API服务端口常见。3306MySQL数据库端口内部使用通常不对外暴露。4. 安装部署与启动方式一切就绪我们开始部署。整个过程围绕Docker Compose进行非常清晰。4.1 获取项目代码首先将“悟空 AICRM”的代码仓库克隆到本地。# 假设项目仓库地址为请根据实际项目地址替换 git clone https://github.com/xxx/wukong-aicrm.git # 进入项目目录 cd wukong-aicrm重要由于输入材料未提供确切的项目仓库地址此处为示例。在实际操作中你需要找到该项目的官方或开源仓库地址进行替换。通常这类项目会在GitHub、Gitee等平台发布。4.2 配置环境变量大多数Docker化项目通过环境变量文件.env进行配置。在项目根目录下通常会有.env.example或config.example.yaml之类的示例文件。复制示例配置文件cp .env.example .env编辑.env文件使用vim、nano或任何文本编辑器打开根据注释修改关键配置。nano .env核心配置项说明以下为常见项请以实际文件为准# 数据库配置 MYSQL_ROOT_PASSWORDyour_strong_password_here MYSQL_DATABASEaicrm MYSQL_USERaicrm_user MYSQL_PASSWORDaicrm_password # 后端服务配置 API_HOST0.0.0.0 API_PORT3000 # 前端服务配置 WEB_PORT8080 # AI模型配置关键 # 模式选择local本地模型 或 api云端API LLM_PROVIDERlocal # 如果选择 local需指定本地模型名称和路径 LOCAL_MODEL_NAMEchatglm3-6b LOCAL_MODEL_PATH/app/models/chatglm3-6b # 如果选择 api需配置API Key和Base URL # OPENAI_API_KEYsk-xxx # OPENAI_API_BASEhttps://api.openai.com/v1 # 或者使用国内模型 # DASHSCOPE_API_KEYsk-xxx重点LLM_PROVIDER的选择决定了部署复杂度和资源需求。local模式需要提前下载好大模型文件并挂载到容器内。对显存/内存要求高但数据完全本地无网络依赖。api模式无需本地模型直接调用如OpenAI、通义千问、智谱AI等云端服务。部署简单但会产生API费用且对话数据会出境若使用国外服务。4.3 启动所有服务配置完成后使用一条命令启动所有容器。# 在项目根目录docker-compose.yml所在目录执行 docker-compose up -d参数-d表示在后台运行。执行后会发生什么Docker会从镜像仓库拉取Pull项目所需的各个镜像如MySQL、Redis、后端、前端。根据docker-compose.yml和.env的配置创建并启动多个容器。容器之间会建立网络使得前端能访问后端后端能访问数据库和AI模型服务。4.4 查看服务状态与日志启动后检查服务是否正常运行。# 查看所有容器状态 docker-compose ps你应该看到所有服务的状态State都是Up。如果某个服务启动失败查看其日志定位问题# 查看所有服务的日志 docker-compose logs # 查看特定服务如后端的日志 docker-compose logs backend4.5 访问Web管理界面如果一切顺利现在可以通过浏览器访问AICRM的管理界面了。地址http://你的服务器IP:WEB_PORT例如如果你在本地部署且WEB_PORT8080则访问http://localhost:8080如果在云服务器部署需将localhost替换为服务器的公网IP并确保安全组/防火墙放行了该端口。首次访问通常会进入初始化页面可能需要设置管理员账号密码或进行一些基础配置。5. 功能测试与效果验证服务跑起来后我们需要验证核心功能是否正常。我们从最基本的操作开始。5.1 基础登录与系统检查登录管理后台使用初始化时设置的管理员账号登录。检查系统状态在管理后台的“系统状态”或“仪表盘”页面查看数据库连接是否正常。AI模型服务状态是否就绪显示“已连接”或类似状态。各服务组件如Redis是否在线。5.2 AI对话功能测试这是核心功能。在系统中找到“对话测试”、“智能客服”或类似的入口。测试用例1通用知识问答操作在对话窗口输入“你好请介绍一下你自己。”预期AI应能生成一段自我介绍说明它是悟空AICRM的智能助手。成功标准能收到一段连贯、合理的文本回复无报错。测试用例2业务场景测试需先配置知识库前置在“知识库管理”中上传一份简单的产品PDF文档或添加几条产品QA。操作输入一个文档中明确存在的问题例如“你们的产品支持哪些支付方式”预期AI应能根据上传的知识库内容给出准确或相关的答案。成功标准答案来源于知识库而非通用模型知识。这验证了RAG检索增强生成功能是否生效。5.3 客户与工单管理测试创建测试客户在“客户管理”中手动添加一个测试客户填写姓名、电话等基本信息。发起模拟对话在该客户的详情页模拟一次客户咨询。系统应能记录完整的对话历史。创建工单基于某次对话尝试创建一个工单例如“客户反馈登录问题”并指派给某个客服角色。检查工单状态流转是否正常。5.4 批量任务测试批量导入客户准备一个CSV文件包含姓名,手机号,邮箱等字段。在系统找到“批量导入”功能上传该文件。系统应能解析并导入客户数据提供成功/失败报告。批量分析如果功能存在选中多个客户执行“批量意向分析”操作。系统应能异步处理并更新客户的意向标签或评分。6. 接口 API 与批量任务对于开发者通过API集成是更常见的用法。我们来验证后端API是否可用。6.1 API服务状态检查通常后端API会提供一个健康检查端点。# 使用curl测试API健康状态 curl http://localhost:3000/health # 或 curl http://localhost:3000/api/health预期返回{status: ok}或类似JSON表明API服务运行正常。6.2 核心API调用示例假设我们需要通过API让AI回答一个问题。步骤1获取认证Token如果API需要curl -X POST http://localhost:3000/api/auth/login \ -H Content-Type: application/json \ -d {username:admin, password:your_admin_password}从返回的JSON中提取access_token。步骤2调用对话APIcurl -X POST http://localhost:3000/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer YOUR_ACCESS_TOKEN \ -d { model: gpt-3.5-turbo, # 这里应与后台配置的模型名称一致 messages: [{role: user, content: 北京明天的天气怎么样}], stream: false }参数说明model: 指定使用的模型需与系统配置匹配。messages: 对话历史是一个数组。stream: 是否使用流式输出true/false。预期返回{ id: chatcmpl-xxx, choices: [{ index: 0, message: { role: assistant, content: 我是一个AI助手无法提供实时天气信息... } }] }6.3 批量任务API集成思路系统本身可能提供批量处理的API端点。如果没有常见的工程化做法是编写脚本用Python读取客户列表CSV。循环调用针对每个客户调用对话API传入预设的调研问题。结果收集将AI的回复解析并存储到数据库或新的CSV中。加入容错在脚本中加入重试机制和日志记录。import pandas as pd import requests import time import logging logging.basicConfig(levellogging.INFO) API_URL http://localhost:3000/api/chat/completions TOKEN YOUR_TOKEN_HERE headers {Authorization: fBearer {TOKEN}, Content-Type: application/json} def ask_ai(question): payload { model: gpt-3.5-turbo, messages: [{role: user, content: question}], stream: False } try: resp requests.post(API_URL, jsonpayload, headersheaders, timeout60) resp.raise_for_status() return resp.json()[choices][0][message][content] except Exception as e: logging.error(fAPI调用失败: {e}) return None # 读取客户数据 df pd.read_csv(clients.csv) results [] for idx, row in df.iterrows(): client_name row[name] # 构造针对该客户的问题 question f假设你是销售向{client_name}介绍我们的核心产品用一段话。 answer ask_ai(question) results.append({client: client_name, ai_response: answer}) time.sleep(1) # 避免请求过快 # 保存结果 pd.DataFrame(results).to_csv(batch_ai_results.csv, indexFalse) logging.info(批量任务完成。)7. 资源占用与性能观察部署完成后需要关注系统的资源消耗这对长期稳定运行至关重要。7.1 查看容器资源占用使用Docker命令可以方便地查看各个容器的CPU、内存使用情况。# 查看所有容器的实时资源占用类似Linux top命令 docker stats这个命令会动态显示每个容器的CPU百分比、内存使用量/限制、网络IO等。重点关注内存MEM USAGE如果某个容器尤其是运行AI模型的容器内存使用持续接近其限制可能导致服务崩溃。7.2 性能影响因素AI模型选择这是最大的性能变量。本地70B模型和6B模型对显存和速度的需求是天壤之别。并发请求量如果多人同时使用对话功能后端和AI模型容器的压力会增大。需要根据实际并发数调整容器资源限制在docker-compose.yml中配置deploy.resources。知识库规模当知识库文档非常多时检索阶段可能会变慢。考虑对向量数据库进行性能优化或分库。数据库性能MySQL容器如果未配置合适的缓存在大量日志写入时可能成为瓶颈。7.3 如何降低资源占用如果使用本地模型如果发现资源紧张可以尝试量化模型使用4-bit或8-bit量化版本的模型能显著减少显存占用精度损失通常可接受。使用更小模型从ChatGLM3-6B切换到更小的模型如Qwen1.5-1.8B。启用CPU推理如果对响应速度要求不高可以强制在CPU上推理通常通过环境变量如DEVICEcpu设置。调整Docker资源限制在docker-compose.yml中为模型服务容器设置明确的内存和CPU限制防止其占用所有主机资源。8. 常见问题与排查方法部署过程中难免遇到问题这里汇总一些常见情况。问题现象可能原因排查方式解决方案docker-compose up失败提示Cannot connect to the Docker daemonDocker服务未启动或当前用户无权限。运行systemctl status docker和groups $USER。启动Docker服务sudo systemctl start docker。将用户加入docker组后需重新登录终端。前端页面无法访问连接被拒绝1. 容器未成功启动。2. 端口被占用或防火墙阻止。3. 前端容器内部服务出错。1.docker-compose ps查看状态。2.netstat -tlnp | grep :8080查看端口。3.docker-compose logs frontend查看前端日志。1. 根据日志修复启动错误。2. 修改.env中的端口号或关闭占用端口的进程。3. 检查前端构建是否成功。后台提示“AI模型服务未连接”1. AI模型容器启动失败。2. 网络配置错误后端无法访问模型服务。3. 模型文件缺失或路径错误。1.docker-compose logs llm-service容器名可能不同查看模型服务日志。2.docker network inspect检查容器网络。3. 进入模型容器检查文件docker exec -it container_id ls /app/models。1. 根据日志解决依赖或配置问题。2. 确保docker-compose.yml中服务在同一个自定义网络内。3. 确认模型文件已正确下载并挂载。对于local模式这是最常见的问题。API调用返回401/403错误1. 未提供Token或Token过期。2. Token格式错误。检查请求头中的Authorization字段。重新登录获取有效Token并确保在请求头中正确添加Bearer YOUR_TOKEN。对话响应速度极慢1. 使用CPU推理。2. 模型过大硬件性能不足。3. 知识库检索文档过多。1. 查看模型服务日志确认运行设备。2. 使用docker stats观察资源瓶颈。3. 测试不启用知识库的纯对话速度。1. 如有GPU配置使用GPU。2. 换用更小的量化模型。3. 优化知识库对文档进行切分和索引。批量导入客户失败1. CSV文件格式不正确编码、列名。2. 数据库字段约束不满足如唯一键重复。1. 查看导入失败的报告通常会有错误行提示。2. 查看后端容器日志。1. 使用UTF-8编码确保列名与模板一致。2. 清理CSV中的重复数据或空行。通用排查流程看日志docker-compose logs [service-name]是定位问题的第一选择。查状态docker-compose ps确认所有服务都是Up状态。进容器docker exec -it container_id /bin/bash进入容器内部检查配置文件、进程和文件是否存在。验网络在一个容器内ping另一个容器的服务名检查网络连通性。9. 最佳实践与使用建议为了让“悟空 AICRM”稳定、安全地运行这里有一些经验之谈。首次部署从简第一次尝试强烈建议使用LLM_PROVIDERapi模式并配置一个可用的云端大模型API如DeepSeek、通义千问等。这能绕过本地模型部署的复杂性和硬件要求让你快速验证业务流程。使用默认端口避免修改过多配置。数据持久化与备份在docker-compose.yml中确保MySQL、Redis等有状态服务的数据卷volumes配置指向了宿主机的持久化目录如./data/mysql:/var/lib/mysql。定期备份./data目录和重要的上传文件如知识库文档。生产环境安全加固修改默认密码务必修改.env文件中的数据库root密码、应用管理员密码。限制访问通过防火墙或云安全组仅允许必要的IP访问管理后台端口如8080和API端口如3000。启用HTTPS使用Nginx反向代理并配置SSL证书避免数据明文传输。容器更新关注项目更新定期拉取新镜像并重启服务以获取功能更新和安全补丁。模型与知识库优化知识库质量上传给AI的文档要清晰、结构好。杂乱无章的文档会导致检索效果差。建议先整理成QA对或分段清晰的Markdown。提示词工程在系统后台的“模型配置”或“提示词模板”中精心设计系统提示词System Prompt这能极大地影响AI在业务场景中的表现。效果迭代上线后从对话日志中找出回答不佳的案例分析是知识库缺失、提示词问题还是模型能力边界然后针对性优化。合规使用明确告知用户正在与AI交互。对AI生成的关键业务信息如价格、政策进行人工复核。妥善保管对话日志建立数据保留和删除政策。10. 总结与下一步通过以上步骤你应该已经成功在本地或服务器上部署了“悟空 AICRM”系统并对其核心功能、API调用和资源管理有了基本了解。这个项目的最大优势在于提供了一个开箱即用的、Docker化的AI业务应用框架极大地降低了技术集成门槛。最值得尝试的点快速验证AICRM场景如果你有一个想法想看看AI能否赋能你的客户服务用这个项目几天内就能搭出可演示的原型。学习Docker化AI应用架构它的docker-compose.yml是很好的学习样本展示了如何将LLM服务、Web应用、数据库组合在一起。最先应该验证的功能对话流畅性用api模式测试多轮对话是否连贯。知识库问答上传一份产品手册测试AI能否准确回答基于文档的问题。数据流转走通“客户咨询 - AI回复 - 生成工单”这个核心业务流程。最容易踩的坑本地模型文件如果选择local模式模型下载、路径配置、格式兼容是主要障碍。务必仔细阅读项目文档关于模型准备的说明。端口冲突默认端口可能被占用学会查看日志和修改.env配置。资源不足尤其是内存8GB内存运行本地6B模型可能很吃力监控docker stats是关键。后续可以探索的方向集成更多模型尝试接入不同的云端或本地模型对比效果和成本。自定义开发基于其提供的API开发新的前端界面或将其对话能力嵌入到你的现有网站、小程序、APP中。流程自动化结合Zapier、n8n或钉钉/飞书机器人将AI识别的客户意向自动同步到你的CRM或通知销售。建议将本文作为部署手册收藏在实际操作时按章节查阅。遇到具体问题优先查看项目本身的Issue和文档通常能找到解决方案。
