Zur App

DokumentationWorkflowsAuslöser

Chat Node

Startet den Workflow aus einem anymize-Chat. Die Nachricht des Nutzers landet als Eingabe im Workflow, das Ergebnis geht als Assistent-Antwort zurück. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.

7 Min LesezeitAktualisiert am

Was Chat macht

Startet den Workflow aus einem anymize-Chat. Die Nachricht des Nutzers landet als Eingabe im Workflow, das Ergebnis geht als Assistent-Antwort zurück.

  • Startet einen neuen Workflow-Lauf.
  • Stellt einen Ausgang für weitere Schritte bereit.
  • Wird als normaler Schritt in den Ablauf eingebunden.

Node einrichten

  1. 01Öffne einen Workflow und füge „Chat“ über Bausteine hinzu.
  2. 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
  3. 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
  4. 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.

Aktionen und Betriebsarten

Chat hat eine klar abgegrenzte Aufgabe. Die verfügbaren Einstellungen erscheinen direkt im Node-Panel, sobald du den Node auswählst.

Einstellungen

FeldBedeutungBereich
Anzeigename im ChatWie der Workflow im Chat-Tool-Picker erscheint. Leer = Workflow-Name.Standard
Beschreibung im ChatWird im Chat als Hint angezeigt, damit Nutzer wissen, wann sie diesen Workflow auslösen sollen.Standard
Felder vom Chat-AgentWird im Node-Panel konfiguriert.Standard

Eingaben und Ausgaben

EingabeBedeutungTyp
StandardDieser Auslöser benötigt keinen Eingang.JSON
AusgabeBedeutungTyp
messageDie Nachricht, die der Nutzer im Chat geschickt hat.text
chat_idID der Konversation, für Tracing oder Memory-Lookups.text
user_idanymize-User-ID des Aufrufers.text
attachmentsHochgeladene Dateien (Name, MIME, optional Base64).json
historyLetzte N Nachrichten als Kontext (siehe `history_window`).json

Beispiel und Testlauf

Outlook-Inbox-Zusammenfassung: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.

Beispiel für einen Testlauf

{
  "message": "Was ist heute in meinem Posteingang los?",
  "chat_id": "demo-conv-1",
  "user_id": "dev-42",
  "attachments": [],
  "history": []
}

Zugriff und Sicherheit

Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.

Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.

Häufige Fehler beheben

  • Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
  • Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.
  • Workflow startet nicht: Aktiviere den Workflow und prüfe im Auslöser, ob Test- und Produktionsmodus richtig gewählt sind.

Verwandte Artikel