> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows

> Starte automatisierte Workflows direkt aus dem Chat — erwähne sie mit @ oder nutze sie über Agenten.

## Was sind Workflows im Chat?

Workflows sind mehrstufige Automatisierungen, die im [Workflow Builder](/de/using-langdock/workflows/workflow-builder) erstellt werden. Normalerweise startest du sie von der Workflows-Seite, aber du kannst sie auch direkt aus einer Chat-Konversation heraus auslösen — entweder durch Erwähnung eines Workflows mit `@` oder im Chat mit einem Agenten, dem Workflows als Aktionen zugewiesen sind.

Wenn ein Workflow aus dem Chat läuft, siehst du den Echtzeit-Fortschritt und das finale Ergebnis direkt in der Konversation. Kein Wechsel zur Workflow-Lauf-Historie nötig.

**Zwei Wege, Workflows aus dem Chat zu starten:**

| Methode                 | Wie es funktioniert                                                                                                   |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Erwähnung im Chat**   | Tippe `@` in die Nachricht, wähle einen Workflow und sende deine Nachricht                                            |
| **Agent mit Workflows** | Chatte mit einem Agenten, dem Workflows als Aktionen zugewiesen sind — die KI entscheidet, wann sie aufgerufen werden |

## Einen Workflow aus dem Chat starten

Tippe `@` in das Chat-Eingabefeld, um das Erwähnungsmenü zu öffnen. Du siehst einen **Workflows**-Bereich mit allen Workflows, auf die du Zugriff hast. Wähle einen aus, um ihn in deiner Nachricht zu taggen.

Wenn du die Nachricht sendest, liest die KI deine Anfrage und entscheidet, ob der getaggte Workflow ausgelöst werden soll. Falls ja, siehst du ein Bestätigungs-Panel, bevor der Workflow tatsächlich läuft.

<Info>
  Workflows, die per `@` getaggt werden, bleiben mit der Konversation verknüpft.
  Wenn du einen Workflow in einer Nachricht taggst, kann die KI ihn auch in
  Folgenachrichten innerhalb derselben Konversation nutzen — du musst ihn nicht
  jedes Mal neu taggen.
</Info>

Nur Workflows, die **alle** diese Bedingungen erfüllen, erscheinen im Erwähnungsmenü:

* Der Workflow gehört zu deinem Workspace
* Du hast Zugriff darauf (öffentlich, workspace-weit oder mit dir geteilt)
* Der Workflow ist **aktiv** (veröffentlicht)
* Der Workflow verwendet einen unterstützten Trigger-Typ (siehe unten)

### Unterstützte Trigger-Typen

Nicht jeder Workflow kann aus dem Chat gestartet werden. Nur diese Trigger-Typen werden unterstützt:

| Trigger-Typ     | Im Chat verfügbar? | Hinweise                                               |
| --------------- | ------------------ | ------------------------------------------------------ |
| **Manual**      | Ja                 | Einfaches Bestätigen-und-Starten — keine Eingabefelder |
| **Formular**    | Ja                 | Zeigt die Formularfelder inline im Chat zum Ausfüllen  |
| **Geplant**     | Ja                 | Kann auch on-demand aus dem Chat gestartet werden      |
| **Webhook**     | Nein               | Muss durch einen externen HTTP-Aufruf ausgelöst werden |
| **Integration** | Nein               | Muss durch ein Integrations-Event ausgelöst werden     |

## Workflows über Agenten nutzen

Agenten können Workflows als **Aktionen** im Agent Builder hinzugefügt bekommen. Wenn du mit dem Agenten chattest, entscheidet die KI automatisch, wann ein Workflow aufgerufen wird — genau wie bei jedem anderen Tool.

### Einen Workflow zu einem Agenten hinzufügen

1. Öffne den Agenten im **Agent Builder**
2. Gehe zum **Aktionen**-Bereich
3. Klicke auf **Aktion hinzufügen** und wechsle zum **Workflows**-Tab
4. Wähle den Workflow aus, den du anhängen möchtest

