Introdução geral
Coze on WeChat é um projeto de código aberto criado para ajudar os usuários a integrar perfeitamente os bots de IA da plataforma Coze ao WeChat. Ele se baseia no chatgpt-on-wechat e no dify-on-wechat e oferece suporte a bate-papo de texto, reconhecimento e resposta de voz, funcionalidade de plug-in e envio de imagens e links. O projeto usa o protocolo do iPad do Gewechat para fazer login no WeChat, que é mais estável do que o itchat tradicional. Os usuários precisam criar bots na plataforma Coze e, por meio de uma configuração simples, podem obter uma interação inteligente no WeChat. O projeto oferece uma interface de gerenciamento baseada na Web para facilitar o ajuste das configurações. Desde março de 2025, ele está sendo seguido por desenvolvedores no GitHub e é adequado para indivíduos ou equipes criarem assistentes inteligentes para o WeChat.
Configuração do COZE
Configuração de back-end do Coze no WeChat
Lista de funções
- bate-papo por textoBate-papos privados e em grupo são suportados, e o bot se lembra do contexto da conversa para fornecer respostas coerentes.
- interação por vozReconhece a entrada de voz em 20 segundos e oferece suporte a respostas de voz.
- Suporte a plug-insFuncionalidade do plug-in Docking Coze para transformar cartões de plug-in em links do WeChat.
- entrega de multimídiaCapacidade de enviar imagens, links e outros conteúdos para aprimorar a experiência interativa.
- Interface de gerenciamento da WebAjuste dos parâmetros do robô por meio da página da Web sem modificar o código.
- função de base de conhecimentoCarregar arquivos ou conteúdo da Web e permitir que o robô responda a perguntas com base nesses dados.
Usando a Ajuda
Processo de instalação
O uso do Coze no WeChat requer a preparação do ambiente e a conclusão da implantação. Veja a seguir as etapas detalhadas:
1. trabalho preparatório
- Inscreva-se em uma conta CozeVisite o site da Coze, registre-se e faça login. Clique em "Create Robot" para configurar seu robô.
- Obtendo a chave da APINa página "Personal Access Token" do Coze (link (em um site)) Gere o token e salve-o.
- ferramenta de montagemGit para fazer download de código e Docker para executar serviços.
- Selecione o método de implantaçãoSuporte para execução local, execução no servidor e implantação do Docker, basta escolher um.
2. fazer o download do projeto
Digite-o em um terminal ou na linha de comando:
git clone https://github.com/JC0v0/Coze-on-Wechat
cd Coze-on-Wechat
Isso fará o download do código do projeto e entrará no diretório.
3. ambiente de configuração
Implementação local ou em servidor
- Criação de um ambiente virtual(Opcional, mas recomendado):
- Use venv:
python3 -m venv Coze-on-Wechat source Coze-on-Wechat/bin/activate # Windows com Coze-on-Wechat\Scripts\activate
- Use conda:
conda create -n Coze-on-Wechat python=3.12 conda activate Coze-on-Wechat
- Use venv:
- Instalação de dependências::
pip3 install -r requirements.txt
- Configurar o config.json::
cp config.json.example config.json
Abrir com um editor de texto config.json
Preencha os campos-chave abaixo:
{
"coze_api_base": "https://api.coze.cn",
"coze_api_key": "Sua chave de API",
"coze_bot_id": "Seu ID de bot", // Obtenha-o no URL da página de desenvolvimento da Coze
"channel_type": "gewechat", "model": "coze": "coze_bot_id", // Do URL da página de desenvolvimento da Coze.
"single_chat_prefix": ["bot", "@bot"], // Termo de acionamento de chat privado
"group_chat_prefix": ["@bot"], // Palavra acionadora do chat em grupo
"group_name_white_list": ["ALL_GROUP"] // Grupos que permitem respostas de bots
}
Implementação do Docker
- Puxando espelhos Gewechat::
docker pull registro.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine
docker tag registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine gewe
- Criação de um catálogo de dados::
mkdir -p gewechat/data
- Cópia de arquivos de configuração::
cp config-template.json config.json
- Início dos serviços::
docker-compose up -d
4. ativação e login
- operação local::
python3 app.py
- operação do servidor::
nohup python3 app.py & tail -f nohup.out
- Operação da interface da Web::
cd web
streamlit run Home.py
entrevistas http://localhost:8501
A configuração é feita na página da Web.
- Implementação do DockerVerificação do registro após a inicialização: Verifique o registro após a inicialização:
registros do docker -f coze-on-wechat
- Faça login no WeChatUm link de código QR será exibido no registro, abra o link e faça a leitura com o WeChat para fazer login.
5. funções de teste
Depois de fazer login, envie uma mensagem para o teste de bot. Exemplo:
- Bate-papo privado: digite "bot hello" ou "@bot hello".
- Bate-papo em grupo: digite "@bot Today's Weather" no grupo da lista de permissões.
Função Fluxo de operação
bate-papo por texto
- bate-papo privadoMensagem: Envie uma mensagem diretamente para o bot, por exemplo, "bot check weather", e ele responderá.
- bate-papo em grupoAdicionar acionadores de perguntas com "@bot" em grupos permitidos, por exemplo, "@bot que horas chove amanhã".
interação por voz
- enviar uma vozGravação de voz: grave sua voz em 20 segundos e envie-a para o robô, que a reconhecerá e responderá.
- receber um discursoSe a resposta de voz estiver ativada (a ID do tom precisa ser definida em Coze), o robô responderá com voz.
- Configuração de voz: em
config.json
Situado em:
"speech_recognition": true,
"text_to_voice": "coze", "coze_voice_id": "tone_id" // obtido da documentação do Coze
"coze_voice_id": "tone_id" // recuperado do documento Coze
Suporte a plug-ins
- Adicionar plug-ins (por exemplo, consultas de notícias) para bots na plataforma Coze.
- Envie um comando no WeChat (por exemplo, "verificar notícias") e o robô retornará o link do WeChat.
- Exemplo: Envie "check the weather" e o link do clima será retornado.
entrega de multimídia
- O robô pode enviar imagens ou links. Por exemplo, peça "Show me a picture of a cat" (Mostre-me a foto de um gato) e ele enviará uma foto.
Interface de gerenciamento da Web
- Depois de iniciar a interface da Web, acesse a
http://服务器IP:8501
. - Modifique parâmetros como palavras de acionamento, lista branca de grupos etc. na interface sem editar o arquivo.
advertência
- estabilidadeO protocolo do Gewechat para iPad é mais estável, mas é recomendável testá-lo com um número pequeno para evitar o risco do número principal.
- Código de DependênciaA funcionalidade depende da plataforma Coze para garantir que a chave da API seja válida.
- requisito de redeA implementação do servidor exige que as portas correspondentes (por exemplo, 2531, 2532, 9919) estejam abertas.
cenário do aplicativo
- Assistente pessoal
Faça perguntas, obtenha informações ou realize tarefas, como verificar o clima ou fazer anotações no WeChat a qualquer momento. - Gerenciamento de bate-papo em grupo
Os robôs respondem automaticamente a perguntas comuns no grupo, reduzindo a carga sobre os administradores, o que é adequado para grupos de interesse ou de trabalho. - Ferramentas de aprendizado
Após o upload dos materiais de aprendizagem, o robô pode responder a perguntas relevantes e facilitar a revisão dos alunos.
QA
- Preciso configurar a resposta de voz adicionalmente?
Sim, você precisa definir a ID de tom na plataforma Coze e definir a ID de tom na plataforma Coze.config.json
Ative a opção de voz. - Ele suporta o envio de fotos?
o robô pode retornar imagens ou links com base na configuração do Coze. - Qual é a diferença entre a implantação do Docker e a implantação local?
O Docker é mais adequado para implantação de servidor com um clique e gerenciamento simples; a implantação local é adequada para desenvolvimento e depuração.