Fehlerbehebung für Administratoren
Typische Symptome – vom Mock-Modus über fehlende Mails bis zu Webhook- und Anmeldeproblemen – mit Ursache und Lösung.
Für:Administrator2 Min. Lesezeit
KI und Agenten
| Symptom | Ursache | Behebung |
|---|---|---|
| Copilot/Vorschläge zeigen Badge „Mock“ | kein ANTHROPIC_API_KEY | Schlüssel setzen, API neu starten |
| Agenten laufen nicht / Vorschläge fehlen | Redis nicht erreichbar, Cron-Jobs deaktiviert (AGENTS_CRON_DISABLED=1, CRONS_ENABLED=false auf allen Instanzen) | GET /api/agents/status und GET /api/agents/runs?status=FAILED prüfen |
| Vorschlag bleibt offen mit „auto-execution failed“ | Vorbedingung verletzt (Status, fehlende ID, Partner ohne E-Mail) | Risiko-Text lesen, Daten korrigieren, „Bearbeiten & übernehmen“ |
| Vorschläge verfallen massenhaft | 72-h-Frist, niemand entscheidet | Zuständigkeit klären; Stufe für rückrollbare Aktionen anheben |
Mail und Integrationen
| Symptom | Ursache | Behebung |
|---|---|---|
| Keine Mails im Posteingang | MAIL_INGEST_ENABLED nicht true oder IMAP_HOST leer; falscher Mandant | settings.mailbox bzw. MAIL_INGEST_TENANT setzen; nur ungelesene Mails werden abgeholt |
Antworten bleiben „Noch nicht gesendet“ / smtp_send_failed | SMTP_HOST fehlt oder Anmeldung/TLS falsch | Integration „IMAP-/SMTP-Postfach“ → „Verbindung testen“ |
recipient_missing beim Senden | Partner ohne E-Mail | „E-Mail-Adressen“ im Partner pflegen |
| Keine Fahrzeugpositionen | Telematik inaktiv, Synchronisierung aus, Fahrzeug ohne „Telematik-ID“ | „Verbindung testen“, Telematik-ID ergänzen |
| Sanktionsprüfung immer „unbedenklich“ | Listen-URL leer (sanctions_list_url_missing) | URL in der Integration „EU-Sanktionsliste“ setzen |
| Webhook-Zustellungen fehlgeschlagen | Endpunkt antwortet nicht binnen 10 s mit 2xx; HTTP statt HTTPS | „Zustellungen“ prüfen, HTTPS verwenden; Idempotenz über X-LogCon-Delivery |
Abrechnung und Zugang
| Symptom | Ursache | Behebung |
|---|---|---|
| E-Rechnung mit Warnungen | UID, Bank, Adresse oder USt-ID des Kunden fehlen | „E-Rechnung prüfen“, Stammdaten ergänzen |
| Export-Datei mit kaputten Umlauten | Importprofil auf Windows-1252 | UTF-8 (BOM) im BMD/DATEV-Import wählen |
| 429 bei API-Aufrufen | 600 Anfragen/Minute/IP bzw. 60 Copilot-Nachrichten/Stunde | Aufrufe drosseln – mehrere Schlüssel helfen nicht (IP-basiert) |
| Benutzer kann sich nicht anmelden | kein Passwort gesetzt, deaktiviert, Mandant gesperrt, falsche Kennung | Passwort über „Bearbeiten“ setzen; „Reaktivieren“ |
Diagnose-Endpunkte
GET /health– Datenbank und KI-Modus (ai: 'mock'bedeutet Demo-Modus).GET /api/agents/status,GET /api/agents/runs– Zustand der Agenten und ihrer Läufe.GET /api/proposals/stats– Kennzahlen zu Vorschlägen.GET /api/webhooks/:id/deliveries– Webhook-Zustellungen.
Verwandte Artikel
- Fehlermeldungen und häufige FragenWas die Fehlerschlüssel der App bedeuten, was Sie jeweils tun können, und Antworten auf die häufigsten Fragen.
- Postfach einrichten (IMAP/SMTP)So kommen E-Mails in den KI-Posteingang und Antworten, Angebote und Rechnungen wieder hinaus – inklusive Server-Variablen und Mehrmandantenbetrieb.
- IntegrationenFrachtenbörse, Telematik, Buchhaltung, E-Mail, Routing, Geocoding, Sanktionsliste und E-Rechnung anbinden, testen und überwachen.
- Benutzer und Rollen verwaltenWelche Rolle was darf, wie Sie Benutzer einladen, bearbeiten und deaktivieren und wie Fahrer- und Portal-Logins entstehen.