hangoutsbot -Download – hangoutsbot -Quellcode herunterladen

hangoutsbot

AI-Quellcode

Patch release

Herunterladen

Einführung

Hangupsbot ist ein Chatbot, der für die Arbeit mit Google Hangouts entwickelt wurde.

Bitte sehen Sie:

Anleitung zur Installation
Issue-Tracker für Fehler, Probleme und Funktionsanfragen
Wiki für alles andere

Repository-Links

GitHub-Organisation
Übersetzungsprojekt
Referenz-Hangups-Bibliothek

Merkmale

Erwähnungen : Wenn Sie jemand in einem Raum erwähnt, erhalten Sie vom Bot einen privaten Hangout mit Details zur Erwähnung, einschließlich Kontext, Raum und Person, die Sie erwähnt hat.
Syncouts : Bei einem Syncout handelt es sich um zwei Hangout-Gruppenchats, deren Nachrichten aneinander weitergeleitet werden, was eine nahtlose Interaktion zwischen den beiden Räumen ermöglicht. Wird in erster Linie verwendet, um das Chat-Limit von 150 Mitgliedern zu überwinden, kann aber auch dazu verwendet werden, Teams vorübergehend zur Interaktion zusammenzubringen.
Cross-Chat-Syncouts : Die Hälfte Ihres Teams ist auf Slack? Kein Problem! Sie können sie zur Kommunikation im selben Raum verbinden. Unterstützung für andere Chat-Clients folgt in Kürze.
Hubot-Integration : Mit Hangupsbot können Sie eine Verbindung zu Hubot herstellen und erhalten sofort Zugriff auf Hunderte von entwickelten Chat-Tools und Plugins.
Plugins und Senken : Der Bot verfügt über Anweisungen zum Entwickeln eigener Plugins und Senken, sodass der Bot mit externen Diensten wie Ihrer Unternehmenswebsite, Google-Skripten und vielem mehr interagieren kann.
Plugin-Manie : Spiele, Nickname-Unterstützung, abonnierte Schlüsselwörter, anpassbare API – die Liste geht weiter !

Den Bot ausführen

Hinweis: Erster Lauf? Siehe Installationsanleitung

Zum Ausführen: python3 hangupsbot.py

 usage: hangupsbot [-h] [-d] [--log LOG] [--cookies COOKIES] [--memory MEMORY] [--config CONFIG] [--version]

optional arguments:
-h, --help         show this help message and exit
-d, --debug        log detailed debugging messages (default: False)
--log LOG          log file path (default:
                   ~/.local/share/hangupsbot/hangupsbot.log)
--cookies COOKIES  cookie storage path (default:
                   ~/.local/share/hangupsbot/cookies.json)
--memory MEMORY    memory storage path (default:
                   ~/.local/share/hangupsbot/memory.json)
--config CONFIG    config storage path (default:
                   ~/.local/share/hangupsbot/config.json)
--version          show program's version number and exit

Bot-Konfiguration für Administratoren

Konfigurationsanweisungen können in config.json angegeben werden.

Bitte beachten Sie, dass die mit dem Repository gelieferte Datei config.json nicht bearbeitet/geändert werden darf. Es handelt sich um die Referenzdatei, die der Bot verwendet, um die eigentliche Konfigurationsdatei zu erstellen, die sich an anderer Stelle im System befindet. Um herauszufinden, wo sich die eigentliche Datei befindet, lesen Sie bitte den Abschnitt „Zusätzliche Konfiguration“ in der Installationsanleitung.

Die meisten Konfigurationsanweisungen werden global angegeben

Globale Direktiven werden immer im „Stammverzeichnis“ von config.json angegeben.
Um eine Anweisung pro Konversation anzugeben, sollte dieselbe Konfigurationsoption als config.conversations[<conversation-id>].<configuration option> definiert werden.
Anweisungen pro Konversation haben Vorrang vor globalen Einstellungen, wenn beide festgelegt sind.
Manuell konfigurierte Anweisungen pro Konversation sind VERALTET.

Plugins

