综合介绍
XianyuAutoAgent 是一个专为闲鱼平台设计的智能客服机器人系统,由开发者 shaxiu 在 GitHub 上开源。它通过 AI 技术实现 7×24 小时自动值守,帮助闲鱼卖家回复消息、处理议价和技术咨询。核心功能包括上下文感知对话、智能阶梯式议价和多专家协同决策。项目面向想提升店铺效率的卖家和对 AI 技术感兴趣的开发者,代码免费开放,用户可下载、修改和部署。安装简单,适合个人或小团队使用。
功能列表
- 7×24小时自动值守:全天候在线,实时响应买家消息。
- 上下文感知对话:记住对话历史,提供连贯回复。
- 智能议价:基于阶梯降价策略,自动给出合理价格。
- 多专家协同:多个 AI 模型分工合作,处理不同场景。
- 网络搜索整合:技术支持模块可联网查找答案。
- 基础日志监控:记录运行状态,便于排查问题。
使用帮助
安装流程
要使用 XianyuAutoAgent,需要在电脑上完成以下步骤:
- 克隆仓库
打开终端(Windows 用 CMD 或 PowerShell,Mac 用 Terminal),输入命令下载代码:
git clone https://github.com/shaxiu/XianyuAutoAgent.git
下载后进入项目目录:
cd XianyuAutoAgent
- 检查环境要求
- 确保电脑安装了 Python 3.8 或更高版本。可在终端输入 python --version 检查。
- 安装 NodeJS 18 或更高版本(部分功能可能需要)。从 NodeJS 官网 下载安装。
- 安装依赖
在终端输入以下命令,安装所需工具包:
pip install -r requirements.txt
如果网络不佳,可用国内镜像源:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
- 配置环境变量
在项目文件夹中新建 .env 文件,用文本编辑器(如记事本或 VS Code)输入:
OPENAI_API_KEY=你的API密钥 COOKIES_STR=你的闲鱼Cookies
- OPENAI_API_KEY:注册 OpenAI 官网 获取密钥。
- COOKIES_STR:登录闲鱼网页版(xianyu.com),按 F12 打开开发者工具,找到 Cookies,复制完整字符串。保存文件。
- 准备提示词文件
项目自带 prompts 文件夹,包含四个默认模板:
- classify_prompt.txt :意图分类提示词。
- price_prompt.txt :议价专家提示词。
- tech_prompt.txt :技术专家提示词。
- default_prompt.txt :默认回复提示词。
可直接使用,或根据需要编辑这些文件。
- 运行程序
配置完成后,输入命令启动:
python main.py
终端显示“启动成功”后,机器人开始工作。若失败,检查环境变量或依赖。
主要功能操作流程
1. 7×24小时自动值守
- 如何开启:程序运行后自动监听闲鱼消息,无需手动干预。
- 操作步骤:买家发送消息,机器人立即回复。例如,买家问“在吗?”,机器人可能回“在的,有什么可以帮您?”。
- 注意事项:保持电脑开机、网络稳定,Cookies 有效。
2. 上下文感知对话
- 如何使用:机器人存储对话历史,确保回复连贯。
- 操作步骤:买家问“这款包有黑色吗?”,机器人回“有黑色,库存充足”。买家再问“价格呢?”,机器人会接着回答“黑色这款 120 元”。无需用户操作,AI 自动处理。
- 调试方法:若回复不连贯,可检查 classify_prompt.txt 或更换更强模型。
3. 智能议价
- 如何使用:买家出价时,机器人按阶梯降价策略回应。
- 操作步骤:商品标价 150 元,买家出 100 元,机器人可能回“最低 130 元,您看行吗?”。策略在代码中预设,无需手动调整。
- 自定义设置:编辑 price_prompt.txt ,修改降价幅度或最低价。
特色功能操作流程
多专家协同
- 如何开启:默认启用。程序通过意图识别分发任务给不同专家。
- 操作步骤:买家问价格,价格专家回复;问技术细节,技术专家接手。用户无需干预。
- 调整方法:在 prompts 文件夹修改专家提示词,或增加新专家类型。
网络搜索整合
- 如何使用:技术支持模块可联网搜索答案。
- 操作步骤:买家问“这个手机支持 5G 吗?”,机器人搜索后回“支持 5G,具体型号是 XX”。功能自动运行。
- 优化建议:确保网络畅通,避免搜索超时。
基础日志监控
- 如何查看:程序运行时生成日志文件。
- 操作步骤:打开项目目录下的日志文件(通常是 log.txt ),查看运行记录。如“2025-03-18 10:00: 回复消息成功”。
- 用途:排查问题时使用,比如检查是否漏回消息。
常见问题解决
- 程序启动失败:确认 Python 和 NodeJS 版本,检查依赖是否完整。
- 回复不准确:更换更强的 OPENAI_API_KEY,或调整提示词文件。
- 闲鱼账号异常:重新登录网页版,更新 Cookies。
- 运行中断:检查网络连接,或用云服务器代替本地运行。
应用场景
- 忙碌的闲鱼卖家
场景描述:你每天收到大量咨询,但没时间一一回复。XianyuAutoAgent 自动值守店铺,处理消息和议价,你只需确认成交。 - AI技术学习
场景描述:你是编程新手,想了解 AI 应用。下载这个项目,研究代码和提示词,能快速学会如何开发智能客服。 - 多人协作店铺
场景描述:团队经营闲鱼生意。机器人统一回复,确保客服口径一致,减少人工协调成本。
QA
- 需要付费吗?
答案:项目免费开源,GitHub 上可直接下载。但使用 OpenAI API 需要自己支付少量费用。 - 安装难吗?
答案:不难。只要会用终端输入命令,按步骤操作就能完成。不懂编程也能用。 - 会被闲鱼封号吗?
答案:官方未明确禁止,但高频操作可能有风险。建议控制回复速度,遵守平台规则。