AI-CS：开源AI智能客服系统，AI+人工一体、支持私有化部署

标签: AI客服 / 开源项目 / Go / Next.js / RAG / 私有化部署
原文: 微信公众号「一飞开源」https://mp.weixin.qq.com/s/9zP6simXvq4MCMeZuQ237g

核心亮点

AI-CS 是一款 MIT 协议开源的 AI 智能客服系统，融合 AI 与人工客服，支持私有化部署。Go (Gin) 后端 + Next.js 前端 + MySQL + Milvus 向量库，内置 RAG 知识库检索、多模型管理、日志中心、数据报表和 SEO 官网，三步即可跑通。适合把"官网右下角客服小窗"与"客服工作台"一起落地的团队。

功能概览

访客侧（嵌入小窗）

右下角聊天小窗，iframe 方式嵌入任意网站
AI 模式 / 人工模式切换
消息提示音、文件上传
可选"本回合联网搜索"开关（后台可控是否对访客展示）

客服侧（工作台）

会话列表、实时消息（WebSocket）、未读角标提示
实时共享草稿输入：双方未发送内容可实时可见
多模型管理（文本/绘画等）与对话配置
提示词管理（Prompt 管理）
知识库管理 + RAG（向量检索，可按需启用；向量库不可用时不影响启动）
日志中心：结构化日志落库，支持按级别/分类/事件/trace_id/关键字筛选排障
数据报表：按日/区间查看访客打开小窗、会话与消息、AI 回复与失败率、知识库命中率、转人工等指标

官网与 SEO

蓝白主题官网首页，分段渐变与滚动进场动效
metadata / Open Graph / JSON-LD / sitemap.xml / robots.txt，便于搜索引擎收录与社交分享

联网搜索

支持 Serper：MCP 接入（SERPER_MCP_URL）或直连 API（SERPER_API_KEY）
支持厂商内置 web search 的 function calling 流程

技术架构

组件	技术选型	版本/说明
后端	Go (Gin)	1.24+
前端	Next.js (React)	Node.js 20.9.0+
数据库	MySQL	8.0+，存储用户、会话、消息等结构化数据
缓存/消息	Redis	可选，多实例部署时 WebSocket 广播和跨实例事件同步
向量数据库	Milvus	可选，知识库向量检索实现 RAG
AI 服务	OpenAI、Claude 等	可接入多家厂商的 AI 模型

架构亮点：

向量库可选：Milvus 不可用时不影响系统启动，RAG 功能按需启用
Redis 可选：单实例部署无需 Redis，多实例时才需要
多模型支持：不绑定单一 AI 厂商，文本/绘画模型均可配置

快速部署（三步跑通）

1. 克隆与配置

git clone https://github.com/2930134478/AI-CS.git

复制 .env 模板，填好数据库与管理员等必填项。

2. 一键启动

使用 Docker Compose 拉起前后端与依赖服务（详见 README）。

3. 嵌入访客端

在站点中挂载聊天小窗，后台完成模型与知识库配置后即可对外服务。

适用场景

企业官网客服系统（替换传统在线客服）
SaaS 产品用户支持（AI 自动回答 + 人工兜底）
电商售后咨询（知识库 RAG + 转人工）
技术文档问答站（文档导入知识库，AI 自动检索回答）
需要私有化部署的政务/金融场景

项目信息

属性	详情
项目名	AI-CS 智能客服系统
开源协议	MIT
GitHub	https://github.com/2930134478/AI-CS
后端	Go (Gin) 1.24+
前端	Next.js (React)
数据库	MySQL 8.0+ / Milvus（可选）/ Redis（可选）
AI 支持	OpenAI、Claude 等多厂商
部署方式	Docker Compose / 二进制部署