Mit dem plugins Schlüssel in config.json können Sie optional eine Liste von Plugins angeben, die vom Bot beim Start geladen werden. Wenn diese Option auf null belassen wird, werden alle verfügbaren Plugins geladen.

Um die zu ladenden Plugins anzugeben, stellen Sie zunächst sicher, dass sich die richtigen .py Dateien in Ihrem hangupsbot/plugin/ -Verzeichnis befinden, und ändern Sie dann den plugins Schlüssel in config.json um anzugeben, welche Plugins/Dateien Sie laden möchten, z. B. plugins: ["mentions", "default", "chance", "syncrooms"]

Einige Plugins erfordern möglicherweise eine zusätzliche Konfiguration. config.json ist der Konfigurationsanbieter für den Bot und seine Plugins.

Einige interessante Plugins:

erwähnt Plugin
- Benachrichtigen Sie Benutzer, wenn ihr Name in einem Chat erwähnt wird
Abonnieren-Plugin
- Benachrichtigen Sie Benutzer, wenn Schlüsselwörter, die sie abonniert haben, in einem Chat gesagt werden
Syncout-/Syncrooms-Plugins
- Chat-Nachrichten zwischen verschiedenen Hangout-Gruppengesprächen (Syncrooms) weiterleiten
- über Bot-Befehle konfigurieren (syncrooms_config)
- Automatisierte Übersetzung weitergeleiteter Nachrichten über Google Translate (syncrooms_autotranslate)

Das Wiki hat eine umfassendere Liste von Plugins ...

Interaktion mit dem Bot

Es gibt zwei allgemeine Arten der Interaktion mit dem Bot:

/bot -Befehle beginnen mit /bot z. B. /bot dosomething
- Einige Bot-Befehle sind nur für Administratoren verfügbar
Benutzerdefinierte Interaktionen (Nutzung und Zugänglichkeit variieren je nach Plugin)

Der Basis-Bot unterstützt einige grundlegende Befehle, auch ohne dass Plugins geladen sind. Hier ist eine unvollständige Liste:

/bot help

Bot listet alle unterstützten Befehle in einer privaten Nachricht mit dem Benutzer auf

/bot ping

Bot antwortet mit einem pong .

/bot version

Bot antwortet mit der Versionsnummer des Frameworks

Eine vollständige Liste der vom Basis-Framework unterstützten Befehle finden Sie auf der Wiki-Seite „Core Commands“ .

Das Wiki verfügt außerdem über eine Liste von Plugins, in der die verfügbaren Plugins mit Befehlslisten und deren Verwendung aufgeführt sind.

Aktualisierung

Navigieren Sie zum Bot-Verzeichnis (z. B. cd ~/hangupsbot )
Wechseln Sie mit git checkout master zum neuesten stabilen Zweig
git pull um die neueste Version von Hangupsbot abzurufen
pip3 install -r requirements.txt --upgrade
Starten Sie den Bot neu

Debuggen

Führen Sie den Bot mit dem Parameter -d aus, z. B. python3 hangupsbot.py -d – dadurch wird die Protokollebene auf INFO gesenkt, um eine ausführlichere und informativere Protokolldatei zu erhalten.
tail die Protokolldatei, die sich wahrscheinlich unter /<user>/.local/share/hangupsbot/hangupsbot.log befindet – der Speicherort variiert je nach Distribution!
Die Konsolenausgabe (STDOUT) ist unabhängig von der Protokollebene ziemlich begrenzt. Verlassen Sie sich daher stattdessen auf die Ausgabe der Protokolldatei.

Tipps zur Fehlerbehebung

Programm läuft nicht:

hangupsbot und hangups aktualisieren
Führen Sie hangups aus, um zu überprüfen, ob die ursprüngliche Hangups-Bibliothek funktioniert
- Wenn Fehler auftreten, löschen Sie das Cookie unter „~/.local/share/hangupsbot/cookies.json“ und versuchen Sie es erneut
- Melden Sie sich über die Serveradresse bei Ihrem Google-Konto an.

Bot antwortet nicht auf Nachrichten: