Einheit 1 — Was einen guten Workflow ausmacht
Was du nach dieser Einheit weißt: Du kennst die fünf Qualitätskriterien für produktionsreife Workflows und verstehst warum ein funktionierender Workflow noch kein guter Workflow ist.
Das Problem mit „funktioniert doch"
Du hast einen Workflow gebaut. Er tut was er soll. Der Test lief durch. Fertig?
Nein. Denn „funktioniert" ist nur das Minimum. Ein Workflow der in Produktion läuft, muss mehr leisten:
- Was passiert, wenn du in zwei Monaten etwas ändern musst — und nicht mehr weißt wie der Workflow aufgebaut ist?
- Was passiert, wenn ein Kollege den Workflow übernehmen soll — und die Agent-Namen „Agent 3", „Agent 3 (Kopie)" und „Agent 7" heißen?
- Was passiert, wenn du den Workflow exportierst und einem externen Berater schickst — und darin stehen API-Keys und Passwörter im Klartext?
- Was passiert, wenn die API des Zielsystems einen Timeout hat — und der Workflow stillschweigend aufhört zu arbeiten, ohne dass es jemand merkt?
Das alles sind keine hypothetischen Szenarien. Das passiert in der Praxis regelmäßig — und es passiert genau dann, wenn man unter Zeitdruck gebaut und die Qualität übersprungen hat.
📹 Video: [Platzhalter — Screencast: Beispiel eines „funktionierenden" Workflows mit typischen Qualitätsproblemen — unbenannte Agents, Inline-Credentials, keine Fehlerbehandlung]
Die fünf Qualitätskriterien
Ein produktionsreifer Workflow erfüllt fünf Kriterien:
1. Wartbar
Jemand anderes — oder du selbst in drei Monaten — kann den Workflow öffnen, verstehen und ändern, ohne den ursprünglichen Erbauer fragen zu müssen.
Was das konkret bedeutet:
- Agents haben sprechende Namen
- Der Workflow ist in logische Abschnitte unterteilt
- Komplexe Logik ist dokumentiert
- Es gibt keine „magischen" Werte die nur der Erbauer versteht
📸 Screenshot: [Platzhalter — Gegenüberstellung: Workflow mit generischen Agent-Namen vs. Workflow mit sprechenden Namen]
2. Sicher
Der Workflow enthält keine Zugangsdaten im Klartext und verarbeitet sensible Daten so, dass sie nicht unbeabsichtigt nach außen gelangen.
Was das konkret bedeutet:
- Alle Credentials stehen in der zentralen Credentials-Verwaltung
- Keine Passwörter, API-Keys oder Tokens direkt in Agent-Konfigurationen
- Der Workflow kann exportiert werden ohne Sicherheitsrisiko
- Sensible Daten werden nicht unnötig in Logs oder Zwischenergebnissen gespeichert
3. Testbar
Einzelne Teile des Workflows können unabhängig getestet werden, ohne den gesamten Prozess durchlaufen zu müssen.
Was das konkret bedeutet:
- Der Workflow ist in Abschnitte unterteilt die jeweils einzeln ausführbar sind
- Es gibt Testdaten mit denen Abschnitte isoliert gestartet werden können
- Testfälle sind aufbewahrt und wiederverwendbar
4. Austauschbar
Der Workflow kann exportiert, in einer anderen Umgebung importiert und dort mit minimalen Anpassungen (neue Credentials, andere URLs) betrieben werden.
Was das konkret bedeutet:
- Umgebungsspezifische Werte (URLs, IP-Adressen, Pfade) sind nicht fest verdrahtet sondern über Credentials oder Variablen gesteuert
- Der Workflow hat keine versteckten Abhängigkeiten die nur in der Originalumgebung funktionieren
5. Nachvollziehbar
Wenn der Workflow ein Ergebnis liefert — oder ein Fehler auftritt — kann nachvollzogen werden was passiert ist und warum.
Was das konkret bedeutet:
- Wichtige Zwischenergebnisse sind sichtbar (nicht nur das Endergebnis)
- Fehlerfälle erzeugen verständliche Meldungen
- Der Run Inspector zeigt pro Agent was rein- und rausgegangen ist
📸 Screenshot: [Platzhalter — Run Inspector: Beispiel einer nachvollziehbaren Workflow-Ausführung mit sichtbaren Zwischenergebnissen]
Die Kosten von Qualität — und die Kosten ohne
Qualität kostet Zeit. Ein Workflow mit sauberen Namen, zentralen Credentials, Abschnitten und Tests dauert länger als einer der „einfach funktioniert".
Aber: Die Zeit die du beim Bauen sparst, zahlst du beim Warten doppelt zurück. Ein unsauber gebauter Workflow ist:
- Langsamer zu debuggen — weil du erst verstehen musst was die Agents tun
- Riskanter zu ändern — weil du nicht weißt was du kaputt machst
- Nicht übergebbar — weil niemand außer dir ihn versteht
- Ein Sicherheitsrisiko — weil Credentials im Export landen
Die Einheiten in diesem Kurs zeigen dir Schritt für Schritt, wie du jedes dieser Kriterien erfüllst — ohne dass es Stunden kostet.
Zusammengefasst
| Kriterium | Kernfrage |
|---|---|
| Wartbar | Kann jemand anderes den Workflow verstehen und ändern? |
| Sicher | Sind alle Zugangsdaten geschützt? |
| Testbar | Können Teile unabhängig getestet werden? |
| Austauschbar | Läuft der Workflow auch in einer anderen Umgebung? |
| Nachvollziehbar | Kann man im Fehlerfall verstehen was passiert ist? |
Jedes der folgenden Kapitel adressiert eines oder mehrere dieser Kriterien.