💬 Kommunikation via WhatsApp
- Webhook-Eingang: Empfängt Nachrichten über WhatsApp.
- Webhook-Antwort: Antworten werden formatiert und über denselben API-Kanal an den Absender zurückgesendet.
- Erstnachricht: Sendet nach Anlage eines neuen Users eine Datenschutzhinweis-Nachricht mit Link.
👤 Nutzerverwaltung & Kontext
- Nutzererkennung: Prüft, ob ein Nutzer (basierend auf der Telefonnummer) bereits existiert.
- Neuanlage: Falls nicht vorhanden, wird der User automatisch mit Zeitstempel und anonymer ID in der Datenbank angelegt.
- Kontextspeicherung: User-bezogene Daten wie Pseudonym, Einschreib-Code, Programm-ID, Rolle der Assistenz (Role ID) werden gespeichert und aktualisiert.
- Session-Kontext: Ein „Memory Buffer“ merkt sich Konversationen kontextabhängig pro User-ID (Langchain Memory).
🧠 KI-Assistenz mit Agenten-Logik
- Zentrale Rolle: Technisch handelt es sich um einen Langchain-Agenten, der den Prompt verarbeitet und Tools ansteuert.
- Initialfragen: Erkennt, ob Einschreib-Code, Programm, Pseudonym oder Rolle fehlen und initiiert passende Dialoge. Personenbezogene Daten werden (neben der Telefonnummer und möglicherweise den Eingaben des Nutzenden) nicht erfasst.
- Dialogführung: Die KI antwortet im WhatsApp-Stil (kurz, einfach, mit Emoji), stellt gezielte Fragen und agiert als Coach oder Lernbegleiter.
- Tool-Nutzung: Nutzt bei Bedarf folgende Werkzeuge:
Search all programs
: findet Programme zu Einschreib-CodesSearch all roles
: listet und filtert RollenUpdate user program
, Update user pseudonym
, Update user role
: aktualisieren UserdatenRole_AI
: delegiert Gesprächsführung an spezialisierte Sub-KI
- KI-Modell: Verwendet GPT-4o von OpenAI über die API. Diese Daten werden nicht zum Training von Modellen verwendet.
🗃 Datenbankanbindung
- Tabellen:
Users
: Teilnehmer-InformationenPrograms
: Kurs- und WorkshopdatenRoles
: Rollendefinitionen für spezialisierte GesprächsführungMessages
: Speichert WhatsApp-Kommunikation (sowohl Eingaben als auch Antworten)
⚙️ Besonderheiten
- Systemprompt-Logik: Komplexer, kontextsensitiver Prompt mit eingebetteten Platzhaltern für Rollen, Programme, Zeitstempel etc.
- Rollen-Logik: Nutzer kann die Rolle der Assistenz wechseln oder initial eine passende erhalten. Normalerweise findet das Gespräch bei einem Workshop oder Seminar zunächst aus der Rolle "Erwartungsabfrage" statt. Ohne Programm-Zugehörigkeit ist die Rolle zunächst "Beruflicher Coach". Bei unpassenden Rollen oder festgefahrenen Gesprächen wird die Rolle automatisch gewechselt.
🧾 Zweck dieser Version
Diese erste Version bietet eine personalisierte, kontextuelle WhatsApp-Assistenz, die Kursteilnehmende oder Coachees in unterschiedlichen Rollen unterstützt. Sie ist modular aufgebaut und bereit für Erweiterungen (z. B. neue Tools, Rollen, externe APIs).