Prompts debuggen

🔄 Recall: Muster als Werkzeugkasten

In Lektion 6 hast du acht bewährte Prompt-Muster kennengelernt. Aber auch der beste Werkzeugkasten hilft nicht, wenn etwas schiefgeht und du nicht weißt, warum. Genau dafür brauchst du Debugging-Skills.

Nach dieser Lektion kannst du:

Prompt-Fehler systematisch diagnostizieren
Die vier wichtigsten Debugging-Techniken anwenden
Die häufigsten Probleme mit gezielten Fixes beheben

Der Debugging-Prozess

Wenn ein Prompt nicht funktioniert, folge diesen vier Schritten:

1. Identifiziere, WAS falsch ist

Werde konkret. „Funktioniert nicht" reicht nicht. Was genau stimmt nicht?

Problem-Typ	Symptom
Falsches Format	Richtiger Inhalt, falsche Struktur
Falscher Inhalt	Falsche Fakten, fehlende Punkte
Falscher Ton	Zu formal, zu locker, zu generisch
Halluzination	Erfundene Fakten, falsche Details
Ignorierte Anweisungen	Macht etwas, das du explizit verboten hast
Inkonsistenz	Jedes Mal anderes Ergebnis
Unvollständig	Stoppt mittendrin oder lässt Teile aus

2. Stelle eine Hypothese auf

Warum könnte das passieren? Häufige Ursachen:

Anweisung war mehrdeutig
Kontext fehlte
Widersprüchliche Anweisungen
Anweisung in der „Mitte" verloren gegangen
Aufgabe zu komplex für einen Prompt

3. Teste deine Hypothese

Ändere eine Sache und prüfe, ob sich das Ergebnis verbessert. Nicht drei Dinge gleichzeitig ändern — dann weißt du nicht, was geholfen hat.

4. Iteriere oder untersuche weiter

Hat der Fix geholfen? Gut — weiter. Hat er nichts gebracht? Nächste Hypothese.

Vier Debugging-Techniken

Technik 1: Die KI fragen

Ja, wirklich — frag die KI, warum sie so geantwortet hat.

„Du hast in deiner Antwort [konkretes Verhalten beschreiben]. Warum hast du das so interpretiert? Was an meinem Prompt hat zu dieser Interpretation geführt?"

Überraschend hilfreich, um mehrdeutige Formulierungen zu finden.

Technik 2: Isolation

Entferne Prompt-Teile systematisch:

Lösche den letzten Abschnitt — gleiches Problem?
Lösche den Kontext-Teil — gleiches Problem?
Lösche die Beispiele — gleiches Problem?

Sobald das Problem verschwindet, hast du den Verursacher gefunden.

✅ Quick Check: Warum solltest du beim Debuggen nur EINE Sache gleichzeitig ändern?
(Antwort: Wenn du mehrere Dinge gleichzeitig änderst, weißt du nicht, welche Änderung das Problem behoben hat — du kannst den Fix nicht reproduzieren.)

Technik 3: Vereinfachung

Wenn der Prompt komplex ist und du den Fehler nicht findest:

Streiche alles auf das Minimum — nur Aufgabe + eine Anweisung
Funktioniert das? Gut.
Füge schrittweise Teile zurück hinzu
Wann bricht es? Das ist dein Problem.

Technik 4: Beispiel-Injektion

Wenn Anweisungen ignoriert werden, zeig stattdessen ein Beispiel:

Vorher (Anweisung ignoriert):

„Halte jede Antwort unter 50 Wörtern."

Nachher (Beispiel zeigt das Muster):

„Antworte wie in diesem Beispiel:
Frage: Was ist Docker? Antwort: Docker packt Apps in isolierte Container. Gleicher Code läuft überall gleich — egal ob auf deinem Laptop oder dem Server. Schluss mit ‚bei mir geht’s aber'.
Halte jede Antwort unter 50 Wörtern."

Häufige Probleme und Fixes

Problem	Symptom	Fix
Falsches Format	Inhalt stimmt, Struktur nicht	Beispiel zeigen, Format ans Ende, Format betonen
Halluzination	Erfindet Fakten	„Nutze nur gelieferte Infos. Sag ‚weiß ich nicht’ bei Unsicherheit."
Ignorierte Anweisungen	Macht was du verboten hast	An Anfang/Ende platzieren, WICHTIG-Prefix, Negativ-Beispiel
Zu generisch	Korrekt aber langweilig	Mehr Kontext, Spezifität erzwingen, Beispiel für gewünschte Tiefe
Inkonsistent	Jedes Mal anders	Few-Shot-Beispiele, spezifischer werden, Format verankern
Bricht ab	Stoppt mitten im Text	In Abschnitte aufteilen, explizit „vollständig" fordern

Das Debug-Protokoll

Führe bei wichtigen Prompts ein Log:

Prompt-Version: 1.3
Datum: 2026-02-26
Problem: KI ignoriert die 200-Wörter-Beschränkung
Hypothese: Beschränkung steht in der Mitte, geht unter
Getestet: Beschränkung ans Ende verschoben + fett markiert
Ergebnis: ✅ Antworten jetzt konsistent unter 200 Wörter

Das klingt aufwendig, spart dir aber Stunden bei komplexen Prompts — weil du nicht dieselben Fehler zweimal machst.

Wann aufgeben?

Wenn du 5+ verschiedene Ansätze ausprobiert hast und der Prompt immer noch nicht funktioniert:

Aufgabe aufteilen — vielleicht ist sie für einen Prompt zu komplex
Anderer Ansatz — manchmal ist der gesamte Prompt-Ansatz falsch
Anderes Modell — manche Aufgaben funktionieren mit einem Modell besser
Manuell ergänzen — KI für 80% nutzen, die letzten 20% selbst machen

Wichtigste Erkenntnisse

Diagnose vor Reparatur — zuerst genau identifizieren, WAS falsch ist
Vier Techniken: KI fragen, Isolation, Vereinfachung, Beispiel-Injektion
Eine Änderung pro Test — sonst weißt du nicht, was geholfen hat
Debug-Protokoll führen bei wichtigen Prompts
Nach 5+ gescheiterten Versuchen: Ansatz überdenken statt weiter schrauben

Nächste Lektion

Lektion 8 ist dein Abschlussprojekt: Du baust einen produktionsreifen Prompt von Grund auf — mit allem, was du in diesem Kurs gelernt hast. Von der Definition des Erfolgs bis zum fertigen, getesteten Prompt.