Um einen Workflow zu entfernen, klicke auf das **X** auf seiner Karte im Bereich **Aktionen**.

<Tip>
  Der Workflows-Tab im Agent Builder zeigt sowohl aktive als auch inaktive
  Workflows. So kannst du einen Workflow, der noch in Entwicklung ist,
  vorab anhängen und später aktivieren, ohne den Agenten erneut bearbeiten
  zu müssen.
</Tip>

Du kannst Workflows auch im Agent Builder Chat anhängen oder entfernen. Frage zum Beispiel *„Hänge den Workflow Bericht zusammenfassen an diesen Agenten an"* oder *„Entferne den Onboarding-Workflow"*. Der Builder durchsucht Workflows, auf die du Zugriff hast, hängt passende an und zeigt die Änderung direkt im Chat an. In der Suche erscheinen nur aktive Workflows.

### Wie die KI entscheidet, einen Workflow aufzurufen

Jeder angehängte Workflow wird zu einem Tool, das die KI aufrufen kann. Der Tool-Name wird aus dem Workflow-Namen abgeleitet (z.B. wird ein Workflow namens "Bericht zusammenfassen" zum Tool `workflow_bericht_zusammenfassen`). Die KI liest die Beschreibung und Trigger-Felder des Workflows, um zu entscheiden, wann das Tool für deine Anfrage relevant ist.

Bei **Formular-Trigger**-Workflows sieht die KI die Formularfeld-Definitionen (Namen, Typen, Beschreibungen) als Input-Schema des Tools. Sie kann Formularfelder aus deinem Nachrichtenkontext befüllen — wenn du z.B. sagst "fasse dieses Dokument zusammen" und es ein FILE-Feld gibt, referenziert die KI die Anhänge der Konversation.

Bei **Manual- und Geplanten** Workflows ist der Tool-Input eine einfache Bestätigung — die KI schlägt vor, den Workflow auszulösen, und du bestätigst oder lehnst ab.

## Bestätigungsablauf

Jeder Workflow, der aus dem Chat gestartet wird, erfordert deine explizite Bestätigung, bevor er ausgeführt wird. Workflows können externe Aktionen ausführen (E-Mails senden, Datensätze erstellen, APIs aufrufen), und du solltest immer die Möglichkeit haben, vor der Ausführung zu prüfen.

### Manual und geplante Workflows

Du siehst ein kompaktes Panel mit dem Workflow-Namen und zwei Buttons:

* **Auslösen** — bestätigt und startet den Workflow-Lauf
* **Ablehnen** — bricht den Workflow-Aufruf ab; die KI wird informiert und kann Alternativen vorschlagen

### Formular-Workflows

Die Formularfelder werden inline im Chat gerendert. Wenn du Dateianhänge in der Konversation hast, werden FILE-Felder automatisch vorausgefüllt:

* **Einzeldatei-Felder** erhalten die zuletzt hochgeladene Datei
* **Mehrdatei-Felder** erhalten bis zu 10 der neuesten Dateien aus der Konversation

Du kannst die vorausgefüllten Werte vor dem Absenden prüfen, ändern oder löschen. Klicke **Auslösen**, um den Workflow mit den Formulardaten zu starten, oder **Ablehnen**, um abzubrechen.

<Warning>
  Vorausgefüllte Dateien sind Vorschläge basierend auf dem, was in der
  Konversation vorhanden ist. Überprüfe immer, ob die richtigen Dateien
  angehängt sind, bevor du auslöst — besonders in Konversationen mit vielen
  hochgeladenen Dokumenten.
</Warning>

## Live-Fortschritt und Ergebnisse

Nach der Bestätigung zeigt der Chat Echtzeit-Status-Updates:

| Status             | Was du siehst                                                                |
| ------------------ | ---------------------------------------------------------------------------- |
| **Läuft**          | Animierter "Läuft \[Workflow-Name]..."-Indikator                             |
| **Abgeschlossen**  | "Lief \[Workflow-Name] in X Sekunden" mit dem Output darunter                |
| **Fehlgeschlagen** | Rotes Fehler-Panel mit der Fehlermeldung und dem fehlgeschlagenen Node-Namen |
| **Abgelehnt**      | Gelber "Workflow abgelehnt"-Hinweis                                          |

Wenn ein Workflow über den Chat gestartet wird, wird der aktuelle Workflow-Status angezeigt, solange der Workflow läuft.

Sobald der Workflow einen Output über eine [Output-Node](/de/using-langdock/workflows/nodes/output-node) generiert hat, wird der Output-Wert direkt in der Chat-Nachricht als formatiertes Ergebnis-Panel angezeigt. Wenn kein Output-Node vorhanden ist, siehst du eine generische "Abgeschlossen"-Meldung ohne detaillierten Output.

## Zugriffskontrolle

Die Workflow-Zugriffskontrolle im Chat folgt dem gleichen Berechtigungsmodell wie überall in Langdock, mit einer wichtigen Nuance für an Agenten angehängte Workflows.

Wenn du einen Workflow per `@` erwähnst, erscheint er nur in deinem Erwähnungsmenü, wenn du Zugriff darauf hast. Wenn du ihn nicht sehen kannst, kannst du ihn nicht auslösen.

Wenn ein Workflow an einen **Agenten** angehängt ist, findet die Zugriffsprüfung **zur Laufzeit** statt, nicht wenn du den Agenten öffnest. Das bedeutet:

* Du kannst mit einem Agenten chatten, der einen Workflow hat, auf den du keinen Zugriff hast
* Die KI weiß, dass der Workflow existiert und könnte versuchen, ihn aufzurufen
* Wenn sie es tut, erhältst du sofort einen "Zugriff verweigert"-Fehler, der erklärt, dass du keine Berechtigung hast
* Die KI informiert dich dann und kann Alternativen vorschlagen

<Warning>
  Wenn du "Du hast keinen Zugriff auf den \[Workflow-Name] Workflow" in einem
  Chat mit einem Agenten siehst, kontaktiere deinen Workspace-Admin, um Zugriff
  auf den zugrunde liegenden Workflow anzufordern. Zugriff auf den Agenten
  gewährt nicht automatisch Zugriff auf seine angehängten Workflows.
</Warning>

| Workflow-Zugriffsebene        | Aus Chat auslösbar?            |
| ----------------------------- | ------------------------------ |
| **Public**                    | Ja — alle Workspace-Mitglieder |
| **Workspace**                 | Ja — alle Workspace-Mitglieder |
| **Private (mit dir geteilt)** | Ja                             |
| **Private (nicht geteilt)**   | Nein — Zugriff verweigert      |

## Einschränkungen

| Einschränkung                      | Details                                                                                                                                                                                        |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mobile**                         | Workflows können nicht erwähnt oder aus der mobilen App ausgelöst werden. Das mobile Erwähnungsmenü enthält keine Workflows.                                                                   |
| **Agent-to-Agent (A2A)**           | Wenn ein Agent einen anderen Agenten per A2A aufruft, kann der Sub-Agent keine Workflows auslösen. Workflow-Tools sind im A2A-Ausführungspfad deaktiviert, um rekursive Trigger zu verhindern. |
| **Datei-Vorabfüllung**             | Bis zu 10 Konversations-Anhänge werden zum Vorausfüllen von FILE-Feldern verwendet. Ältere Dateien über dieses Limit hinaus werden nicht einbezogen.                                           |
| **Tool-Name-Länge**                | Workflow-Tool-Namen sind auf 63 Zeichen begrenzt (eine Provider-Beschränkung). Sehr lange Workflow-Namen bekommen ihren Tool-Namen abgeschnitten.                                              |
| **Ein Aufruf pro Antwort**         | Die KI ruft ein Workflow-Tool nur einmal pro Antwort auf. Sie löst nicht denselben Workflow mehrmals in einer einzelnen Antwort aus.                                                           |
| **Bestätigung immer erforderlich** | Jeder Workflow-Trigger aus dem Chat erfordert explizite User-Bestätigung. Es gibt keinen Auto-Ausführen-Modus für chat-getriggerte Workflows.                                                  |
| **Nicht unterstützte Trigger**     | Workflows mit Webhook- oder Integration-Triggern können nicht aus dem Chat gestartet werden. Diese Trigger-Typen sind für externe Event-Quellen konzipiert.                                    |

