Allgemeine Einführung
Coze on WeChat ist ein Open-Source-Projekt, das Benutzern helfen soll, KI-Bots der Coze-Plattform nahtlos in WeChat zu integrieren. Es basiert auf chatgpt-on-wechat und dify-on-wechat und unterstützt Text-Chat, Spracherkennung und -antwort, Plug-in-Funktionen sowie das Senden von Bildern und Links. Das Projekt verwendet das iPad-Protokoll von Gewechat, um sich bei WeChat anzumelden, das stabiler ist als das traditionelle Itchat. Die Nutzer müssen Bots auf der Coze-Plattform erstellen und können durch einfache Konfiguration eine intelligente Interaktion auf WeChat erreichen. Das Projekt bietet eine webbasierte Verwaltungsschnittstelle zur einfachen Anpassung der Einstellungen. Ab März 2025 wird es von Entwicklern auf GitHub verfolgt und ist für Einzelpersonen oder Teams geeignet, um intelligente Assistenten für WeChat zu erstellen.
COZE Konfiguration
Coze auf WeChat Backend Konfiguration
Funktionsliste
- Text-ChatPrivate Chats und Gruppenchats werden unterstützt, und der Bot merkt sich den Kontext des Gesprächs, um kohärente Antworten zu geben.
- Sprach-InteraktionSpracherkennung: Erkennt Spracheingaben innerhalb von 20 Sekunden und unterstützt Sprachantworten.
- Plug-in-UnterstützungDocking Coze-Plugin-Funktionalität, um Plugin-Karten in WeChat-Links zu verwandeln.
- Multimedia-LieferungDie Möglichkeit, Bilder, Links und andere Inhalte zu senden, um das interaktive Erlebnis zu verbessern.
- Web-Management-SchnittstelleEinstellen der Roboterparameter über die Webseite, ohne den Code zu ändern.
- WissensbasisfunktionHochladen von Dateien oder Webinhalten und Beantworten von Fragen durch den Roboter auf der Grundlage dieser Daten.
Hilfe verwenden
Ablauf der Installation
Die Verwendung von Coze auf WeChat erfordert die Vorbereitung der Umgebung und die Fertigstellung der Bereitstellung. Im Folgenden finden Sie die detaillierten Schritte:
1. vorbereitende Arbeiten
- Registrieren Sie sich für ein Coze-KontoBesuchen Sie die Coze-Website, registrieren Sie sich und melden Sie sich an. Klicken Sie auf "Roboter erstellen", um Ihren Roboter einzurichten.
- Abrufen des API-SchlüsselsAuf der Seite "Personal Access Token" von Coze (Link (auf einer Website)) Erzeugen Sie den Token und speichern Sie ihn.
- MontagewerkzeugVergewissern Sie sich, dass auf Ihrem Computer oder Server Git und Docker installiert sind; Git zum Herunterladen von Code und Docker zum Ausführen von Diensten.
- Bereitstellungsmethode auswählenUnterstützt lokale Ausführung, Serverausführung und Docker-Bereitstellung, wählen Sie einfach eine aus.
2. das Projekt herunterladen
Geben Sie ihn in einem Terminal oder in der Befehlszeile ein:
git clone https://github.com/JC0v0/Coze-on-Wechat
cd Coze-on-Wechat
Dadurch wird der Projektcode heruntergeladen und in das Verzeichnis verschoben.
3. die Konfigurationsumgebung
Lokale oder Server-Bereitstellung
- Erstellen einer virtuellen Umgebung(fakultativ, aber empfohlen):
- Verwenden Sie venv:
python3 -m venv Coze-on-Wechat source Coze-on-Wechat/bin/activate # Windows mit Coze-on-Wechat\Scripts\activate
- Verwenden Sie conda:
conda create -n Coze-on-Wechat python=3.12 conda activate Coze-on-Wechat
- Verwenden Sie venv:
- Installation von Abhängigkeiten::
pip3 install -r anforderungen.txt
- config.json konfigurieren::
cp config.json.example config.json
Öffnen mit einem Texteditor config.json
Bitte füllen Sie die folgenden Schlüsselfelder aus:
{
"coze_api_base": "https://api.coze.cn",
"coze_api_key": "Ihr API-Schlüssel",
"coze_bot_id": "Ihre Bot-ID", // Holen Sie sich diese von der Coze-Entwicklungsseite URL
"channel_type": "gewechat", "model": "coze": "coze_bot_id", // von der Coze-Entwicklungsseite URL
"single_chat_prefix": ["bot", "@bot"], // privates Chat-Auslösewort
"group_chat_prefix": ["@bot"], // Auslösewort für Gruppenchat
"group_name_white_list": ["ALL_GROUP"] // Gruppen, die Bot-Antworten erlauben
}
Docker-Bereitstellung
- Gewechat-Spiegel abziehen::
docker pull registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine
docker tag registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine gewe
- Erstellen eines Datenkatalogs::
mkdir -p gewechat/data
- Kopieren von Konfigurationsdateien::
cp config-template.json config.json
- Neue Dienste::
docker-compose up -d
4. aktivierung und anmeldung
- lokaler Betrieb::
python3 app.py
- Serverbetrieb::
nohup python3 app.py & tail -f nohup.out
- Bedienung der Webschnittstelle::
cd web
streamlit run Home.py
Interviews http://localhost:8501
Die Konfiguration erfolgt über die Webseite.
- Docker-BereitstellungPrüfen Sie das Protokoll nach dem Start:
docker logs -f coze-on-wechat
- Bei WeChat anmeldenIm Protokoll wird ein QR-Code-Link angezeigt. Öffnen Sie den Link und scannen Sie ihn mit WeChat, um sich anzumelden.
5. die Prüfung von Funktionen
Senden Sie nach dem Einloggen eine Nachricht an den Bot-Test. Beispiel:
- Privater Chat: Geben Sie "bot hello" oder "@bot hello" ein.
- Gruppen-Chat: Tippen Sie "@bot Today's Weather" in die Whitelist-Gruppe.
Funktion Betriebsablauf
Text-Chat
- Privat-ChatSenden Sie eine Nachricht direkt an den Bot, z. B. "Bot checkt Wetter", und er wird antworten.
- GruppenchatFrageauslöser mit "@bot" in erlaubten Gruppen hinzufügen, z.B. "@bot, wann regnet es morgen".
Sprach-Interaktion
- eine Stimme sendenNehmen Sie Ihre Stimme in 20 Sekunden auf und senden Sie sie an den Roboter, der sie erkennt und antwortet.
- eine Rede haltenWenn die Sprachsteuerung aktiviert ist (die Ton-ID muss in Coze eingestellt werden), antwortet der Roboter mit Sprache.
- Sprache konfigurieren: in
config.json
Eingestellt:
"sprach_erkennung": true,
"text_to_voice": "coze", "coze_voice_id": "tone_id" // abgerufen aus der Coze-Dokumentation
"coze_voice_id": "tone_id" // abgerufen aus der Coze-Dokumentation
Plug-in-Unterstützung
- Hinzufügen von Plug-ins (z. B. Nachrichtenabfragen) für Bots in der Coze-Plattform.
- Senden Sie einen Befehl in WeChat (z. B. "Check News") und der Roboter wird den WeChat-Link zurücksenden.
- Beispiel: Senden Sie "check the weather" und der Wetter-Link wird zurückgegeben.
Multimedia-Lieferung
- Der Roboter kann Bilder oder Links senden. Wenn Sie z. B. fragen: "Zeigen Sie mir ein Bild von einer Katze", wird er ein Bild senden.
Web-Management-Schnittstelle
- Nach dem Start der Weboberfläche rufen Sie die Seite
http://服务器IP:8501
. - Ändern Sie Parameter wie Auslösewörter, Gruppen-Whitelist usw. auf der Benutzeroberfläche, ohne die Datei zu bearbeiten.
caveat
- StabilitätDas iPad-Protokoll von Gewechat ist stabiler, aber es wird empfohlen, es mit einer kleinen Nummer zu testen, um das Risiko der Hauptnummer zu vermeiden.
- Abhängigkeit CozeDie Funktionalität hängt von der Coze-Plattform ab, um sicherzustellen, dass der API-Schlüssel gültig ist.
- Netzanforderung: Für den Einsatz des Servers müssen die entsprechenden Ports (z. B. 2531, 2532, 9919) geöffnet sein.
Anwendungsszenario
- Persönlicher Assistent
Über WeChat können Sie jederzeit Fragen stellen, Informationen einholen oder Aufgaben ausführen, wie z. B. das Wetter abfragen oder Notizen machen. - Gruppenchat-Management
Roboter beantworten automatisch allgemeine Fragen in der Gruppe und entlasten so die Administratoren, was sich für Interessen- oder Arbeitsgruppen eignet. - Lernwerkzeuge
Nach dem Hochladen von Lernmaterial kann der Roboter relevante Fragen beantworten und den Schülern das Lernen erleichtern.
QA
- Muss ich die Sprachausgabe zusätzlich konfigurieren?
Ja, Sie müssen die Ton-ID auf der Coze-Plattform einstellen und die Ton-ID auf demconfig.json
Aktivieren Sie die Sprachoption. - Unterstützt es den Versand von Bildern?
Unterstützung kann der Roboter je nach Coze-Konfiguration Bilder oder Links zurückgeben. - Was ist der Unterschied zwischen der Docker-Bereitstellung und der lokalen Bereitstellung?
Docker eignet sich eher für die Serverbereitstellung mit einem Klick und die einfache Verwaltung; die lokale Bereitstellung ist für die Entwicklung und das Debugging geeignet.