Troubleshooting und Support

Wenn etwas nicht wie erwartet funktioniert, bietet dieses Kapitel Lösungen für häufige Probleme.

Häufige Probleme und Lösungen

Verständnis- und Nutzungsfragen beantworten die FAQ-Abschnitte der Kapitel, z. B. Chat, ToDos und Informationen. Dieses Kapitel widmet sich Fehlermeldungen, Fehler-IDs und unerwartetem Verhalten.

Anmeldung und Lizenz

incoreon meldet sich von selbst ab

Symptom: incoreon meldet sich ohne Vorwarnung ab; die Anmeldeseite erscheint.

Ursache: Die Sitzung ist abgelaufen. Aus Sicherheitsgründen endet die Sitzung nach einer bestimmten Zeit ohne Nutzung.

Lösung: Erneut anmelden. Nicht gesendete Eingaben und laufende Antworten sind danach verloren – bei laufenden Automatisierungen besteht kein Grund zur Sorge: Diese laufen unabhängig von der eigenen Sitzung weiter (siehe Automatisierung und Workflows).

Die Seite „Keine aktive Lizenz“ erscheint

Symptom: Nach der Anmeldung erscheint die Seite „Keine aktive Lizenz“. Der Hinweis empfiehlt, den Administrator des Unternehmens zu kontaktieren.

Ursache: Dem Zugang ist derzeit keine gültige Lizenz zugeordnet – z. B. weil die Lizenz abgelaufen oder der Zugang neu eingerichtet wurde.

Lösung: Den Administrator des Unternehmens kontaktieren. Nur dieser kann die Lizenz prüfen und aktivieren (siehe Rollen und Berechtigungen).

Chat und Agenten

Der Agent ist ausgegraut und lässt sich nicht auswählen

Symptom: In der Agentenauswahl im Chat ist ein Agent ausgegraut. Ist er dennoch ausgewählt, ist der Chat-Eingabebereich gesperrt und der Hinweis „Der gewählte Agent hat das monatliche Kostenlimit erreicht.“ erscheint.

Ursache: Zwei Ursachen kommen infrage:

• Der Agent hat sein monatliches Kostenlimit erreicht.
• Dem eigenen Zugang fehlen Zugriffsrechte auf einen Subagenten des Agenten.

Der Grund erscheint im Tooltipp des Agenten – dem kleinen Hinweisfeld, das sich bei Berührung mit dem Mauszeiger öffnet.

Lösung:

• Kostenlimit erreicht: Einen anderen Agenten auswählen, ohne Agent chatten oder das Kostenlimit erhöhen lassen (siehe Verhalten bei erreichtem Kostenlimit und Guide: Kostenlimit eines Agenten ändern).
• Fehlende Zugriffsrechte: Der Administrator passt die Zugriffsrechte auf den Subagenten an (siehe Fehlende Zugriffsrechte für Subagenten).

Der Chat erreicht das Gesprächslimit

Symptom: Im Chat erscheint der Hinweis „Das Gesprächslimit ist erreicht“.

Ursache: Der Chat hat die maximale Länge erreicht, die der Agent verarbeiten kann. Der gesamte bisherige Gesprächsverlauf wird bei jeder Nachricht erneut mitgesendet – irgendwann passt er nicht mehr.

Lösung: Ein neuer Chat wird gestartet. Wichtige Inhalte aus dem alten Chat lassen sich übernehmen, z. B. indem die entscheidende Antwort kopiert oder als Datei in den neuen Chat hochgeladen wird (siehe Dateien hochladen).

In einer Antwort erscheint eine Fehlermeldung

Symptom: Statt der erwarteten Antwort erscheint im Chat eine Fehlermeldung mit einer Fehler-ID.

Ursache: Beim Zugriff auf das Sprachmodell ist ein Fehler aufgetreten, z. B. eine Unterbrechung oder eine zu lange Anfrage. Die Ursache kann auch beim Anbieter des Sprachmodells liegen.

Lösung:

1. Die Anfrage über („Erneut versuchen...“) erneut senden. Viele Fehler sind vorübergehend.
2. Erscheint die Fehlermeldung erneut, die Anfrage kürzen oder vereinfachen – lange Nachrichten und viele Dateien begünstigen Fehler.
3. Bleibt der Fehler bestehen, den Support mit der Fehler-ID kontaktieren (siehe Support kontaktieren).

Ein Hinweisfenster meldet einen Fehler

Symptom: Am Bildschirmrand erscheint eine kurze Fehlermeldung, z. B. „Ein unerwarteter Fehler ist aufgetreten“, zusammen mit einer Fehler-ID.

Ursache: Eine Aktion konnte nicht abgeschlossen werden, z. B. das Speichern einer Einstellung.

Lösung: Die Seite neu laden und die Aktion wiederholen. Tritt der Fehler erneut auf, den Support mit der Fehler-ID kontaktieren (siehe Support kontaktieren).

