Introdução geral
O XianyuAutoAgent é um sistema robótico inteligente de atendimento ao cliente projetado para a plataforma Idlefish e de código aberto pelo desenvolvedor shaxiu no GitHub. É um sistema automatizado de 7×24 horas que usa tecnologia de IA para ajudar os vendedores da Idlefish a responder a mensagens, lidar com barganhas e consultas técnicas. Os principais recursos incluem diálogo com reconhecimento de contexto, barganha inteligente por escada e tomada de decisão colaborativa com vários especialistas. O projeto é destinado a vendedores que desejam aumentar a eficiência de suas lojas e a desenvolvedores interessados em tecnologia de IA. O código é gratuito e aberto, e os usuários podem baixá-lo, modificá-lo e implantá-lo. O código é gratuito e aberto, e os usuários podem baixá-lo, modificá-lo e implantá-lo. É fácil de instalar e adequado para indivíduos ou pequenas equipes.
Lista de funções
- Proteção automática 7×24 horasOnline 24 horas por dia, 7 dias por semana, respondendo às mensagens dos compradores em tempo real.
- Diálogo sensível ao contextoLembre-se do histórico do diálogo e forneça respostas coerentes.
- Negociação inteligentePreço: fornece automaticamente preços razoáveis com base em uma estratégia de redução gradual.
- Sinergia de vários especialistasModelos de IA múltiplos trabalham juntos para lidar com diferentes cenários.
- Integração de pesquisa na WebO módulo de suporte técnico pode ser conectado em rede para encontrar respostas.
- Monitoramento básico de registrosRegistros de status operacional para solução de problemas.
Usando a Ajuda
Processo de instalação
Para usar o XianyuAutoAgent, você precisa concluir as seguintes etapas em seu computador:
- armazém de clones
Abra um terminal (CMD ou PowerShell para Windows, Terminal para Mac) e digite o comando para fazer o download do código:
git clone https://github.com/shaxiu/XianyuAutoAgent.git
Faça o download e vá para o diretório do projeto:
cd XianyuAutoAgent
- Inspeção de requisitos ambientais
- Certifique-se de ter o Python 3.8 ou posterior instalado em seu computador. Isso pode ser verificado digitando python --version em um terminal.
- Instale o NodeJS 18 ou posterior (alguns recursos podem ser necessários). Faça o download e instale-o no site oficial do NodeJS.
- Instalação de dependências
Instale os kits necessários digitando o seguinte comando no terminal:
pip install -r requirements.txt
Se a rede for ruim, use uma fonte de espelho doméstica:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
- Configuração de variáveis de ambiente
Crie um novo arquivo .env na pasta do projeto e insira-o em um editor de texto, como o Notepad ou o VS Code:
OPENAI_API_KEY=你的API密钥 COOKIES_STR=你的闲鱼Cookies
- OPENAI_API_KEYRegistre-se no site da OpenAI para obter sua chave.
- COOKIES_STRPara obter mais informações, acesse a versão da Web do Idle Fish (xianyu.com), pressione F12 para abrir as Ferramentas do desenvolvedor, localize Cookies e copie a sequência completa. Salve o arquivo.
- Preparação de um arquivo Cue Word
O projeto vem com uma pasta de prompts que contém quatro modelos padrão:
- classify_prompt.txt : Intenção de classificar a palavra prompt.
- price_prompt.txt: prompt para especialistas em negociação.
- tech_prompt.txt: prompt do tecnólogo.
- default_prompt.txt: palavra padrão do prompt de resposta.
Use-os diretamente ou edite-os conforme necessário.
- programa de corrida
Quando a configuração estiver concluída, digite o comando start:
python main.py
Depois que o terminal exibir "Started successfully" (Iniciado com sucesso), o robô começará a funcionar. Se ele falhar, verifique as variáveis de ambiente ou as dependências.
Funções principais
1. Vigilância automatizada 7 x 24 horas
- Como ligarO programa é executado e escuta automaticamente as mensagens de peixe ocioso sem intervenção manual.
- procedimentoO comprador envia uma mensagem e o bot responde imediatamente. Por exemplo, se um comprador perguntar "Yes?" (Sim?) e o bot pode responder "Yes, how can I help you?" (Sim, como posso ajudá-lo?). O que posso fazer por você?".
- advertênciaCookies funcionam: Mantenha seu computador ligado e sua rede estável.
2. diálogo sensível ao contexto
- Como usarBots: Os bots armazenam o histórico de diálogo para garantir respostas consistentes.
- procedimentoO comprador pergunta: "Essa bolsa vem na cor preta? O robô responde: "Ela vem na cor preta e está em estoque". O comprador então pergunta "Qual é o preço?". O robô responderá "$120 pela preta". Não há necessidade de operação do usuário, processamento automático de IA.
- Método de comissionamentoSe as respostas não forem coerentes, verifique o arquivo classify_prompt.txt ou substitua-o por um modelo mais forte.
3. negociação inteligente
- Como usarQuando um comprador faz uma oferta, o bot responde com uma estratégia de redução.
- procedimentoSe o item estiver listado em US$ 150 e o comprador oferecer US$ 100, o bot poderá responder "US$ 130 no mínimo, você acha que está bom?". A estratégia é predefinida no código, portanto, não há necessidade de ajustá-la manualmente. A estratégia é predefinida no código e não precisa ser ajustada manualmente.
- Configurações personalizadasEdite o arquivo price_prompt.txt para modificar a redução de preço ou o preço mínimo.
Funções em destaque Procedimento de operação
Sinergia de vários especialistas
- Como ligarAtivado 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.
Integração de pesquisa na Web
- 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.
Monitoramento básico de registros
- 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
- 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. - 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. - 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
- 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. - 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. - 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.