Support

Fehlerbehebung

Häufige Ausfälle — Schlüssel, Connectors, Widget-CSP, leeres Retrieval — und wie Sie die Ursache isolieren, bevor Sie den Support kontaktieren.

fehlerbehebungfehlerdebugging

Die meisten Incidents drehen sich um Anmeldedaten, Scope und veralteten Inhalt. Diese Seite bietet eine schnelle Triage-Reihenfolge; fügen Sie Logs und Zeitstempel bei Ticket-Eröffnung bei.

Reproduzieren Sie im Dashboard-Test-Chat, um zu wissen, ob das Problem kanalspezifisch ist oder den gesamten Agenten betrifft.

API- und Modellschlüssel-Fehler

401/403 deuten meist auf falschen Schlüssel, falsche Organisation oder abgelaufene BYOK-Anmeldedaten hin. Prüfen Sie, dass Umgebung (Prod vs. Staging) zum konfigurierten Schlüssel passt.

Nach Rotation starten oder aktualisieren Sie abhängige Dienste, die Header cachen.

Schwache oder leere Antworten

Bestätigen Sie, dass der Agent die erwartete Wissensbasis nutzt. Starten Sie Sync- oder Crawl-Jobs neu, wenn sich Inhalte kürzlich geändert haben.

Prüfen Sie, ob Anweisungen zu restriktiv sind — das Modell kann ablehnen, auch wenn Retrieval korrekt ist.

Widget lädt nicht

Prüfen Sie CSP, Werbeblocker und Script-Platzierung. Suchen Sie Konsolenfehler zu blockierten connect-src-Hosts.

Bestätigen Sie, dass der Embed-Schlüssel zum Agenten und zu erlaubten Domain-Listen passt, falls aktiviert.

Quota-Fehler bei Import oder Crawl (402 / „Limit erreicht“)

Wenn Wissensimporte nach vielen Bildern oder Mediendateien mit Quota- oder Zahlungsfehler fehlschlagen, haben Sie möglicherweise monatliche gehostete Limits für Gemini-Bilderkennung oder Medientranskription aufgebraucht.

Abhilfe: Fügen Sie einen Google-Gemini-API-Schlüssel unter Einstellungen → LLM-API-Schlüssel hinzu, damit diese Vorgänge Ihr Google-Projekt nutzen, bitten Sie einen Administrator, Tariflimits zu erhöhen, oder importieren Sie vorübergehend Formate mit nativem Text und deaktivieren Sie Medienverarbeitung in Crawls.

  • Crawls mit aktiviertem Bild oder Medien erfordern auflösbare Gemini-Konfiguration (gehostet oder Org); sonst lehnt die API Crawl-Start mit Gemini-fehlt-Meldung ab.
  • Reiner OCR-Text aus Bildern kann erscheinen, wenn Vision übersprungen wird; nehmen Sie nicht an, die Datei sei vollständig fehlgeschlagen — prüfen Sie den gespeicherten Dokumentkörper.

Auf Ihrem Stack bauen

Bereit für fundierte Assistenten?

Testversion starten oder mit uns über Rollout, Governance und Enterprise-Anforderungen sprechen.