KI-Bewertungs-Fehler
Cockpit’s KI-Bewertungen — sowohl die KI-Bewertung vor Veröffentlichung als auch die Lern-Bewertung danach — laufen über externe KI-Anbieter. Diese Aufrufe können fehlschlagen, und Cockpit zeigt euch den Grund so präzise wie möglich.
Diese Seite ist eure Diagnose-Karte, wenn ihr „Bewertung fehlgeschlagen” in einer Variant-Karte seht.
Was ihr in der App seht
In der Variant-Karte erscheint:
Bewertung fehlgeschlagen: <Begründung>
Die Begründung gehört zu einer von drei Fehler-Klassen:
- Anbieter nicht erreichbar oder Anfrage abgelehnt — Auth-Problem oder Outage des KI-Anbieters.
- Antwort im falschen Format — der Anbieter hat geantwortet, aber in einem Format, das Cockpit nicht weiterverarbeiten konnte.
- Antwort unvollständig — der Anbieter hat geantwortet, aber wichtige Felder fehlten.
Klasse 1 — Anbieter nicht erreichbar oder Anfrage abgelehnt
Fehler-Text:
Bewertung fehlgeschlagen: Die KI-Bewertung ist momentan nicht verfügbar. Bitte später erneut versuchen.
Typische Ursachen:
| Ursache | Was tun? |
|---|---|
| API-Schlüssel falsch oder abgelaufen | Platform-Admin trägt einen neuen Schlüssel ein |
| Modell beim Anbieter umbenannt oder entfernt | Platform-Admin wählt ein anderes Modell |
| Quota erschöpft oder Anfrage-Limit erreicht | Warten und erneut versuchen — oder Anbieter wechseln |
| Vorübergehender Ausfall beim Anbieter | Warten — meist nach wenigen Minuten gelöst |
| Netzwerk-Problem zwischen Cockpit und Anbieter | Platform-Admin prüft die Verbindung |
Diagnose-Pfad als Manager oder Aktive:
- Nicht selbst Schlüssel rotieren — das macht der Platform-Admin.
- Wenn der Fehler wenige Male auftritt und dann verschwindet, war es vermutlich ein Anbieter-Ausfall oder ein Anfrage-Limit-Burst — nichts zu tun.
- Wenn der Fehler bei jeder Bewertung kommt, ist die
wahrscheinlichste Ursache ein abgelaufener Schlüssel. Sprecht den
Platform-Admin an mit:
- Welche Art von Bewertung betroffen ist (Beitrags-Variante? Antwort-Entwurf? Konsistenz-Hinweis?).
- Seit wann der Fehler auftritt.
Klasse 2 — Antwort im falschen Format
Fehler-Text:
Bewertung fehlgeschlagen: Die Antwort der KI war kein gültiges JSON. Bitte erneut versuchen.
Hintergrund: Cockpit verlangt von der KI eine strukturierte Antwort. Manche Modelle wickeln die Antwort in zusätzliche Markdown-Formatierung ein, obwohl die Anleitung das verbietet. Cockpit räumt das in den meisten Fällen automatisch auf — wenn dieser Fehler doch erscheint, hilft Folgendes:
- Erneut versuchen. KI-Modelle sind stochastisch — ein Wiederholungs-Versuch löst das Problem oft.
- Wenn der Fehler systematisch wiederkommt, passt das gewählte Modell nicht zu Cockpit’s Vorgaben. Der Platform-Admin kann im Verbindungstest prüfen und ggf. ein anderes Modell wählen.
Klasse 3 — Antwort unvollständig
Fehler-Text:
Bewertung fehlgeschlagen: Die KI-Antwort war unvollständig. Bitte erneut versuchen.
Hintergrund: Die Antwort kam zwar an, aber Cockpit fehlten Pflicht-Felder — etwa einer der drei Score-Werte. Cockpit lehnt unvollständige Antworten ab, statt einen halben Datensatz zu speichern.
Behandlung:
- Erneut versuchen — meist das schnellste Mittel.
- Wenn systematisch: das gewählte Modell scheint die geforderte Struktur nicht zuverlässig zu liefern. Der Platform-Admin kann ein anderes Modell testen oder eines mit größerem Antwort-Spielraum wählen (manchmal schneidet die Antwort am Ende ab).
Was Manager und Aktive selbst tun können
| Aktion | Pfad |
|---|---|
| Erneut versuchen | „Lern-Bewertung anfordern” erneut klicken |
| Den Fehler im Team kommunizieren | Interne Notiz an dem Beitrag oder Kommentar, mit Datum und genauem Fehlertext |
| Bei systematischem Auftreten | Platform-Admin kontaktieren |
Manager und Aktive haben keinen Zugriff auf KI-Schlüssel oder Modell-Wahl — die Plattform-Konfiguration ist bewusst vom Organisations-Konto getrennt. Wer sie ändern darf, ist der Platform-Admin (in der Regel die Cavalry-Betreuung).
Was der Platform-Admin tun kann
Im Platform-Admin-Bereich sitzen pro KI-Funktion getrennt:
- Anbieter wählbar.
- Modell wählbar — aus einer kuratierten Empfehlungsliste plus Freitext-Eingabe für eigene Modell-IDs.
- API-Schlüssel speichern (verschlüsselt) oder leer lassen (behält den alten Schlüssel).
- Verbindungstest — ein einzelner Probe-Aufruf gegen Anbieter plus
Modell, der den Status sofort zeigt:
- „Letzter Test: erfolgreich am
” — alles in Ordnung. - „Letzter Test: fehlgeschlagen am
” — Schlüssel oder Modell stimmt nicht.
- „Letzter Test: erfolgreich am
Diagnose-Pfad für den Platform-Admin:
- Im Platform-Admin-Bereich anmelden.
- „LLM-Einstellungen” aufrufen.
- KI-Funktion identifizieren, deren Bewertung fehlschlägt — Cockpit
trennt die Konfiguration für vier Anwendungsfälle:
- Beitrags-Bewertung (KI- und Lern-Bewertung von Beiträgen)
- Antwort-Bewertung (KI-Bewertung von Antwort-Entwürfen in der Inbox)
- Varianten-Erzeugung (KI-Varianten in Schritt 3 des Beitrags- Wizards)
- Konsistenz-Hinweise zwischen Grundlagen
- Verbindungstest ausführen.
- Bei Fehler: Schlüssel neu eintragen oder anderes Modell wählen, dann Test wiederholen.
Hinweis zu NanoGPT — Abrechnungs-Modell
Eine besondere Falle, falls ihr NanoGPT als Anbieter nutzt: NanoGPT bietet Modelle in zwei Abrechnungs-Klassen an:
- Subscription-Modelle — eure pauschal bezahlte Subscription deckt die Aufrufe ab. Cockpit’s Empfehlungsliste für NanoGPT ist bewusst auf Subscription-Modelle beschränkt, damit ein Klick aus der Liste garantiert mit eurer Subscription funktioniert.
- Anfrage-basierte Modelle — eigene Credit-Abrechnung pro Aufruf. Gemini, GPT-4o, Claude direct fallen in diese Klasse. Wenn ihr solche Modelle nutzen wollt, gebt die Modell-ID über das Freitext-Feld „Eigene Modell-ID” ein — sie sind absichtlich nicht in der Empfehlungsliste, weil ein Subscription-Schlüssel diese Modelle nicht abdeckt.
Bei einem 401-Fehler nach Auswahl eines NanoGPT-Modells lohnt sich der Check: ist das gewählte Modell tatsächlich subscription-gedeckt?
Häufige Fragen
Warum zeigt Cockpit nicht genauer, woran die Bewertung scheiterte? Eine ausführlichere Fehler-Anzeige direkt am Beitrag ist für eine spätere Version geplant — heute hilft der Verbindungstest im Platform-Admin-Bereich beim Einordnen.
Wird automatisch erneut versucht? Nein, nicht bei KI-Aufrufen. Auth-Fehler lassen sich durch Wiederholung nicht beheben — Cockpit verzichtet deshalb auf automatische Wiederholungen und meldet den Fehler direkt, damit ihr ihn sehen und gezielt behandeln könnt.
Wo finde ich den Verbindungstest noch? Nur im Platform-Admin-Bereich. Manager haben keine LLM-Einstellungs-Sicht im normalen Tool-UI — die Konfiguration läuft ausschließlich über den Platform-Admin.