Dateien

Eine Datei ist zu groß für den Upload

Symptom: Beim Hochladen in den Chat erscheint der Hinweis „Die Datei … ist zu groß. Die maximale Größe beträgt 20MB.“

Ursache: Die Datei überschreitet die maximale Größe von 20 MB pro Datei.

Lösung: Die Datei verkleinern oder aufteilen, z. B. ein PDF in einzelne Kapitel, und anschließend erneut hochladen (siehe Dateien hochladen).

Das Dateilimit ist erreicht

Symptom: Beim Hochladen erscheint der Hinweis „Dateilimit erreicht“.

Ursache: Pro Nachricht dürfen höchstens 50 Dateien hochgeladen werden.

Lösung: Die Dateien auf mehrere Nachrichten verteilen. Die Verarbeitung der ersten Nachricht kann abgewartet werden, bevor die restlichen Dateien folgen.

Das Dateiformat wird nicht unterstützt

Symptom: Beim Hochladen erscheint der Hinweis „Ungültiges Dateiformat“.

Ursache: Der Dateityp wird nicht unterstützt. Im Chat sind dies PDF, DOCX, PPTX, XLSX, CSV, PNG und JPG/JPEG. Im Wissen eines Agenten sind XLSX- und CSV-Dateien zusätzlich nicht erlaubt (siehe Wissen hinzufügen).

Lösung: Die Datei in ein unterstütztes Format konvertieren, z. B. eine ältere DOC-Datei als DOCX speichern.

Eine Wissensdatei hat zu viele Seiten

Symptom: Beim Hochladen in das Wissen eines Agenten erscheint der Hinweis „Die Datei hat zu viele Seiten“. Es sind höchstens 500 Seiten erlaubt.

Ursache: Die Datei überschreitet die maximale Seitenzahl von 500.

Lösung: Die Datei in kleinere Teile aufteilen und die Teile einzeln hochladen (siehe Wissen hinzufügen).

Eine Wissensdatei lässt sich nicht verarbeiten

Symptom: Eine in das Wissen eines Agenten hochgeladene Datei zeigt trotz abgeschlossenen Hochladens den Fehler „Die Datei konnte nicht verarbeitet werden“.

Ursache: Die Hintergrundverarbeitung ist fehlgeschlagen, z. B. weil die Datei beschädigt oder passwortgeschützt ist.

Lösung: Die Datei entfernen und nach einer Prüfung erneut hochladen – beschädigte Dateien neu exportieren, passwortgeschützte entschlüsseln. Hilft das nicht, eine andere Datei verwenden oder den Support kontaktieren.

Verbindungen und Automatisierung

Der Chat verlangt eine Kontoverbindung

Symptom: Beim Senden einer Nachricht erscheint der Hinweis „Um den Agent nutzen zu können, muss dein …-Konto verbunden sein.“

Ursache: Der Agent nutzt eine Fähigkeit, die eine Anmeldung bei einem Dienst erfordert – z. B. Microsoft – und das persönliche Konto ist noch nicht verbunden oder die Verbindung ist abgelaufen.

Lösung: Auf „Jetzt verbinden“ klicken und die Anmeldung durchführen. Abgelaufene Verbindungen lassen sich im Profil erneuern (siehe Verbindung erneuern).

Der Verbindungstest einer eigenen Fähigkeit schlägt fehl

Symptom: Beim Testen eines MCP-Servers für eine eigene Fähigkeit schlägt der Verbindungstest fehl; incoreon meldet „Verbindung fehlgeschlagen“.

Ursache: Der MCP-Server ist derzeit nicht erreichbar – oder er unterstützt die erforderliche Technik nicht: MCP-Server müssen über HTTPS erreichbar sein und „streamable_http“ unterstützen.

Lösung: Die Adresse auf HTTPS prüfen und den Server auf Erreichbarkeit kontrollieren. Ist der Server korrekt eingerichtet, den Verbindungstest später wiederholen. Details zur Einrichtung stehen unter Eigene Fähigkeiten über MCP-Server hinzufügen.

Der Zeitplan einer Automatisierung lässt sich nicht speichern

Symptom: Beim Einrichten oder Bearbeiten einer Automatisierung wird der Zeitplan nicht übernommen; der Hinweis „Der eingegebene Zeitplan ist ungültig.“ oder „Enddatum darf nicht vor dem Startdatum liegen.“ erscheint.

Ursache: Der eingegebene Zeitplan entspricht keiner gültigen Angabe – oder das Enddatum liegt vor dem Startdatum.

Lösung: Den Zeitplan korrigieren, bis die Vorschau eine passende Beschreibung anzeigt; das Enddatum auf ein Datum nach dem Startdatum setzen oder freilassen (siehe Auslöser über Zeitplan).

Der Browser blockiert ein Pop-up

Symptom: Beim Verbinden eines Kontos oder beim Öffnen einer Datei erscheint der Hinweis „Pop-up blockiert“.

