# cc-ai-agent **Repository Path**: andy150/cc-ai-agent ## Basic Information - **Project Name**: cc-ai-agent - **Description**: 这是一个基于AI Agent架构的智能客服系统，整合了LangChain、Ollama和DeepSeek，具备RAG检索增强生成、意图识别和知识库管理功能。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-02-28 - **Last Updated**: 2026-03-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ![输入图片说明](docs/image.png) # 智能客服系统 智能客服系统是一个基于AI技术的客户服务解决方案，集成了大型语言模型、RAG技术以及多模态能力，为用户提供高效、准确的客户服务。 ## 系统架构图 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 智能客服系统架构 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │ │ │ 用户界面 │ │ API网关 │ │ 后端服务层 │ │ │ │ │ │ │ │ │ │ │ │ Vue3 + │◄──►│ Flask │◄──►│ ┌───────────────┐ │ │ │ │ Element │ │ Router │ │ │ 模型配置管理 │ │ │ │ │ UI │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ - 提供商配置 │ │ │ │ └─────────────┘ └─────────────┘ │ │ - 参数配置 │ │ │ │ │ │ - 提示词配置 │ │ │ │ │ │ - 微调参数配置 │ │ │ │ ┌─────────────┐ ┌─────────────┐ │ └───────────────┘ │ │ │ │ 管理界面 │ │ 身份认证 │ │ │ │ │ │ │ │ 服务 │ │ ┌───────────────┐ │ │ │ │ 配置面板 │◄──►│ │ │ │ 知识库管理 │ │ │ │ │ │ │ │ │ │ │ │ │ │ └─────────────┘ └─────────────┘ │ │ - 文档上传 │ │ │ │ │ │ - 索引管理 │ │ │ │ ┌─────────────┐ ┌─────────────┐ │ │ - 搜索检索 │ │ │ │ │ 移动端APP │ │ WebSocket │ │ │ - 分类标签 │ │ │ │ │ │◄──►│ 通信 │ │ └───────────────┘ │ │ │ └─────────────┘ └─────────────┘ │ │ │ │ │ ┌───────────────┐ │ │ │ │ │ 工单管理系统 │ │ │ │ │ │ │ │ │ │ ┌─────────────┐ ┌─────────────┐ │ │ - 创建编辑 │ │ │ │ │ 第三方集成 │ │ 事件总线 │ │ │ - 状态跟踪 │ │ │ │ │ │ │ 消息队列 │ │ │ - 优先级分类 │ │ │ │ │ (Webhook) │◄──►│ │ │ │ - 智能分配 │ │ │ │ │ │ │ │ │ └───────────────┘ │ │ │ └─────────────┘ └─────────────┘ │ │ │ │ │ ┌───────────────┐ │ │ │ │ │ 智能对话引擎 │ │ │ │ │ │ │ │ │ │ │ │ - RAG检索 │ │ │ │ │ │ - 上下文管理 │ │ │ │ │ │ - 多轮对话 │ │ │ │ │ │ - 意图识别 │ │ │ │ │ └───────────────┘ │ │ │ │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ 数据存储层 │ │ │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ │ │向量数据库 │ │关系数据库│ │缓存服务 │ │文件存储 │ │ │ │ │ │(FAISS) │ │(SQLite) │ │(Redis) │ │(本地/云) │ │ │ │ │ │知识库 │ │工单数据 │ │会话缓存 │ │文档资料 │ │ │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ AI模型层 │ │ │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ │ │ Ollama │ │ OpenAI │ │ DeepSeek │ │ 自定义API│ │ │ │ │ │本地模型 │ │云模型 │ │专业模型 │ │提供商 │ │ │ │ │ │llama3等 │ │GPT系列 │ │Chat/Coder│ │ │ │ │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ ``` ## 功能特性 ### 1. 模型配置管理 系统提供灵活的模型配置管理功能，支持多种大语言模型提供商： - **模型提供商配置** - Ollama（本地模型） - OpenAI（云端模型） - DeepSeek（专业模型） - 自定义API提供商 - **模型参数配置** - 温度调节（Temperature） - 最大令牌数（Max Tokens） - Top-P采样参数 - 频率惩罚和存在惩罚 - **系统提示词配置** - 自定义系统提示词 - 专业指令定制 - **模型微调参数配置** - 学习率设置 - 训练轮次（Epochs） - 批次大小（Batch Size） - 预热步数和权重衰减 ### 2. 知识库管理 强大的知识库管理系统，支持多种文档格式： - 支持文本、PDF、Word等多种格式 - 智能文档分割和索引 - 类别和标签管理 - 搜索和检索功能 ### 3. 工单管理系统 高效的客户服务工单管理： - 工单创建、编辑和跟踪 - 状态管理（待处理、处理中、已解决、已关闭） - 优先级分类（低、中、高、紧急） - 工单类型分类（咨询、投诉、技术支持、产品建议） - 智能分配和处理流程 ### 4. 智能对话 基于RAG和多模态能力的智能对话系统： - 实时AI客服对话 - 基于知识库的精准回答 - 对话记忆和上下文管理 - 多轮对话管理 ### 5. 管理界面 用户友好的Web管理界面： - 模型配置管理 - 知识库管理 - 工单管理 - 统计报表和数据分析 ## 技术架构 ### 前端技术栈 - Vue3 + Composition API - Vite构建工具 - Element Plus UI组件库 - Axios HTTP客户端 ### 后端技术栈 - Python Flask框架 - LangChain框架 - FAISS向量数据库 - Sentence Transformers ### AI模型集成 - Ollama本地模型运行时 - OpenAI API - DeepSeek API - 自定义模型接口 ## 项目结构 ``` cc-ai-agent/ ├── api/ # API端点定义 │ ├── customer_service_api.py # 主API │ ├── ticket_api.py # 工单API │ ├── knowledge_base_api.py # 知识库API │ └── model_config_api.py # 模型配置API ├── backend/ # 后端服务核心 ├── frontend/ # 前端项目 ├── agents/ # AI Agent核心 ├── knowledge_base/ # 知识库模块 ├── llms/ # LLM管理模块 ├── config/ # 配置文件 ├── utils/ # 工具函数 ├── models/ # 模型配置管理 ├── data/ # 数据存储 ├── docs/ # 文档 ├── rag/ # RAG组件 ├── vector_db/ # 向量数据库组件 ├── conversational_memory/ # 对话记忆管理 ├── intent_recognition/ # 意图识别模块 ├── smart_customer_agent/ # 智能客服代理 ├── tools/ # 工具脚本 ├── services/ # 服务模块 ├── web/ # Web组件 ├── .env # 环境变量配置 ├── requirements.txt # Python依赖 ├── start_backend.bat # 后端启动脚本 ├── start_frontend.bat # 前端启动脚本 ├── start_demo.py # 演示启动脚本 ├── install_dependencies.bat # Windows安装脚本 ├── install_dependencies.sh # Linux/macOS安装脚本 ├── install_dependencies.py # Python跨平台安装脚本 └── tickets.db # 工单数据库 ``` ## 安装和部署 ### 环境要求 - Python 3.8+ - Node.js 16+ - Ollama (可选，如使用本地模型) ### 快速启动 1. 克隆项目： ```bash git clone cd cc-ai-agent ``` 2. 安装Python依赖： ```bash pip install -r requirements.txt ``` 3. 安装前端依赖： ```bash cd frontend npm install ``` 4. 启动后端服务： ```bash # 使用conda环境 conda activate ai_agent python start_backend.bat ``` 5. 启动前端服务： ```bash cd frontend npm run dev ``` ## 配置说明 ### 模型配置 系统支持多种大语言模型提供商，可通过管理界面进行配置： 1. **Ollama配置** - 服务地址：默认为 http://localhost:11434 - 支持多种模型：llama3、mistral、gemma等 2. **OpenAI配置** - API密钥设置 - 模型选择：gpt-3.5-turbo、gpt-4等 3. **DeepSeek配置** - API密钥设置 - 模型选择：deepseek-chat、deepseek-coder ### 知识库配置 - 支持批量上传文档 - 自动文档处理和向量化 - 智能分段和索引 ## 使用指南 ### 模型配置管理 通过管理界面可进行以下配置： 1. **选择模型提供商** - 在模型配置界面选择首选的模型提供商 - 根据需求配置相关参数 2. **调整模型参数** - 调整温度参数控制创造性 - 设置最大输出长度 - 调整Top-P和惩罚参数 3. **定制系统提示词** - 根据业务需求定制系统行为 - 设置专业领域指令 ### 知识库管理 1. **上传文档** - 支持拖拽上传多种格式文档 - 自动处理和索引 2. **分类管理** - 为文档设置类别和标签 - 便于搜索和检索 ### 工单管理 1. **创建工单** - 填写工单基本信息 - 设置优先级和类型 2. **处理工单** - 跟踪工单状态 - 更新处理进展 ## API接口 ### 模型配置API - `GET /api/model/config` - 获取当前模型配置 - `PUT /api/model/config` - 更新模型配置 - `POST /api/model/config/reset` - 重置模型配置 - `POST /api/model/test` - 测试模型连接 - `GET /api/model/available` - 获取可用模型列表 - `POST /api/model/fine-tune` - 启动模型微调 - `GET /api/model/fine-tune/status` - 获取微调状态 ### 知识库API - `GET /api/knowledge` - 获取知识库文档列表 - `POST /api/knowledge` - 创建知识库文档 - `PUT /api/knowledge/:id` - 更新知识库文档 - `DELETE /api/knowledge/:id` - 删除知识库文档 ### 工单API - `GET /api/tickets` - 获取工单列表 - `POST /api/ticket` - 创建新工单 - `PUT /api/ticket/:id/status` - 更新工单状态 ## 开发指南 ### 启动脚本 系统提供多种启动方式： - `start_backend.bat` - 启动后端服务 - `start_frontend.bat` - 启动前端服务 - `start_demo.py` - 启动演示程序 - `install_dependencies.bat` - Windows自动安装依赖 - `install_dependencies.sh` - Linux/macOS自动安装依赖 - `install_dependencies.py` - Python跨平台安装依赖 ### 开发模式 在开发过程中，可以分别启动前后端服务进行调试： ```bash # 终端1：启动后端 python start_backend.py # 终端2：启动前端 cd frontend npm run dev ``` ## 贡献指南 欢迎提交Issue和Pull Request来改进项目。 ## 许可证 本项目采用MIT许可证。