https://github.com/tmwgsicp/dify-on-qianniu
基于Clicknium和Dify的轻量千牛智能客服机器人，支持扩展到京东、拼多多等其他电商平台
https://github.com/tmwgsicp/dify-on-qianniu
ai customer-service-chatbot dify
Last synced: about 2 months ago
JSON representation
基于Clicknium和Dify的轻量千牛智能客服机器人，支持扩展到京东、拼多多等其他电商平台
- Host: GitHub
- URL: https://github.com/tmwgsicp/dify-on-qianniu
- Owner: tmwgsicp
- License: mit
- Created: 2025-06-03T15:02:07.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-13T12:05:02.000Z (12 months ago)
- Last Synced: 2025-07-13T13:23:37.319Z (12 months ago)
- Topics: ai, customer-service-chatbot, dify
- Language: Python
- Homepage:
- Size: 432 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dify-on-Qianniu - 千牛智能客服机器人
[](https://www.python.org)
[](LICENSE)
[](https://dify.ai)
[](https://www.clicknium.com/)
> 🎯 **一句话介绍**：通过RPA技术自动监测千牛客服消息，结合AI智能回复，实现7x24小时无人值守客服
## 🎯 项目特点
- **界面自动化**：基于Clicknium，直接操作千牛客户端，无需API接口
- **高度定制**：后端AI基于Dify，智能客服逻辑支持完全定制化
- **轻量设计**：约380行Python代码，依赖简单，轻量运行
- **无限扩展**：支持扩展至众多电商客服平台，开发简单
## 🚀 核心功能
- 🔍 **智能监测**：实时监测千牛客服界面的新消息通知
- 📸 **内容识别**：自动截取聊天记录，AI提取图像中的文本信息
- 🤖 **智能回复**：基于Dify生成专业的客服回复内容
- 🔄 **自动分流**：复杂问题自动转人工，简单问题AI处理
- ⚡ **自动操作**：自动发送回复、转人工等界面操作
## 🚀 快速开始
### 环境要求
- Python 3.9+
- Windows 系统
- Clicknium许可
- VScode（Clicknium支持）
- 千牛客户端
- Dify平台（建议私有化部署）
### 安装步骤
**1. 克隆项目**
```bash
git clone https://github.com/tmwgsicp/dify-on-qianniu.git
cd dify-on-qianniu
```
**2. 安装依赖**
```bash
pip install -r requirements.txt
```
**3. 配置文件**
```bash
cp config.example.json config.json
```
然后编辑 `config.json` 填入你的 API 配置。
**4. 千牛客户端设置**
⚠️ **重要设置**：在千牛客户端进行以下配置，否则机器人可能无法正常工作：
1. 打开千牛客户端
2. 进入 **系统设置** → **接待设置**
3. **勾选**：`关闭客服工作台是否清除正在接待列表已读会话`
**5. 界面元素录制**
使用 Clicknium Studio 录制以下关键界面元素：
| 元素名称 | 用途 | 录制建议 |
|---------|------|---------|
| `new_message` | 检测新消息 | 录制正在接待内的消息提醒 |
| `current_user` | 获取客户名称 | 录制客户名称区域 |
| `chat_window` | 聊天窗口 | 录制完整聊天内容区域 |
| `reply_text` | 消息回复区域 | 录制消息回复区域 |
| `button_send` | 发送按钮 | 录制发送按钮 |
| `button_接待关闭` | 关闭接待中心 | 录制接待中心右上角的关闭按钮 |
| `button_跳转接待中心` | 从工作台跳转接待中心 | 录制工作台界面右上角的旺旺图标 |
| `button_transfer` | 转人工按钮 | 录制接待中心的转人工按钮 |
**6. 运行程序**
```bash
python qianniu_bot.py
```
## ⚙️ 配置说明
### Dify AI 配置
需要在 Dify 中创建两个应用：
1. **对话型应用**：用于智能客服回复，智能客服处理逻辑需自行搭建
2. **工作流应用**：用于图像内容识别，获取千牛客户端内客户对话内容
### 配置文件示例
```json
{
"dify": {
"vision_api_url": "https://api.dify.ai/v1/workflows/run",
"chat_api_url": "https://api.dify.ai/v1/chat-messages",
"file_upload_url": "https://api.dify.ai/v1/files/upload",
"api_key": "app-your-chat-api-key",
"vision_api_key": "app-your-vision-api-key"
},
"clicknium": {
"license_key": "your-clicknium-license-key"
},
"settings": {
"check_interval": 2,
"use_screenshot": true,
"cleanup_screenshots": true
}
}
```
## 🔧 工作原理
```mermaid
graph TD
A[监测新消息] --> B{有新客户?}
B -->|是| C[截取聊天截图]
B -->|否| A
C --> D[AI提取文本内容]
D --> E[生成智能回复]
E --> F{需要转人工?}
F -->|是| G[转人工处理]
F -->|否| H[发送AI回复]
G --> A
H --> A
```
## 📁 项目结构
```
dify-on-qianniu/
├── qianniu_bot.py # 主程序文件
├── config.example.json # 配置文件模板
├── requirements.txt # Python依赖
├── .locator/ # Clicknium界面定位器
├── screenshots/ # 聊天截图缓存
├── .github/ # GitHub配置
│ └── ISSUE_TEMPLATE/ # Issue模板
└── README.md # 项目说明
```
## 🛠️ 故障排除
### 常见问题
1. **机器人无法检测到新消息**
- 检查千牛客户端设置：**系统设置** → **接待设置** → 勾选 `关闭客服工作台是否清除正在接待列表已读会话`
- 重新录制消息提示区域的界面元素
2. **界面识别失败**
- 重新录制界面元素
- 检查千牛客服界面是否有更新
- 确认千牛客户端版本兼容性
3. **API 调用失败**
- 检查网络连接
- 验证 Dify API 密钥是否正确
- 确认 Dify 应用配置正确
4. **截图功能异常**
- 确认系统显示设置
- 检查权限设置
- 验证截图保存路径是否正确
5. **程序启动失败**
- 检查 Clicknium 许可证
- 确认配置文件格式正确
- 验证 Python 版本是否为 3.9+
## 🚀 扩展开发
### 平台适配
理论上可以适配其他电商客服平台：
- 京东
- 拼多多
- 抖音
- 其他电商客服
> 💡 **提示**：核心处理逻辑已实现，扩展新平台主要是界面适配工作
## 📄 许可证
本项目采用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。
## ⚠️ 免责声明
- 本项目仅供学习和研究使用
- 使用时请遵守相关平台的服务条款
- 建议在测试环境充分验证后再用于生产
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！
## 📞 联系与交流
### 💬 技术交流与学习指导
如果你在部署过程中遇到问题，或者想要学习更多关于AI自动化、AI工作流的技术，欢迎添加我的联系方式进行交流：
扫码添加联系方式，获取技术支持和学习指导
### 🎯 问题反馈
对于一般性问题和Bug报告，请优先通过 [GitHub Issues](https://github.com/tmwgsicp/dify-on-qianniu/issues) 提交，这样可以帮助更多用户。
## ☕ 支持项目
如果这个项目对你有帮助，欢迎请我喝杯奶茶！你的支持是我持续更新和维护项目的动力。
感谢你的支持与鼓励！
### 🙏 其他支持方式
- ⭐ 给项目一个 Star
- 🐛 提交 Bug 报告和改进建议
- 📢 向朋友推荐这个项目
- 🔧 贡献代码和文档
---
**⭐ 如果这个项目对你有帮助或启发，请给个Star支持一下！**