.MSG

Der MSG-Manager steuert den Nachrichtenaustausch zwischen Nutzer und Bot. Du kannst damit Nachrichten senden, den Chatverlauf ergänzen und den Systemprompt zur Laufzeit ändern.

Events

onBotToUser

Wird ausgelöst, wenn der Bot eine Nachricht an den Nutzer sendet.

RAGAI.MSG.onBotToUser.subscribe((text) => {
  console.log('Bot sagt:', text);
});

onUserToBot

Wird ausgelöst, wenn der Nutzer eine Nachricht an den Bot sendet.

RAGAI.MSG.onUserToBot.subscribe((text) => {
  console.log('Nutzer sagt:', text);
});

---

.prompt(text)

Sendet einen Text als Nutzereingabe an den Bot und löst einen vollständigen Bot-Durchlauf aus. Der Text wird im Chatverlauf angezeigt und der Bot antwortet darauf.

Parameter	Typ	Beschreibung
text	string	Der Text, der an den Bot gesendet wird

RAGAI.MSG.prompt('Erkläre mir das Thema Machine Learning');

.overwriteSystemPrompt(prompt)

Überschreibt den Systemprompt des Bots für die aktuelle Sitzung. Damit kannst du das Verhalten des Bots zur Laufzeit verändern, ohne die Bot-Konfiguration anzupassen.

Parameter	Typ	Beschreibung
prompt	string	Der neue Systemprompt für die aktuelle Sitzung

Rückgabewert: Promise<void>

await RAGAI.MSG.overwriteSystemPrompt('Du bist ein freundlicher Assistent, der nur auf Deutsch antwortet.');

.overwriteWebsearchEnabled(enabled)

Aktiviert oder deaktiviert die Websuche für den Bot zur Laufzeit.

Parameter	Typ	Beschreibung
enabled	boolean	true aktiviert die Websuche, false deaktiviert sie

Rückgabewert: Promise<void>

// Websuche aktivieren
await RAGAI.MSG.overwriteWebsearchEnabled(true);

// Websuche deaktivieren
await RAGAI.MSG.overwriteWebsearchEnabled(false);

.userMessage(text)

Fügt eine sichtbare Nachricht aus Nutzersicht zum Chatverlauf hinzu, ohne eine Bot-Antwort auszulösen. Nützlich, um den Chatverlauf manuell zu ergänzen.

Parameter	Typ	Beschreibung
text	string	Der Text der Nutzernachricht

RAGAI.MSG.userMessage('Ich möchte mehr über das Thema erfahren');

.botMessage(text)

Fügt eine sichtbare Nachricht aus Botsicht zum Chatverlauf hinzu, ohne eine weitere Verarbeitung auszulösen. Damit kannst du Bot-Antworten programmatisch einfügen.

Parameter	Typ	Beschreibung
text	string	Der Text der Bot-Nachricht

Rückgabewert: Promise<HistoryItemResponse>

await RAGAI.MSG.botMessage('Hier sind weitere Informationen zum Thema: ...');

.botBypass(text)

Fügt eine unsichtbare Bot-Nachricht zum Thread hinzu. Die Nachricht wird nicht im Chatverlauf angezeigt, ist aber im Kontext des Threads vorhanden. Nützlich, um dem Bot zusätzlichen Kontext mitzugeben, ohne den Chat für den Nutzer zu verändern.

Parameter	Typ	Beschreibung
text	string	Der Text der unsichtbaren Bot-Nachricht

Rückgabewert: Promise<HistoryItemResponse[]>

await RAGAI.MSG.botBypass('Interner Kontext: Der Nutzer befindet sich auf der Produktseite.');

.userBypass(text)

Fügt eine unsichtbare Nutzernachricht zum Thread hinzu. Die Nachricht wird nicht im Chatverlauf angezeigt und löst keine Bot-Antwort aus. Der Bot kann diese Nachricht aber im weiteren Gesprächsverlauf als Kontext nutzen.

Parameter	Typ	Beschreibung
text	string	Der Text der unsichtbaren Nutzernachricht

Rückgabewert: Promise<HistoryItemResponse>

await RAGAI.MSG.userBypass('Nutzer interessiert sich für: Künstliche Intelligenz');

._addMessagesToThread(messages)

Fügt mehrere Nachrichten gleichzeitig zum Thread hinzu. Jede Nachricht wird als DialogMessage-Objekt übergeben.

Parameter	Typ	Beschreibung
messages	DialogMessage[]	Array von Nachrichtenobjekten mit role und content

Rückgabewert: Promise<HistoryItemResponse[]>

await RAGAI.MSG._addMessagesToThread([
  { role: 'user', content: 'Was ist Machine Learning?' },
  { role: 'assistant', content: 'Machine Learning ist ein Teilbereich der KI ...' }
]);

tip

Verwende _addMessagesToThread nur, wenn du mehrere Nachrichten auf einmal hinzufügen möchtest. Für einzelne Nachrichten nutze .botBypass() oder .userBypass().