## Häufig gestellte Fragen

<AccordionGroup>
  <Accordion title="Kann ich einen Workflow ohne Agent starten — einfach im normalen Chat?">
    Ja. Tippe `@` in einem beliebigen Chat, wähle einen Workflow aus dem
    Erwähnungsmenü und sende deine Nachricht. Kein Agent nötig. Die KI
    entscheidet basierend auf deiner Anfrage, ob der Workflow ausgelöst wird.
  </Accordion>

  <Accordion title="Was passiert, wenn der Workflow lange braucht?">
    Der Chat prüft weiter, bis der Workflow einen Endstatus erreicht. Du siehst
    einen "Läuft..."-Indikator, solange er in Bearbeitung ist. Es gibt kein
    Timeout — auch Workflows, die Minuten dauern, zeigen irgendwann ihr
    Ergebnis.
  </Accordion>

  <Accordion title="Kann ich einen Workflow nach dem Auslösen abbrechen?">
    Nicht direkt aus der Chat-UI. Wenn du einen laufenden Workflow abbrechen
    musst, gehe zur Lauf-Historie des Workflows im Workflows-Bereich.
  </Accordion>

  <Accordion title="Warum erscheint mein Workflow nicht im Erwähnungsmenü?">
    Prüfe, ob der Workflow **aktiv** (veröffentlicht) ist, einen unterstützten
    Trigger-Typ verwendet (Manual, Formular oder Geplant) und ob du Zugriff
    darauf hast. Webhook- und Integration-getriggerte Workflows erscheinen nie
    im Menü.
  </Accordion>

  <Accordion title="Kann ein Agent mehrere verschiedene Workflows in einer Konversation auslösen?">
    Ja. Wenn ein Agent mehrere Workflows angehängt hat, kann die KI verschiedene
    Workflows in verschiedenen Nachrichten aufrufen. Sie ruft jedoch nur einen
    Workflow pro Antwort auf — sie löst nicht zwei Workflows in derselben
    Antwort aus.
  </Accordion>

  <Accordion title="Werden Datei-Uploads im Chat automatisch von Workflow-Formularfeldern verwendet?">
    Ja, für FILE-Formularfelder. Wenn ein Workflow FILE-Felder hat und die
    Konversation Anhänge enthält, werden diese Felder mit den neuesten Dateien
    vorausgefüllt. Mehrdatei-Felder erhalten bis zu 10 Dateien; Einzeldatei-Felder
    die neueste. Du kannst diese vor der Bestätigung immer ändern oder löschen.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wann sollte ich einen Workflow statt eines Agenten verwenden?">
    Nutze einen Workflow, wenn die Aufgabe wiederholbare Schritte, strukturierte Eingaben, Verzweigungslogik, Freigaben oder Integrationen umfasst, die in einer festen Reihenfolge laufen sollen. Nutze einen Agenten, wenn die Aufgabe eher im Dialog stattfindet oder flexibles Denken erfordert.
  </Accordion>

  <Accordion title="Wie nutzen Workflows Agenten, Aktionen und Dateien?">
    Workflows können Agenten aufrufen, Aktionen ausführen, Dateien verarbeiten und Outputs zwischen Nodes weitergeben. Jeder Schritt sollte klare Inputs und Outputs haben, damit spätere Nodes das Ergebnis zuverlässig nutzen können.
  </Accordion>
</AccordionGroup>
