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

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

🌟 核心特性

智能对话引擎

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

业务功能矩阵

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

🎨效果图

🚴 快速开始

小白请直接查看保姆级教学文档

环境要求

• Python 3.8+

安装步骤

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去掉），否则默认读取四个提示词模板中的内容

使用方法

运行主程序：

python main.py

自定义提示词

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

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

🤝 参与贡献

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

🛡 注意事项

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

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

如需学习交流，请联系：coderxiu@qq.com

📱 交流群

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

💼 寻找机会

@Shaxiu

🔍寻求方向：AI产品经理
📫 联系： email:coderxiu@qq.com；wx: coderxiu

@CVcat

🔍寻求方向：研发工程师（python、java、逆向、爬虫）
groupon 联系： email: 992822653@qq.com；wx: CVZC15751076989

☕ 请喝咖啡

您的☕和⭐将助力项目持续更新：

📈 Star 趋势

XianyuAutoAgent 快速上手指南

XianyuAutoAgent 是一款专为闲鱼平台打造的 AI 客服机器人系统，支持 7×24 小时自动化值守、多专家协同决策（议价/技术/客服）及智能上下文对话。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows / macOS / Linux
• Python 版本：3.8 或更高版本
• 前置依赖：
  • 已注册大模型平台账号并获取 API_KEY（默认支持通义千问，也可配置其他兼容 API）。
  • 已登录闲鱼网页版并获取 Cookies。

2. 安装步骤

第一步：克隆项目

打开终端，执行以下命令下载源码并进入目录：

git clone https://github.com/shaxiu/XianyuAutoAgent.git
cd XianyuAutoAgent

第二步：安装依赖

使用 pip 安装所需库（国内用户可添加清华源加速）：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

第三步：配置环境变量

在项目根目录下创建 .env 文件（或直接重命名 .env.example），并填入以下关键配置：

# 必配配置
API_KEY=你的模型平台 API_KEY
COOKIES_STR=你的闲鱼网页端 Cookies 字符串
MODEL_BASE_URL=模型接口地址 (如使用通义千问默认即可)
MODEL_NAME=模型名称 (如 qwen-turbo)

# 可选配置
TOGGLE_KEYWORDS=.
SIMULATE_HUMAN_TYPING=True

💡 如何获取 Cookies：

1. 浏览器打开闲鱼网页版并登录。
2. 按 F12 打开开发者工具，切换到 Network 标签页。
3. 刷新页面，点击任意一个 Fetch/XHR 请求。
4. 在右侧 Headers 中找到 Cookie 字段，复制其完整内容填入 COOKIES_STR。

第四步：准备提示词模板

确保 prompts 目录下存在有效的提示词文件。您可以将模板文件名称中的 _example 后缀去掉，或直接新建以下文件：

• classify_prompt.txt (意图分类)
• price_prompt.txt (价格专家)
• tech_prompt.txt (技术专家)
• default_prompt.txt (默认回复)

3. 基本使用

完成上述配置后，即可启动机器人：

python main.py

启动成功后，程序将自动监听闲鱼消息。当收到用户咨询时，系统会根据上下文自动路由至“议价专家”、“技术专家”或“默认客服”进行回复。

• 人工接管：在对话中输入配置的切换关键词（默认为句号 .），即可临时切换为人工模式；再次输入则切回 AI 模式。
• 日志查看：运行日志将实时输出到控制台，方便监控运行状态。