Troubleshooting

Systematisch Fehler finden und beheben: Erkenne das Symptom, identifiziere die Ursache, wähle den passenden Fix. Nutze die Checklisten und Copy-&-Paste-Blöcke unten.

1) Output ignoriert Formatvorgaben (z. B. fließt statt JSON/Tabelle)

• Ursache: Format nicht strikt genug formuliert; kein Beispiel; Mischaufgabe.

• Fix:

Output-Format: Gib ausschließlich JSON nach folgendem Schema zurück. Keine Erklärungen/Kommentare.
Schema: { … }

Oder:

Output-Format: Markdown-Tabelle mit Spalten: {…}. Keine Texte außerhalb der Tabelle.

Beispiel-Output anfügen; Aufgaben entkoppeln (erst Extraktion, dann E-Mail).

2) Halluzinationen/Unbelegte Aussagen

• Ursache: Keine Quellenbindung; vage Frage; Druck, „immer etwas“ zu liefern.

• Fix:

Constraints: Beantworte ausschließlich auf Basis der bereitgestellten Auszüge.
Wenn etwas fehlt/unklar ist, schreibe: "Nicht in den Quellen".
Output-Format: Antwort + Quellenliste (Titel, Abschnitt/ID, Datum)

Frage präzisieren, RAG-Auszüge beilegen.

3) Zu lange, diffuse Antworten

• Ursache: Kein Wortlimit; Ziel unklar.

• Fix:

Constraints: max. {120–180} Wörter; kurze Sätze; keine Einleitung.
Ziel: {ein Satz, messbar}

4) Falsche oder inkonsistente Einheiten/Rundung

• Ursache: Keine Einheiten-/Rundungsregeln.

• Fix:

Constraints: Werte in mm (nicht cm); am Ende auf 2 Dezimalstellen runden.
Qualitätskriterien: Einheit im Output bestätigen.

5) Vermischte Schritte und Antwort

• Ursache: Kein strukturiertes Reasoning.

• Fix:

Output-Format: Zuerst "Schritte" (nummeriert), dann separat "Antwort" (max. 2 Sätze).
Qualitätskriterien: Annahmen vor den Schritten explizit nennen.

6) Nicht vergleichbare Anbieter/Optionen

• Ursache: KO-Kriterien fehlen; Spalten uneinheitlich.

• Fix:

K.O.-Kriterien (müssen erfüllt sein): {Liste}
Output-Format: Tabelle mit fixen Spalten; fehlende Werte = "n/a".

Einheitenstandard festlegen (mm, °C), ggf. Normverweise ergänzen.

7) Leere Felder/fehlende Daten

• Ursache: Unsaubere Extraktion; keine „n/a“-Regel.

• Fix:

Constraints: Kein leeres Feld; verwende "n/a", wenn Information nicht vorhanden.

8) Falsche Treffer im RAG (irrelevante Passagen)

• Ursache: Query zu allgemein; falsche Synonyme; alte Versionen.

• Fix:

• Query schärfen: Objekt + Eigenschaft + Norm/ID + Abschnitt.

• Synonyme DE/EN einbauen; Ausschlüsse („-Marketing“, „-Prospekt“).

• Datum/Version fordern; neuere Quellen bevorzugen.

Retriever-Prompt:

Ziel: Finde Passagen mit Zahlen/Definitionen/Normverweisen.
Constraints: 5–10 Passagen, ≤100 Wörter, inkl. Titel, Abschnitt/ID, Datum.

9) Modell schweift ab/erfindet Struktur

• Ursache: Zu viel Kontext, kein „Nicht relevant“-Hinweis.

• Fix:

Kontext: {relevante Infos}
Nicht relevant: {Themen, die explizit ignoriert werden sollen}

10) Fehlende Nachfrage bei Lücken

• Ursache: Prompt erzwingt keine Rückfragen.

• Fix:

Constraints: Wenn Informationen fehlen, stelle maximal 3 gezielte Rückfragen, bevor du antwortest.

Schneller Diagnose-Flow (90 Sekunden):

1) Ein Satz Ziel + Output-Format vorhanden? Wenn nein → ergänzen.
2) Quellenpflicht nötig? Wenn ja → RAG-Template anziehen.
3) Format strikt genug? Beispiel/Schema/Tabelle hinzufügen.
4) Einheiten/Rundung gesetzt? Wenn nein → definieren.
5) Query/Context sauber? Irrelevantes ausschließen, Synonyme/IDs ergänzen.

Copy-&-Paste „Rettungsblock“ (anhängen, wenn es schief läuft):

Ziel: {ein Satz, messbar}
Output-Format: {Nur JSON nach Schema | Markdown-Tabelle (Spalten: …) | Schritte → Antwort}
Constraints: max. {Wörter}; keine Spekulation; Werte in {Einheit}; am Ende auf {2} Dezimalstellen runden.
Bei Fakten: Nur aus den bereitgestellten Auszügen; falls nicht vorhanden: "Nicht in den Quellen".
Qualitätskriterien: Quellenblock (Titel, Abschnitt/ID, Datum) | Vollständige Tabelle ohne leere Felder ("n/a") | JSON gegen Schema gültig.

Kurz-Check vor dem Absenden:

• Ziel, Format, Constraints klar?

• Quellenpflicht beachtet?

• Einheiten/Rundung definiert?

• Ergebnis prüfbar und direkt nutzbar?