Bots de atendimento ao cliente com IA que são automaticamente operados por vendedores da Idle Fish 24 horas por dia

Introdução geral

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

Lista de funções

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

Usando a Ajuda

Processo de instalação

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

1. armazém de clones
   打开终端（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. Instalação de dependências
   在终端输入以下命令，安装所需工具包：

 pip install -r requirements.txt

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

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

4. Configuração de variáveis de ambiente
   在项目文件夹中新建  .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. programa de corrida
   配置完成后，输入命令启动：

 python main.py

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

Funções principais

1. 7×24小时自动值守

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

2. 上下文感知对话

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

3. 智能议价

• Como usar：买家出价时，机器人按阶梯降价策略回应。
• procedimento：商品标价 150 元，买家出 100 元，机器人可能回“最低 130 元，您看行吗？”。策略在代码中预设，无需手动调整。
• Configurações personalizadas：编辑  price_prompt.txt ，修改降价幅度或最低价。

Funções em destaque Procedimento de operação

多专家协同

• 如何开启Ativado por padrão. O programa distribui tarefas a diferentes especialistas por meio do reconhecimento de intenções.
• procedimentoO usuário não precisa intervir: os compradores perguntam o preço, os especialistas em preços respondem; perguntam detalhes técnicos, os especialistas técnicos assumem o controle. O usuário não precisa intervir.
• Método de ajusteModificar prompts de especialista na pasta de prompts ou adicionar novos tipos de especialista.

网络搜索整合

• Como usarO módulo de suporte técnico pode ser conectado em rede para buscar respostas.
• procedimentoOs compradores perguntam "Esse celular é compatível com 5G?". Após a pesquisa, o robô responde "It supports 5G, the specific model is XX". A função é executada automaticamente.
• Recomendações de otimizaçãoVerifique se sua rede está aberta para evitar tempos limite de busca.

基础日志监控

• Como visualizarArquivos de registro: Os arquivos de registro são gerados quando o programa é executado.
• procedimentoAbra o arquivo de registro (geralmente log.txt) no diretório do projeto e veja o registro de tempo de execução. Por exemplo, "2025-03-18 10:00: Resposta bem-sucedida à mensagem".
• usoUsado para solucionar problemas, por exemplo, verificar se há mensagens perdidas.

Perguntas frequentes

• Falha na inicialização do procedimentoVerificar as versões do Python e do NodeJS e verificar se as dependências estão completas.
• Respostas imprecisasSubstitua o OPENAI_API_KEY por um mais forte ou ajuste o arquivo de texto do prompt.
• Anomalia na conta do IdlefishFaça login novamente na versão da Web para atualizar os cookies.
• interrupção de tempo de execuçãoVerifique a conexão de rede ou, em vez disso, execute-o localmente com um servidor em nuvem.

cenário do aplicativo

1. Vendedor de peixes ocioso e ocupado
   Descrição do cenário: Você recebe muitas solicitações todos os dias, mas não tem tempo para responder a todas elas. O XianyuAutoAgent protege automaticamente a loja, lida com as mensagens e as pechinchas, e tudo o que você precisa fazer é confirmar o negócio.
2. Tecnologia de IA Aprendizagem
   DESCRIÇÃO DO CENÁRIO: Você é novo em programação e quer aprender sobre aplicativos de IA. Faça o download deste projeto e estude o código e as palavras-chave para aprender rapidamente como desenvolver um atendimento inteligente ao cliente.
3. Loja de colaboração múltipla
   Descrição do cenário: a equipe administra o negócio de peixes ociosos. Os robôs respondem de maneira uniforme para garantir um nível consistente de atendimento ao cliente e reduzir os custos de coordenação manual.

QA

1. Preciso pagar?
   Resposta: O projeto é gratuito e de código aberto, e pode ser baixado diretamente do GitHub. No entanto, você precisa pagar uma pequena taxa para usar a API do OpenAI.
2. Foi difícil de instalar?
   Resposta: Não é difícil. Desde que você saiba como usar um terminal para inserir comandos e seguir as etapas, você pode fazer isso. Funciona mesmo que você não saiba programar.
3. Serei bloqueado pelo Idle Fish?
   Resposta: Oficialmente não é explicitamente proibido, mas a operação em alta frequência pode ser arriscada. Recomenda-se controlar a velocidade de resposta e cumprir as regras da plataforma.