# 16 stille Fehler in KI-Agenten — die Checkliste

> Kostenlose Ressource von **DripBack** · Multi-Model AI: qwen + Claude + GPT-4 · Fragen? **info@dripback.de**

Die gefährlichsten Bugs sind nicht die, die krachen — sondern die, die **grün durchlaufen
und trotzdem lügen**. Tests bestehen, Exit-Code 0, und im Hintergrund ist etwas still
kaputt. Diese 16 Muster prüfen wir vor jedem „fertig". Geh sie gegen deinen Code durch.

1. **Verschluckter Fehler** — `except: pass` / leeres `catch` ohne Log. Der Fehler verschwindet spurlos.
2. **Gefährlicher Fallback** — `?? default` maskiert einen echten Ausfall als gültigen Wert.
3. **Vergessenes await** — Async-Aufruf ohne `await`; Ergebnis und Fehler gehen verloren.
4. **Schein-Abbruch** — Timeout/Race statt echtem Cancel; die Aufgabe läuft im Hintergrund weiter.
5. **Stiller Skip ohne Zähler** — übersprungene Items werden nicht gezählt → „0 verarbeitet" sieht aus wie „alles ok".
6. **Falsche Block-Meldung** — das Log sagt „blockiert/fehlgeschlagen", aber die Aktion lief trotzdem durch.
7. **Halbe Rückgabe** — Funktion gibt `null`/Teildaten zurück, die der Aufrufer als vollständig missversteht.
8. **Geeignet ≠ erledigt** — „X Kandidaten" wird als „X bearbeitet" gemeldet.
9. **Exakt-Vergleich bei Präfix-Werten** — `==` auf Werte mit Präfix/Schreibvariante → Treffer wird verfehlt (z. B. „medizin " vs „Medizin").
10. **Vorhanden ≠ bereit** — „registriert/konfiguriert" wird als „läuft/geladen" behandelt.
11. **Platzhalter hinter grünem Exit** — Job endet mit 0, liefert aber leeren oder Dummy-Output.
12. **Fehlende I/O-Prüfung** — Netz-/Datei-/DB-Aufruf ohne Status-Check; Teil-/Leer-Reads gelten als Erfolg.
13. **Spekulativer Write** — eine Aussage über eine Ressource schreiben, deren Existenz nie verifiziert wurde.
14. **Verdeckender Platzhalter** — „?" oder „—" in der Oberfläche versteckt einen Lese-Fehler statt ihn zu melden.
15. **Nicht-atomare Writes** — sequentielle Datei-Operationen auf synchronisierten/parallelen Systemen → Teilzustände, Races.
16. **Alter Stand ohne Datum** — eine datierte Datei wird gelesen, ohne ihr Alter zu zeigen → veraltete Daten wirken frisch.

## So nutzt du die Liste
Vor jedem „done"-Claim und in jedem Code-Review: diese 16 gegen die Änderung halten.
Schon 2–3 Treffer pro Sprint sparen dir einen stillen Produktions-Ausfall.

---
*Gebaut von **DripBack** — wir bauen KI-Komplettlösungen für den deutschen Mittelstand mit
genau dieser Sorgfalt: Voice-Agenten, die Anrufe rund um die Uhr annehmen, plus Automationen.
Sehen, wie das für dich aussieht? **info@dripback.de**.*