Version 0.1

💬 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-Codes
  • Search all roles: listet und filtert Rollen
  • Update user program, Update user pseudonym, Update user role: aktualisieren Userdaten
  • Role_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-Informationen
  • Programs: Kurs- und Workshopdaten
  • Roles: Rollendefinitionen für spezialisierte Gesprächsführung
  • Messages: 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).