Ursache: Der Browser blockiert das von incoreon geöffnete Anmelde- oder Ansichtsfenster.

Lösung: Pop-ups für incoreon im Browser erlauben – die Browserleiste zeigt dazu beim blockierten Fenster eine Meldung mit einer Option zum Erlauben. Anschließend die Aktion wiederholen.

Benachrichtigungen

Es kommen keine E-Mails über neue ToDos oder Informationen

Symptom: ToDos oder Informationen werden zugewiesen, aber es kommt keine E-Mail-Benachrichtigung.

Ursache: Die E-Mail-Benachrichtigungen sind deaktiviert, oder die E-Mails landen im Spam-Ordner. Eigene Einträge lösen zudem keine E-Mail aus.

Lösung:

1. Die E-Mail-Benachrichtigungen im Profil prüfen und einschalten (siehe E-Mail-Benachrichtigungen einrichten).
2. Den Spam-Ordner prüfen; Absender bei Bedarf als sicher markieren.
3. Prüfen, ob die E-Mail nur für zugewiesene Einträge vorgesehen ist (siehe FAQs zum Profil).

Fehlermeldungen und deren Bedeutung

Tritt ein Fehler auf, zeigt incoreon neben der Fehlermeldung eine Fehler-ID – z. B. „Fehler-ID: 4f9a2b7c-…“. Die Fehler-ID ist eine eindeutige Kennung genau dieses Fehlers. Sie sollte bei jeder Supportanfrage angegeben werden: Nur damit lässt sich der Fehler im System eindeutig nachvollziehen (siehe Support kontaktieren).

Die folgende Tabelle listet die häufigsten Fehlermeldungen mit Bedeutung und Abhilfe:

Meldung	Bedeutung	Abhilfe
„Das Gesprächslimit ist erreicht“	Der Chat ist für den Agenten zu lang geworden.	Neuen Chat starten (siehe Chat und Agenten).
„Das Kostenlimit für diesen Agenten ist erreicht.“	Der Agent hat sein monatliches Kostenlimit erreicht.	Anderen Agenten auswählen oder Kostenlimit erhöhen lassen (siehe Verhalten bei erreichtem Kostenlimit).
„Das Anfrage-Limit wurde erreicht. Bitte warte einen Moment und versuche es erneut.“	In kurzer Zeit wurden zu viele Anfragen gesendet.	Kurz warten und die Anfrage erneut senden.
„Das Sprachmodell hat nicht rechtzeitig geantwortet. Bitte versuche es erneut.“	Das Sprachmodell hat zu lange gebraucht.	Anfrage erneut senden.
„Deine Anfrage verstößt gegen die Inhaltsrichtlinien des Sprachmodells.“	Die Anfrage wird vom Sprachmodell abgelehnt.	Anfrage umformulieren und erneut senden.
„OAuth-Anmeldung erforderlich“	Eine verbundene Anmeldung fehlt oder ist abgelaufen.	Konto über „Jetzt verbinden“ verbinden bzw. Verbindung erneuern (siehe Verbindung erneuern).
„Fehlende Berechtigungen“	Der eigene Zugang darf auf die angeforderte Funktion nicht zugreifen.	Administrator um die erforderlichen Rechte bitten (siehe Rollen und Berechtigungen).
„Authentifizierung fehlgeschlagen“	Die Anmeldung konnte nicht bestätigt werden.	Neu anmelden; bleibt der Fehler, Support kontaktieren.
„Service nicht verfügbar“	incoreon oder ein Dienst ist vorübergehend nicht erreichbar.	Später erneut versuchen; bei Dauerhaftigkeit Support kontaktieren.
„Ein unerwarteter Fehler ist aufgetreten“	Technischer Fehler ohne konkrete Ursache im Meldungstext.	Aktion wiederholen; andernfalls Support mit Fehler-ID kontaktieren.

Support kontaktieren

Der schnellste Weg zur Lösung führt in dieser Reihenfolge:

1. FAQ-Abschnitt des Kapitels – Nutzungs- und Verständnisfragen (siehe z. B. Chat).
2. Dieses Kapitel – Fehlermeldungen und unerwartetes Verhalten (siehe Häufige Probleme und Lösungen).
3. Support – alles, was damit nicht gelöst wird.

Damit der Support helfen kann, werden einer Anfrage folgende Angaben beigefügt:

• die Fehler-ID aus der Fehlermeldung (siehe Fehlermeldungen und deren Bedeutung)
• ein Screenshot der Fehlermeldung oder des Problems
• Datum und Uhrzeit des Auftretens
• eine kurze Beschreibung: Was wurde getan, und was passierte stattdessen?
• der betroffene Agent oder Chat bzw. der Arbeitsschritt
• der verwendete Browser und, falls möglich, das Betriebssystem

Kontaktwege:

• support@incoreon.ai