SUPERVISOR

Der SUPERVISOR-Service ermöglicht die Kommunikation mit dem Supervisor-System. Du kannst Benachrichtigungen auslösen (z. B. wenn ein Nutzer eine bestimmte Aktion durchführt) und Schlüssel-Wert-Informationen für den Supervisor speichern und abrufen.

---

.notify(messageName, historyItemId?)

Löst eine Benachrichtigung an den Supervisor aus. Der Supervisor wird über das angegebene Ereignis informiert und kann daraufhin z. B. einen Mitarbeiter benachrichtigen.

Parameter	Typ	Pflicht	Beschreibung
messageName	string	ja	Bezeichnung der Benachrichtigung (z. B. "Kontaktaufnahme gewünscht").
historyItemId	string	nein	Optionale ID eines Chatverlauf-Elements, auf das sich die Benachrichtigung bezieht.

Rückgabe: Promise<void>

await RAGAI.SUPERVISOR.notify('Kontaktaufnahme gewünscht');

// Mit Bezug auf ein bestimmtes Chatverlauf-Element
await RAGAI.SUPERVISOR.notify('Eskalation erforderlich', conf.triggerHistoryItemId);

---

.setInfo(key, value)

Speichert eine Information für den Supervisor unter einem eindeutigen Schlüssel. Der Supervisor kann diese Informationen einsehen und darauf reagieren.

Parameter	Typ	Beschreibung
key	string	Eindeutiger Schlüssel für die Information.
value	unknown	Der zu speichernde Wert (kann ein beliebiger Typ sein).

Rückgabe: Promise

await RAGAI.SUPERVISOR.setInfo('kundenNummer', '12345');
await RAGAI.SUPERVISOR.setInfo('anliegen', 'Rechnungsreklamation');

---

.getInfo(key)

Ruft eine zuvor gespeicherte Information anhand des Schlüssels ab.

Parameter	Typ	Beschreibung
key	string	Der Schlüssel der abzurufenden Information.

Rückgabe: Promise<unknown | null> – Der gespeicherte Wert oder null, wenn kein Eintrag vorhanden ist.

const kundenNummer = await RAGAI.SUPERVISOR.getInfo('kundenNummer');
if (kundenNummer) {
  console.log('Kundennummer:', kundenNummer);
}