Speichern und Veröffentlichen

Das ist die erste Regel, die man beim Einsatz von LoopAgent verstehen muss, und die am leichtesten zu verwechselnde: «Speichern» aktualisiert nur die Debug-Version; «Veröffentlichen» ist das, was die Online-Version aktualisiert.

Die Kernregel

Ein Klick auf Speichern auf der Einstellungsseite (Modell ändern, die Persona bearbeiten, eine Wissensdatenbank binden, ein Werkzeug hinzufügen …) → schreibt nur in die Debug-Version → der Debug-Chat auf der rechten Seite wird sofort wirksam, sodass Sie es gleich überprüfen können.
Aber jeder externe Kanal (Open API, Sharing-Seite, Widget, Website-Plugin, Telegram, Slack, LiveChat, LiveDesk …) läuft auf dem Konfigurations-Snapshot, der beim letzten «Veröffentlichen» eingefroren wurde.

Ohne einen Klick auf «Veröffentlichen» behält die Produktion immer die alte Konfiguration.

flowchart LR
    S[Speichern klicken] --> DBG[Debug-Version]
    DBG --> DC[Debug-Chat wird sofort wirksam]
    P[Veröffentlichen klicken] --> PROD[Online-Version]
    PROD --> CH[Externe Kanäle werden wirksam]

Häufige Frage: «Ich habe die Konfiguration / Persona geändert, warum hat sich die Produktion nicht geändert?» – Weil Sie nur gespeichert und nicht veröffentlicht haben. Damit eine Änderung in der Produktion wirksam wird, müssen Sie erneut auf Veröffentlichen / Release klicken. Ein funktionierender Debug-Chat ≠ eine funktionierende Produktion.

Wenn ein LoopAgent nie veröffentlicht wurde, geben externe Kanäle einfach einen Fehler aus und laufen überhaupt nicht. Veröffentlichen Sie immer einmal, bevor Sie zum ersten Mal eine API oder einen Kanal anbinden.

Was der Veröffentlichung folgt und was sofort wirksam wird

Nicht alles erfordert «Veröffentlichen», um wirksam zu werden. Beides auseinanderzuhalten, erspart Umwege:

Objekt	Wann es wirksam wird
Persona, Schleifenobergrenzen, Modell sowie die Ein-/Aus-Schalter und Bindungen jeder Fähigkeit	Bei Veröffentlichung (Teil der Agentenkonfiguration, geht in den Veröffentlichungs-Snapshot)
Agent-private Skills	Bei Veröffentlichung (dieselbe Logik wie bei der Persona)
Organisations- / Plattform-Skills	Sofort und global (Speichern wird für jeden Agenten wirksam, der sie referenziert)
Wissensdatenbank-Dokumente, Schlüsselereignis-Daten, Werte von Benutzerattributen	Sofort und global (Laufzeitdaten, keine Konfiguration)

In einem Satz: Konfigurationsänderungen erfordern Veröffentlichen; Daten- / organisationsweite Ressourcenänderungen werden sofort wirksam.

Debug-Chat

Der Debug-Chat rechts auf der Einstellungsseite dient zur Überprüfung der Konfiguration:

Er liest die Konfiguration der Debug-Version, die direkt nach dem Speichern wirksam wird, sodass Sie wiederholt anpassen und die Wirkung sofort sehen können.
Der Debug-Chat ist ein echtes Gespräch und wird genauso abgerechnet.
Im Debug- / Vorschaumodus trägt er kein durchgangsübergreifendes Verlaufsgedächtnis (jede Sitzung startet mit einem sauberen Kontext), was normal ist.

Nacheinander gesendete Nachrichten werden zu einer Antwort zusammengeführt

Wenn Sie weitere Nachrichten senden, während der Agent noch generiert, gehen diese Nachrichten nicht verloren. Das System greift zunächst nach einer Sitzungssperre: Welche Nachricht sie gewinnt, wird sofort verarbeitet; die verlierenden werden in die Warteschlange gestellt oder zur Aufnahme markiert und schließlich zu einer einzigen Antwort zusammengeführt. «Ich habe mehrere hintereinander gesendet, aber nur eine Antwort erhalten» ist also so beabsichtigt und keine verlorene Nachricht.

Nacheinander gesendete Nachrichten werden in zwei Modi verarbeitet: QUEUE und APPEND.

QUEUE (Standard)

Nachrichten in der Warteschlange werden an der Nachrichtengrenze zusammengeführt – sie werden erst dann als neuer Durchgang verarbeitet, wenn die aktuelle Antwort vollständig abgeschlossen ist.

Nachricht ① greift nach der Sitzungssperre und wird sofort verarbeitet, wobei sie für sich Antwort ① erzeugt.
Nachrichten ② und ③ treffen ein, während ① noch verarbeitet wird, greifen die Sperre nicht ab und gelangen in die Warteschlange.
Erst nachdem ① abgeschlossen ist und die Sperre freigibt, führt das System automatisch einen weiteren Durchgang aus und führt ② und ③ auf einmal zu einer einzigen Antwort zusammen.

Nachricht ② erhält keine eigene Antwort – das ist der Punkt, der am leichtesten für eine «verlorene Nachricht» gehalten wird.

QUEUE-Modus: Nachrichten in der Warteschlange werden nach dem Ende dieses Durchgangs zu einer Antwort zusammengeführt

APPEND

Angehängte Nachrichten müssen nicht auf das Ende des Durchgangs warten; sie werden bei der nächsten Anfrage an das Modell in den laufenden Durchgang aufgenommen.

Nachricht ② trifft ein, während ① noch läuft, und wird – statt in die Warteschlange gestellt zu werden oder auf das Ende von ① zu warten – lediglich als «ausstehende Aufnahme» markiert.
Wenn die Engine ihre nächste Schleife erreicht und eine Anfrage an das Modell stellt, nimmt sie den Inhalt von ② mit.

Die Zusammenführung erfolgt an der Schleifengrenze, früher als bei QUEUE: Es wird keine neue Nachricht erstellt und keine zusätzliche Antwort erscheint; der Kunde sieht weiterhin dieselbe Antwort ①, die durch den «angehängten» Inhalt beeinflusst wurde. Das eignet sich für Echtzeit-Ergänzungen und Korrekturen mitten im Lauf.

APPEND-Modus: Eine angehängte Nachricht wird bei der nächsten Schleifenanfrage in den aktuellen Durchgang aufgenommen

Multimodale Nachrichtenfolgen: Tragen die nacheinander zwischen Durchgängen gesendeten Nachrichten multimodale Inhalte wie Bilder, Dateien oder Audio, werden diese Inhalte zusammen mit der Zusammenführung an das Modell übermittelt – vorausgesetzt, das ausgewählte Modell unterstützt die entsprechende multimodale Eingabe und diese Kategorie ist in den Eingabeeinstellungen aktiviert.

Der Textkörper einer einzelnen in die Warteschlange gestellten / angehängten Nachricht ist auf 8192 Zeichen begrenzt.