shaxiu /XianyuAutoAgent

智能闲鱼客服机器人系统:专为闲鱼平台打造的AI值守解决方案,实现闲鱼平台7×24小时自动化值守,支持多专家协同决策、智能议价和上下文感知对话。

★ 9,690⑂ 1,695👁 50⑃ 28● 78▤ 0
PythonGPL-3.0Created 2025-03-14
+10
日增长
9,690
stars
1,695
forks
50
watchers
28
prs
78
issues
0
releases

README

🚀 Xianyu AutoAgent - 智能闲鱼客服机器人系统

 

专为闲鱼平台打造的AI值守解决方案,实现闲鱼平台7×24小时自动化值守,支持多专家协同决策、智能议价和上下文感知对话。 


 🌟 核心特性

 智能对话引擎
| 功能模块   | 技术实现            | 关键特性                                                     |
| ---------- | ------------------- | ------------------------------------------------------------ |
| 上下文感知 | 会话历史存储        | 轻量级对话记忆管理,完整对话历史作为LLM上下文输入            |
| 专家路由   | LLM prompt+规则路由 | 基于提示工程的意图识别 → 专家Agent动态分发,支持议价/技术/客服多场景切换 |

 业务功能矩阵
| 模块     | 已实现                        | 规划中                       |
| -------- | ----------------------------- | ---------------------------- |
| 核心引擎 | ✅ LLM自动回复✅ 上下文管理 | 🔄 情感分析增强               |
| 议价系统 | ✅ 阶梯降价策略                | 🔄 市场比价功能               |
| 技术支持 | ✅ 网络搜索整合                | 🔄 RAG知识库增强              |
| 运维监控 | ✅ 基础日志                    | 🔄 钉钉集成🔄  Web管理界面 |

 🎨效果图

  
  
  图1: 客服随叫随到




  
  
  图2: 阶梯式议价



   
  
  图3: 技术专家上场



   
  
  图4: 后台log



 🚴 快速开始
小白请直接查看保姆级教学文档
 环境要求
- Python 3.8+

 安装步骤
bash
1. 克隆仓库
git clone https://github.com/shaxiu/XianyuAutoAgent.git
cd XianyuAutoAgent

2. 安装依赖
pip install -r requirements.txt

3. 配置环境变量
创建一个 .env 文件,包含以下内容,也可直接重命名 .env.example :
必配配置
API_KEY=apikey通过模型平台获取
COOKIES_STR=填写网页端获取的cookie
MODEL_BASE_URL=模型地址
MODEL_NAME=模型名称
可选配置
TOGGLE_KEYWORDS=接管模式切换关键词,默认为句号(输入句号切换为人工接管,再次输入则切换AI接管)
SIMULATE_HUMAN_TYPING=True/False 模拟人工回复延迟

注意:默认使用的模型是通义千问,如需使用其他API,请自行修改.env文件中的模型地址和模型名称;
COOKIES_STR自行在闲鱼网页端获取cookies(网页端F12打开控制台,选择Network,点击Fetch/XHR,点击一个请求,查看cookies)

4. 创建提示词文件prompts/_prompt.txt(也可以直接将模板名称中的_example去掉),否则默认读取四个提示词模板中的内容


 使用方法

运行主程序:
bash
python main.py


 自定义提示词

可以通过编辑 prompts 目录下的文件来自定义各个专家的提示词:

- classify_prompt.txt: 意图分类提示词
- price_prompt.txt: 价格专家提示词
- tech_prompt.txt: 技术专家提示词
- default_prompt.txt: 默认回复提示词

 🤝 参与贡献

欢迎通过 Issue 提交建议或 PR 贡献代码,请遵循 贡献指南

 🧸特别鸣谢
本项目参考了以下开源项目:
https://github.com/cv-cat/XianYuApis

感谢@CVcat的技术支持

 🛡 注意事项

⚠️ 注意:本项目仅供学习与交流,如有侵权联系作者删除。

鉴于项目的特殊性,开发团队可能在任何时间停止更新或删除项目。

如需学习交流,请联系:[email protected]

 📱 交流群
欢迎加入项目交流群,交流技术、分享经验、互助学习。

  
    
      交流群26(已满200)
      交流群27(推荐加入)
    
    
      
      
    
  


 💼 寻找机会

 @Shaxiu
🔍寻求方向:AI产品经理  
📫 联系: email:[email protected];wx: coderxiu

 @CVcat
🔍寻求方向:研发工程师(python、java、逆向、爬虫)  
📫 联系: email: [email protected];wx: CVZC15751076989
 ☕ 请喝咖啡
您的☕和⭐将助力项目持续更新:


   
  



 📈 Star 趋势

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON