闲鱼卖家全天自动值守的AI客服机器人

はじめに

XianyuAutoAgent 是一个专为闲鱼平台设计的智能客服机器人系统，由开发者 shaxiu 在 GitHub 上开源。它通过 AI 技术实现 7×24 小时自动值守，帮助闲鱼卖家回复消息、处理议价和技术咨询。核心功能包括上下文感知对话、智能阶梯式议价和多专家协同决策。项目面向想提升店铺效率的卖家和对 AI 技术感兴趣的开发者，代码免费开放，用户可下载、修改和部署。安装简单，适合个人或小团队使用。

機能一覧

• 7×24小时自动值守：全天候在线，实时响应买家消息。
• 状況に応じた対話：记住对话历史，提供连贯回复。
• 智能议价：基于阶梯降价策略，自动给出合理价格。
• 多专家协同：多个 AI 模型分工合作，处理不同场景。
• 网络搜索整合：技术支持模块可联网查找答案。
• 基础日志监控：记录运行状态，便于排查问题。

ヘルプの使用

設置プロセス

要使用 XianyuAutoAgent，需要在电脑上完成以下步骤：

1. クローン倉庫
   打开终端（Windows 用 CMD 或 PowerShell，Mac 用 Terminal），输入命令下载代码：

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

下载后进入项目目录：

 cd XianyuAutoAgent

2. 检查环境要求

• 确保电脑安装了 Python 3.8 或更高版本。可在终端输入  python --version  检查。
• 安装 NodeJS 18 或更高版本（部分功能可能需要）。从 NodeJS 官网 下载安装。

3. 依存関係のインストール
   在终端输入以下命令，安装所需工具包：

 pip install -r requirements.txt

如果网络不佳，可用国内镜像源：

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

4. 環境変数の設定
   在项目文件夹中新建  .env  文件，用文本编辑器（如记事本或 VS Code）输入：

 OPENAI_API_KEY=你的API密钥
COOKIES_STR=你的闲鱼Cookies

• OPENAI_API_KEY：注册 OpenAI 官网 获取密钥。
• COOKIES_STR：登录闲鱼网页版（xianyu.com），按 F12 打开开发者工具，找到 Cookies，复制完整字符串。保存文件。

5. 准备提示词文件
   项目自带  prompts  文件夹，包含四个默认模板：

• classify_prompt.txt ：意图分类提示词。
• price_prompt.txt ：议价专家提示词。
• tech_prompt.txt ：技术专家提示词。
• default_prompt.txt ：默认回复提示词。
  可直接使用，或根据需要编辑这些文件。

6. ランニングプログラム
   配置完成后，输入命令启动：

 python main.py

终端显示“启动成功”后，机器人开始工作。若失败，检查环境变量或依赖。

主な機能

1. 7×24小时自动值守

• 如何开启：程序运行后自动监听闲鱼消息，无需手动干预。
• 手続き：买家发送消息，机器人立即回复。例如，买家问“在吗？”，机器人可能回“在的，有什么可以帮您？”。
• ほら：保持电脑开机、网络稳定，Cookies 有效。

2. 上下文感知对话

• 使用方法：机器人存储对话历史，确保回复连贯。
• 手続き：买家问“这款包有黑色吗？”，机器人回“有黑色，库存充足”。买家再问“价格呢？”，机器人会接着回答“黑色这款 120 元”。无需用户操作，AI 自动处理。
• 試運転方法：若回复不连贯，可检查  classify_prompt.txt  或更换更强模型。

3. 智能议价

• 使用方法：买家出价时，机器人按阶梯降价策略回应。
• 手続き：商品标价 150 元，买家出 100 元，机器人可能回“最低 130 元，您看行吗？”。策略在代码中预设，无需手动调整。
• カスタマイズされた設定: price_prompt.txtを編集して、値下げや最低価格を変更する。

注目機能 操作手順

多专家协同

• 如何开启デフォルトで有効。このプログラムは、インテント認識によってタスクをさまざまな専門家に分配する。
• 手続きバイヤーが価格を尋ねれば、価格の専門家が回答し、技術的な詳細を尋ねれば、技術的な専門家が引き継ぐ。ユーザーが介入する必要はありません。
• 調整方法プロンプトフォルダ内のエキスパートプロンプトを変更したり、新しいエキスパートタイプを追加することができます。

网络搜索整合

• 使用方法テクニカル・サポート・モジュールは、ネットワークに接続して回答を検索することができます。
• 手続きこの携帯電話は5Gに対応していますか？検索後、ロボットは「5Gに対応しています、具体的な機種は○○です」と答える。この機能は自動的に実行される。
• 最適化の提案検索タイムアウトを避けるため、ネットワークがオープンであることを確認してください。

基础日志监控

• 閲覧方法プログラム実行時にログファイルが生成されます。
• 手続きプロジェクト・ディレクトリにあるログ・ファイル（通常はlog.txt）を開き、実行時のログを見る。例えば、"2025-03-18 10:00: Successful reply to message "と表示されます。
• 使用例えば、メッセージの不在をチェックするなど。

よくある質問

• 手順起動の失敗PythonとNodeJSのバージョンを確認し、依存関係が完全であることをチェックする。
• 不正確な回答OPENAI_API_KEYをより強力なものに置き換えるか、プロンプトのワードファイルを調整する。
• アイドルフィッシュのアカウント異常クッキーを更新するには、ウェブバージョンにログインしてください。
• 実行時中断ネットワーク接続を確認するか、代わりにクラウドサーバーを使ってローカルで実行してください。

アプリケーションシナリオ

1. 忙しいアイドル魚売り
   シナリオ説明: あなたは毎日たくさんの問い合わせを受けるが、そのすべてに返信する時間がない。 XianyuAutoAgentは自動的に店舗を警備し、メッセージと掘り出し物を処理し、あなたは取引を確認するだけでよい。
2. AI技術 学習
   シナリオ説明：あなたはプログラミング初心者で、AIアプリケーションについて学びたいと思っています。このプロジェクトをダウンロードし、コードとキュー・ワードを勉強して、スマートなカスタマーサービスを開発する方法を素早く学んでください。
3. マルチ・コラボレーション・ストア
   シナリオ説明：チームはアイドルフィッシュビジネスを運営している。ロボットが一様に対応することで、一貫した顧客サービスの質を確保し、手作業による調整コストを削減する。

品質保証

1. 支払いは必要ですか？
   答え：このプロジェクトはフリーでオープンソースです。ただし、OpenAIのAPIを使用するには少額の使用料を支払う必要があります。
2. 取り付けは難しかったですか？
   答え：難しいことではありません。ターミナルを使ってコマンドを入力する方法と手順さえ知っていればできます。プログラミングができなくても大丈夫です。
3. アイドル・フィッシュにブロックされますか？
   回答：公式には禁止されていないが、高頻度の運用は危険。返信速度をコントロールし、プラットフォームのルールを遵守することを推奨する。