Fehlerbehebung
Fehlerbehebung
Diese Seite listet die Fehlermeldungen und Hinweise von AnyLLM im Wortlaut — im Chat, auf Vorschlagskarten, in den Verläufen, in den Einstellungen, in den Confluence-Schnellaktionen und im Dashboard-Gadget — mit Ursache und Lösung (Fehler, Probleme, Störungen beheben). Suchen Sie eine bestimmte Meldung, nutzen Sie die Suchfunktion Ihres Browsers auf dieser Seite.
Zuerst prüfen
- Sehen Sie den Chat überhaupt? Falls nicht, oder wenn nur ein Hinweis erscheint → Die App startet nicht oder ist gesperrt.
- Ist das Eingabefeld gesperrt (Platzhalter Konfiguration durch einen Admin erforderlich.)? Dann ist die App noch nicht eingerichtet → derselbe Abschnitt. (Ein inaktives Abonnement sperrt das Feld nicht, sondern blockiert nur das Senden — siehe unten.)
- Tritt der Fehler in Jira und in Confluence auf? Beide Produkte teilen sich eine Konfiguration; ein Problem in nur einem Produkt bedeutet daher fast immer, dass der KI-Endpoint in diesem Produkt noch nicht freigegeben ist (Meldung "Der Endpoint … ist in … noch nicht freigegeben — Endpoint-Freigaben gelten je Produkt. …") oder dass Confluence nicht mit der App verbunden ist.
- Trat es nur einmal auf? Netzwerkbedingte Abbrüche kommen vor. Senden Sie einmal erneut, bevor Sie es melden.
Die App startet nicht oder ist gesperrt
| Meldung | Ursache | Lösung |
|---|---|---|
| Noch nicht eingerichtet mit "Der Chat ist verfügbar, sobald ein Admin die App konfiguriert hat."; das Eingabefeld zeigt Konfiguration durch einen Admin erforderlich. | keine gespeicherte Konfiguration oder keine Verbindung mit hinterlegtem API-Key | Administration: LLM-Verbindungen einrichten |
| "Noch nicht konfiguriert — ein Administrator hinterlegt Endpoint, Modelle und API-Key in den App-Einstellungen (Jira: Einstellungen → Apps · Confluence: Einstellungen → AnyLLM)." (Banner im Chat) | wie oben | wie oben |
| "Noch nicht konfiguriert — ein Admin muss in den App-Einstellungen Verbindungen und API-Keys hinterlegen." (Schnellaktionen) bzw. "Not configured yet — an admin must set up connections and API keys in the app settings." (Server-Meldung in Antworten der Chat-Leiste und im Dashboard-Gadget) | wie oben | wie oben |
| "Das AnyLLM-Abonnement dieser Site ist inaktiv — ein Administrator kann es in der Atlassian-Administration (Abrechnung) prüfen." (Chat) · "… — ein Administrator kann es in der Atlassian-Administration prüfen." (Schnellaktionen) · "The AnyLLM subscription for this site is inactive — an admin can review it in Atlassian administration." (Server, z. B. im Gadget) | das kostenpflichtige Abonnement ist inaktiv. Gesperrt sind nur neue Antworten und ✓ Ausführen; Verläufe, Memory, eigene Agents und Skills sowie alle Einstellungen funktionieren weiter | Administration: das Abonnement in der Atlassian-Administration prüfen — siehe Lizenz, Datenhaltung und automatische Löschung |
| "Diese Funktion wurde von deinem Administrator deaktiviert." (im Seiten-Assistenten, in der Vorgangs-Aktion und im Vorgangsnavigator mit einem Link Schließen; im Gadget in der Ansicht und im Bearbeiten-Modus; auf der eigenständigen Vollseite) | genau diese Fläche ist unter Module abgeschaltet; Menüeinträge lassen sich nicht je Installation ausblenden | einen anderen Einstieg nutzen, z. B. Apps → AnyLLM Chat; Administration: Module |
| ⤢ Vollbild auf einem Jira-Vorgang öffnet nur den Deaktiviert-Hinweis | das Modul Vollbild-Chat (Jira) ist abgeschaltet | Administration: Module |
| "Der Seitenzugriff für die AI ist vom Admin deaktiviert — Seiten-Aktionen sind nicht verfügbar." (Seiten-Schnellaktionen ausgegraut) | der AI-Zugriff steht auf Aus | Aktionen auf markiertem Text funktionieren weiterhin; Administration: Allgemeine Einstellungen |
| "Konfiguration konnte nicht geladen werden." | die Einstellungen waren kurzzeitig nicht abrufbar | Seite neu laden; bei Wiederholung die Administration informieren |
| Die Chat-Leiste in Confluence ist verschwunden | Ausblenden wurde geklickt (gilt nur für die aktuelle Ansicht), die Fläche ist abgeschaltet, die App ist nicht eingerichtet, das Abonnement ist inaktiv oder der Status konnte nicht geladen werden — in keinem dieser Fälle zeigt die Leiste eine Meldung | Seite neu laden. Der Status der Leiste wird zehn Minuten lang in Ihrem Browser zwischengespeichert; nachdem die Administration sie wieder eingeschaltet oder die Einrichtung abgeschlossen hat, kann es daher bis zu zehn Minuten dauern, bis die Leiste wieder erscheint |
| Der Knopf Einstellungen fehlt im Chat | Sie sind nicht Administrator:in — in Confluence erscheint der Knopf nur für Mitglieder der üblichen Administrator-Gruppen | die Einstellungen über das Produkt öffnen: Jira Einstellungen → Apps → AnyLLM Chat — Einstellungen, Confluence Einstellungen → AnyLLM Chat — Einstellungen — siehe Einstellungen öffnen und Ersteinrichtung |
Meldungen beim Chatten
Die Anfrage kommt nicht durch
| Meldung | Ursache | Lösung |
|---|---|---|
| "Keine Antwort vom Stream (Timeout) — bitte erneut versuchen." | 60 Sekunden lang kam nichts vom Stream | erneut senden; bei Wiederholung die Administration informieren |
| "Stream-Fehler." / "Aufruf fehlgeschlagen (Invocation-Fehler oder Timeout)." | die Verarbeitung wurde unterbrochen | erneut senden |
| "Hourly limit reached (… requests/hour) — please try again later." (Stundenlimit erreicht) | Ihr persönliches Stundenlimit ist erreicht. Ein Zähler gilt für Jira und Confluence gemeinsam; jedes Senden zählt (auch ↻ Antwort neu generieren, Schnellaktionen und das Aktualisieren des Gadgets); das Zeitfenster beginnt mit Ihrer ersten Anfrage und endet eine Stunde später | warten. Die Administration kann das Limit anpassen — Allgemeine Einstellungen |
| "Please enter a prompt." (leere Nachricht) | eine leere Nachricht wurde gesendet | Text eingeben |
| "Connection not configured or has been removed." (Verbindung nicht konfiguriert oder entfernt) | die Verbindung hinter dem gewählten Modell wurde entfernt oder hat keinen API-Key mehr | ein anderes Modell in der Auswahl Modell wählen oder neu laden; sonst Administration |
| "Der Endpoint … ist in … noch nicht freigegeben — Endpoint-Freigaben gelten je Produkt. Ein Administrator kann sie in den AnyLLM-Einstellungen von … unter „Endpoint-Freigaben“ erteilen." (erscheint in Ihrer Oberflächensprache) | die KI-Adresse ist in diesem Produkt nicht freigegeben — typisch direkt nach einem Konfigurations-Import oder wenn sie nur im anderen Produkt freigegeben wurde | Administration: Endpoint-Freigaben verwalten |
Der KI-Dienst lehnt ab
| Meldung | Ursache | Lösung |
|---|---|---|
| "LLM endpoint rejects the API key (401/403)." (API-Key abgelehnt) | API-Key falsch, abgelaufen oder ohne Berechtigung | Administration: Key erneuern — LLM-Verbindungen einrichten |
| "Rate limit of the LLM endpoint reached (429)." (Kontingent des KI-Dienstes erschöpft) | das Kontingent beim KI-Anbieter ist erschöpft | kurz warten; hält es an, Administration |
| "LLM endpoint responded with HTTP …" (gefolgt von der Antwort des Dienstes) | der Dienst meldet einen Fehler | die Administration prüft Adresse, Modellnamen und Kontingent |
| "Timeout after 120s — shorten the prompt or choose another model." (Zeitüberschreitung) | eine Runde des Modells dauerte länger als 120 Sekunden | kürzer fragen oder ein anderes Modell wählen |
| "LLM call failed: …", ggf. mit "This endpoint needs a network approval: check that an administrator has approved it under Settings → Endpoint approvals." (Aufruf fehlgeschlagen; der Endpoint braucht eine Netzfreigabe) | der Dienst war nicht erreichbar; mit dem Zusatz ist die Adresse nicht freigegeben | Administration: Endpoint-Freigaben verwalten |
| "The LLM response was empty or had an unexpected format." (leere oder unerwartete Antwort) | der Dienst hat in einer Form geantwortet, die die App nicht versteht | die Administration prüft Provider-Typ und Modellnamen |
| "Internal stream error." (interner Stream-Fehler) | ein unerwarteter Fehler beim Streamen | erneut senden; bei Wiederholung die Administration informieren |
Die Antwort bleibt leer oder bricht ab
| Meldung | Ursache | Lösung |
|---|---|---|
| "The model used its token budget (8000) on internal reasoning without answering — shorten the prompt or choose a non-reasoning model." (Token-Budget durch internes Nachdenken aufgebraucht) | das Modell hat das gesamte Antwort-Budget für internes Nachdenken verbraucht | kürzer fragen oder ein Modell ohne interne Überlegungsphase wählen |
| Lange "Modell denkt nach …" | das Modell überlegt intern, bevor Text entsteht | abwarten; passiert das dauerhaft, kann die Administration ein anderes Default-Modell wählen |
| "I proposed an action — please confirm or dismiss it above." (Aktion vorgeschlagen — bitte oben bestätigen oder verwerfen) | die KI hat nur eine Vorschlagskarte und keinen Text erzeugt | auf der Karte ✓ Ausführen oder Verwerfen klicken |
| Die Antwort war da und ist nach Stopp weg | Stopp blendet nur die Anzeige aus; die Anfrage läuft auf dem Server weiter | die Unterhaltung erneut unter Verläufe öffnen — die vollständige Antwort kann dort liegen |
| Die KI erinnert frühere Teile eines langen Chats nicht mehr | nur die jüngsten 16 Nachrichten (rund 32.000 Zeichen) gehen an die KI, obwohl der Verlauf alles behält | die wichtigen Fakten wiederholen oder einen neuen Chat mit einer kurzen Zusammenfassung beginnen |
| Die KI hört nach wenigen Nachschlagevorgängen auf oder beendet eine mehrstufige Aufgabe nicht | pro Antwort darf die KI in höchstens 5 Runden nachschlagen (je bis zu 120 Sekunden, die gesamte Antwort höchstens 5 Minuten); Nachschlage-Ergebnisse werden bei 8.000 Zeichen gekürzt | die Aufgabe in kleinere Fragen aufteilen |
Darstellung
| Meldung | Ursache | Lösung |
|---|---|---|
| Bilder erscheinen als Link "externes Bild anzeigen" | Absicht: Bilder werden nicht automatisch geladen, damit kein Bild ungefragt Daten nach außen melden kann | den Link anklicken — das Bild öffnet sich in einem neuen Tab |
| "Diagramm konnte nicht gerendert werden:" | das Modell hat fehlerhaften Diagrammcode geliefert; der Code wird darunter angezeigt | die KI bitten, das Diagramm zu korrigieren |
| "Mermaid konnte nicht geladen werden:" | die Diagrammbibliothek konnte nicht geladen werden | Seite neu laden |
| Tool-Schritte zeigen englische Beschriftungen wie "Jira search: …", "Reading issue …", "Web search: …" | diese Statuszeilen sind immer auf Englisch | — |
Meldungen bei Aktionen in Jira und Confluence
Die meisten dieser Meldungen erscheinen auf einer Vorschlagskarte nach ✓ Ausführen; einige, entsprechend gekennzeichnet, stammen aus Nachschlagevorgängen der KI und erreichen Sie nur in ihrer Antwort. Erfolgsmeldungen sind teils deutsch, teils englisch — unabhängig von der Oberflächensprache: "✅ Vorgang ABC-1 erstellt.", "✅ Vorgang ABC-1 aktualisiert.", "✅ Comment added to ABC-1.", "✅ Page "…" created in space …" — jeweils gefolgt von einem Link.
| Meldung | Ursache | Lösung |
|---|---|---|
| "Write actions are not enabled by the admin." (Schreibaktionen nicht freigegeben) | der AI-Zugriff steht nicht auf Lesen + Schreiben — auch dann, wenn die Administration ihn geändert hat, während die Karte offen war | die Administration bitten, Lesen + Schreiben zu aktivieren — Allgemeine Einstellungen |
| "This feature has been disabled by your administrator." (Funktion deaktiviert) | die Fläche wurde inzwischen abgeschaltet | einen anderen Einstieg nutzen |
| "Required field missing: …" (Pflichtfeld fehlt) | im Vorschlag fehlt ein Pflichtfeld | die KI bitten, den Vorschlag mit diesem Feld zu wiederholen |
| "Field too long: …" (Feld zu lang) | ein Feld überschreitet 32.000 Zeichen | einen kürzeren Text erzeugen lassen |
| "Invalid field: …" / "Invalid arguments." / "Unknown action." (ungültiger Vorschlag) | der Vorschlag ist fehlerhaft aufgebaut | die KI um einen neuen Vorschlag bitten |
| "Nothing to update: provide a new summary and/or description." (nichts zu aktualisieren) | eine Karte Jira-Vorgang aktualisieren ohne neue Zusammenfassung oder Beschreibung | die KI um konkrete Änderungen bitten |
| "No access to Jira-Suche (user permissions insufficient)." / "No access to Vorgang ABC-1 (user permissions insufficient)." / "No access to Seite erstellen (user permissions insufficient)." (keine Berechtigung) | Ihnen fehlen die Rechte in Jira bzw. Confluence | die Rechte im Projekt oder Bereich klären |
| "Vorgang ABC-1 was not found." (auf einer Karte; bei Nachschlagevorgängen kann die KI auch "Seite 123 was not found." melden) | der Vorgang bzw. die Seite existiert nicht oder ist für Sie unsichtbar | das Kürzel prüfen; die KI kann die für Sie sichtbaren Projekte und Bereiche auflisten |
| "Space "DOCS" was not found." (Bereich nicht gefunden) | das Bereichskürzel ist falsch | das korrekte Kürzel angeben |
| "Seite erstellen: Atlassian API responded with HTTP 400." | Confluence hat die Seite abgelehnt — meist existiert im Bereich bereits eine Seite mit diesem Titel | einen anderen Titel wählen |
| "Vorgang erstellen: Atlassian API responded with HTTP …" / "Kommentar auf ABC-1: Atlassian API responded with HTTP …" / "Vorgang ABC-1: Atlassian API responded with HTTP …" | Jira hat die Aktion abgelehnt, z. B. wegen Pflichtfeldern oder eines im Projekt unbekannten Vorgangstyps | Projekt und Vorgangstyp prüfen; die KI bitten, den Vorschlag anzupassen |
| "Invalid issue key." (auf einer Karte; bei Nachschlagevorgängen kann die KI auch "Invalid page ID." melden) | falsches Format | den korrekten Schlüssel bzw. die korrekte Seiten-ID angeben |
| "Action failed." (Aktion fehlgeschlagen) / "Fehlgeschlagen." / "Aufruf fehlgeschlagen." | ein unerwarteter Fehler bei der Ausführung | erneut versuchen; bei Wiederholung die Administration informieren |
| Die KI sagt, sie finde eine gerade erstellte Seite nicht | frische Seiten sind manchmal noch nicht in der Suche | kurz warten oder die Seite direkt benennen |
| Nach Jira-Vorgang aktualisieren fehlen Bilder, @-Erwähnungen, Status-Lozenges oder Smart Links; die Beschreibung enthält [Bild/Anhang] oder [gekürzt, … Zeichen gesamt] | die Aktualisierung ersetzt die gesamte Beschreibung; Bilder sieht die KI nur als Markierung [Bild/Anhang], und Text jenseits von etwa 8.000 Zeichen wird abgeschnitten | den Vorgang prüfen und Fehlendes aus der Vorgangshistorie wiederherstellen |
Meldungen bei Verläufen und beim Archivieren
| Meldung | Ursache | Lösung |
|---|---|---|
| "Verlauf konnte nicht geladen werden." | die Verlaufsliste war nicht abrufbar | Seite neu laden |
| "Unterhaltung konnte nicht geladen werden." / "Conversation not found." (Unterhaltung nicht gefunden) | die Unterhaltung wurde gelöscht oder ist automatisch entfallen — je Person werden 50 Unterhaltungen behalten, die ältesten nicht angepinnten weichen zuerst | wichtige Unterhaltungen anpinnen oder archivieren |
| "Abzweigen fehlgeschlagen." | die Kopie konnte nicht angelegt werden | erneut versuchen |
| "No personal Confluence space found — open your Confluence profile once ("Create personal space") and try again." (kein persönlicher Confluence-Bereich) | Sie haben keinen persönlichen Confluence-Bereich | das Confluence-Profil öffnen, den persönlichen Bereich anlegen, erneut archivieren |
| "Archivieren fehlgeschlagen." / "Archiving failed." / "A page with this title already exists." (Seite mit diesem Titel existiert bereits) | Confluence nicht erreichbar, Rechte fehlen oder ein Titelkonflikt | erneut versuchen; hält es an, Administration |
| Löschen mit Vorher in meinem Confluence-Archiv sichern tut nichts | das Archivieren ist fehlgeschlagen — dann wird nichts gelöscht | zuerst die Ursache beim Archivieren beheben, dann löschen |
| Eine Unterhaltung ist verschwunden | gelöscht, temporär oder aus den jüngsten 50 herausgefallen | nicht wiederherstellbar; Vorbeugung: anpinnen oder archivieren |
| Ältere Nachrichten fehlen in einem langen Chat | sehr lange Unterhaltungen werden vorne gekürzt (die letzten beiden Nachrichten bleiben immer) | wichtige Inhalte früh exportieren oder archivieren |
Die Archivseite zeigt **fett** oder Tabellen wörtlich | Archivseiten sind absichtlich reiner Text | für eine formatierte Kopie ↓ Unterhaltung exportieren (Markdown) nutzen |
| Die Archivseite ist auf Englisch, obwohl die Oberfläche deutsch ist | die Beschriftungen des Archivs folgen der von der Administration eingestellten Oberflächensprache — deutsch nur, wenn dort Deutsch gewählt ist | Administration: Allgemeine Einstellungen |
Meldungen bei eigenen Agents und Skills
| Meldung | Ursache | Lösung |
|---|---|---|
| "At most 5 own agents." (höchstens 5 eigene Agents) | Obergrenze erreicht | einen vorhandenen Agent bearbeiten oder löschen |
| "At most 10 own skills." (höchstens 10 eigene Skills) | Obergrenze erreicht | einen vorhandenen Skill bearbeiten oder löschen |
| "The shared registry is full (max 30)." (die Liste geteilter Agents ist voll) | site-weit sind bereits 30 Agents geteilt. Ihr Agent wurde trotzdem als privater Agent gespeichert | erneut öffnen, das Häkchen Für alle Nutzer dieser Site verfügbar machen entfernen, erneut speichern |
| "„…“: name missing or longer than 40 characters." / "„…“: instructions missing." / "„…“: instructions longer than 8000 characters." / "„…“: description longer than 200 characters." / "„…“: emoji longer than 4 characters." (Pflichtfeld leer oder Länge überschritten) | ein Pflichtfeld ist leer oder eine Grenze überschritten | das Feld ausfüllen oder kürzen |
| "„…“: name missing or longer than 60 characters." / "„…“: text missing." / "„…“: text longer than 4000 characters." (Skill-Name oder -Text leer oder zu lang) | Skill-Name oder Skill-Text leer oder zu lang | ausfüllen oder kürzen |
| "Memory is limited to 4000 characters." (Memory auf 4.000 Zeichen begrenzt) | die Notiz ist zu lang | kürzen |
| "Unknown agent for this skill." (unbekannter Agent) | der zugeordnete Agent existiert nicht mehr oder steht Ihnen nicht zur Verfügung | einen anderen Agent wählen oder Kein Agent |
| "Speichern fehlgeschlagen." / "Speichern fehlgeschlagen: …" / "Löschen fehlgeschlagen." | die Anfrage ist fehlgeschlagen | erneut versuchen |
| Der Agent oder Skill erscheint nicht im anderen Produkt | Ihre eigenen Agents, Skills, Memory und Verläufe sind in Jira und Confluence dieselben — fehlt etwas, ist das Produkt nicht mit der App verbunden oder die Konfiguration konnte nicht geladen werden | Seite neu laden oder die Administration fragen; den Agent nicht erneut anlegen, er würde gegen Ihr Limit von 5 zählen |
Ein Platzhalter wie {{Projét}} wird nicht abgefragt | Platzhalter erlauben nur die Buchstaben A–Z/a–z, die Umlaute ä ö ü Ä Ö Ü, ß, Ziffern, Leerzeichen, Punkte, Bindestriche und Unterstriche (bis zu 40 Zeichen) | den Platzhalter umbenennen |
Meldungen in der Administration
Speichern und Validierung
Diese englischen Meldungen erscheinen neben dem Knopf Speichern, wenn ein Speichern abgelehnt wird. Speichern auf Module und Allgemein speichert die gesamte Konfiguration, einschließlich der auf Verbindungen bearbeiteten, aber noch nicht gespeicherten Verbindungskarten.
| Meldung | Ursache | Lösung |
|---|---|---|
| "Speichern fehlgeschlagen." | Validierung oder Speichern fehlgeschlagen; der genaue Grund folgt | die Eingaben prüfen |
| "Konfiguration konnte nicht geladen werden: …" (roter Hinweis über den Reitern) | die Konfiguration konnte nicht gelesen werden | Seite neu laden |
| "Add at least one connection." (mindestens eine Verbindung anlegen) | es ist keine Verbindung angelegt | mindestens eine Verbindung anlegen |
| "„…“: name missing or longer than 40 characters." (Name fehlt oder ist zu lang) | Verbindungsname leer oder zu lang | den Namen kürzen |
| "„…“: endpoint must use https://." / "„…“: endpoint is not a valid URL." / ""…": endpoint must be a valid https URL." (Adresse fehlerhaft) | die Adresse ist fehlerhaft | die vollständige https-Adresse eintragen, z. B. https://llm.meine-firma.de/v1 |
| "„…“: specify at least one model." / "„…“: at most 20 models." / "„…“: invalid model name „…“" (Modellliste fehlerhaft) | kein Modell, zu viele Modelle oder ein Name mit unzulässigen Zeichen (erlaubt: Buchstaben, Ziffern, . - _ / :, bis zu 100 Zeichen) | die Modellliste korrigieren |
| ""…": API key seems too short (at least 8 characters)." (API-Key zu kurz) | der eingetragene Key ist zu kurz | den vollständigen Key einfügen |
| "Default model must belong to one of the connections." (Default-Modell gehört zu keiner Verbindung) | das Default-Modell verweist auf eine entfernte Verbindung | ein Modell einer gespeicherten Verbindung wählen |
| "Site knowledge must be text with at most 4000 characters." (Site-Wissen zu lang) | der Text ist zu lang | kürzen |
| "At most 8 agents." / "„…“: instructions longer than 8000 characters." (höchstens 8 Agents; Anweisungen zu lang) | Site-Agents: Obergrenze erreicht oder Anweisungen zu lang | einen Agent entfernen oder die Anweisungen kürzen |
| "At most 30 prompts." / "„…“: text longer than 4000 characters." / ""…": skill references an unknown agent — save the agent first." (höchstens 30 Vorlagen; Text zu lang; der Skill verweist auf einen nicht gespeicherten Agent) | Vorlagen: Obergrenze erreicht, Text zu lang oder der Skill zeigt auf einen noch nicht gespeicherten Agent | eine Vorlage entfernen, kürzen oder den Agent zuerst auf Agents speichern |
| "Web search: endpoint must use https://." / "Web search: an endpoint is required to enable it." / "Web search key seems too short (at least 8 characters)." (Web-Suche unvollständig) | die Einstellungen der Web-Suche sind unvollständig | Adresse oder Key ergänzen — Web-Suche und Bild-Generierung aktivieren |
| "API-Key gelöscht — Verbindung ist deaktiviert, bis ein neuer Key gespeichert wird." | Sie haben Wirklich löschen? bestätigt | bei Bedarf einen neuen Key eintragen und speichern |
| "Löschen fehlgeschlagen." / "Connection not found." (Verbindung nicht gefunden) | der Key konnte nicht gelöscht werden | neu laden und erneut versuchen |
Endpoint-Freigaben
| Meldung | Ursache | Lösung |
|---|---|---|
| "Netzfreigabe für … wurde abgelehnt oder ist fehlgeschlagen — es wurde nichts gespeichert." (oder "… (Code …) — es wurde nichts gespeichert.") | der Bestätigungsdialog von Atlassian wurde beim Speichern abgelehnt oder abgebrochen | erneut speichern und den Dialog bestätigen |
| "Diese Endpoint-Domains sind konfiguriert, aber für diese Installation noch nicht freigegeben: …" (gelber Hinweis auf jeder Einstellungsseite) | die Freigabe fehlt — typisch nach einem Konfigurations-Import | Jetzt freigeben klicken und den Dialog bestätigen |
| "Freigabe wurde abgelehnt oder ist fehlgeschlagen — diese Domains bleiben blockiert. Die Konfiguration ist unverändert." | der Dialog wurde abgelehnt | erneut versuchen |
| "Customer-managed Egress ist für diese Installation nicht verfügbar — diese Domains bleiben blockiert, bis es freigeschaltet ist." / "Gespeichert, aber die Netzfreigabe konnte nicht angefragt werden — …" | die Freigabefunktion von Atlassian ist für diese Installation nicht verfügbar; die Konfiguration ist gespeichert, aber jede Adresse bleibt blockiert | den Hersteller maplee über Ihre Administration kontaktieren |
| "Anfragen an … wurden in … geblockt, obwohl die Adresse als freigegeben erscheint. …" und Zellen blockiert <Datum> in Freigabe-Status je Produkt | die Zustimmung der Administration fehlt in diesem Produkt — die Domain-Liste wird installationsweit angezeigt, die Zustimmung zählt aber je Produkt | Freigabe in diesem Produkt erneuern klicken und den Dialog bestätigen. Auch ein erfolgreiches Verbindung testen in diesem Produkt löscht den Eintrag; normale Chat-Anfragen nicht |
| "Endpoint-Freigaben dürfen nur Jira-Administrator:innen ändern. Ihr Konto hat keine Jira-Admin-Berechtigung — die Aktionen auf dieser Seite sind deaktiviert." | Sie haben die Confluence-Einstellungsseite ohne Jira-Admin-Rechte geöffnet | eine:n Jira-Administrator:in bitten oder die Einstellungen in Jira öffnen |
| "Ihre Jira-Admin-Berechtigung ließ sich aus Confluence nicht prüfen — die Aktionen bleiben nutzbar. …" | die Prüfung ist fehlgeschlagen; die Aktionen bleiben nutzbar | fortfahren oder die Jira-Einstellungsseite verwenden |
| "Das Limit von 10 freigegebenen Domains ist erreicht. …" / "Atlassian erlaubt höchstens 10 freigegebene Domains pro Installation. …" | höchstens 10 freigegebene Domains je Installation | eine nicht genutzte Adresse mit Entziehen entfernen oder Ersetzen nutzen |
| "Nur https ist erlaubt — über diese Verbindung gehen API-Keys." / "Keine gültige URL." / "Diese Domain ist bereits freigegeben." | die eingegebene Adresse ist ungültig oder bereits freigegeben | die Adresse korrigieren |
| "Entziehen fehlgeschlagen — die Freigabe besteht weiter." / "Erneuern fehlgeschlagen oder abgelehnt — nichts geändert." | die Aktion wurde abgelehnt oder ist fehlgeschlagen | erneut versuchen |
Verbindungstest
| Meldung | Ursache | Lösung |
|---|---|---|
| "Verbindung ok — … Modell(e) am Endpoint." / "Verbindung ok." mit "Für diesen Key sichtbar: …" | der Test war erfolgreich | — |
| "Nicht in der Liste (kann trotzdem funktionieren): …" (rot dargestellt, obwohl der Test erfolgreich war) | ein konfigurierter Modellname wurde vom Dienst nicht gemeldet | nicht zwingend ein Fehler — das Modell im Chat testen |
| "Test fehlgeschlagen." gefolgt vom Grund | siehe die folgenden Zeilen | |
| "Endpoint rejects the API key (401/403)." (Key abgelehnt) | Key falsch oder abgelaufen | den Key erneuern |
| "Endpoint responded with HTTP …" (der Dienst meldet einen Fehler) | der Dienst meldet einen Fehler | Adresse, Provider-Typ und Kontingent prüfen |
| "Timeout after 10s." (Zeitüberschreitung) | der Dienst hat nicht rechtzeitig geantwortet | die Erreichbarkeit prüfen |
| "Connection failed: … This endpoint needs a network approval: check that an administrator has approved it under Settings → Endpoint approvals." (Verbindung fehlgeschlagen; der Endpoint braucht eine Netzfreigabe) | die Adresse ist nicht erreichbar oder nicht freigegeben | Endpoint-Freigaben verwalten |
| "Der Request wurde innerhalb von Atlassian geblockt, bevor er … erreicht hat — der Endpoint ist in … noch nicht freigegeben. …" | die Freigabe fehlt in diesem Produkt; der Test hinterlegt einen Eintrag blockiert | freigeben oder Freigabe in diesem Produkt erneuern |
| "Connection not found — please save first." / "No API key saved — please set a key and save." (Verbindung noch nicht gespeichert bzw. ohne Key) / "Neu — Test nach dem Speichern möglich." | die Verbindung ist noch nicht gespeichert oder hat keinen Key | zuerst speichern, dann testen |
Meldungen bei Web-Suche und Bild-Generierung
| Meldung | Ursache | Lösung |
|---|---|---|
| "Web search is not enabled." (Web-Suche nicht aktiviert) | die Web-Suche ist abgeschaltet | Administration: Web-Suche und Bild-Generierung aktivieren |
| "Web search has no endpoint configured." / "Web search has no API key configured." (Adresse bzw. Key fehlt) | das Häkchen ist gesetzt, aber Adresse oder Key fehlt | die Administration vervollständigt die Einstellungen |
| "Web search rejects the API key (401/403)." (Key abgelehnt) | der Key ist falsch, abgelaufen oder wurde durch einen Wechsel des Dienstes oder der Adresse verworfen | einen neuen Key eintragen |
| "Web search rate limit reached (429)." (Kontingent des Such-Dienstes erschöpft) | das Kontingent des Such-Dienstes ist erschöpft | das Kontingent beim Anbieter prüfen |
| "Web search timed out after 30s." (Zeitüberschreitung) | der Such-Dienst hat nicht rechtzeitig geantwortet | Erreichbarkeit und Freigabe prüfen; bei SearXNG zusätzlich das JSON-Ausgabeformat |
| "Web search failed: …" mit einem Hinweis auf eine Netzfreigabe | die Such-Adresse ist nicht freigegeben | Endpoint-Freigaben verwalten |
| Die KI sucht nie im Web | das Werkzeug wird nicht angeboten, weil die Web-Suche aus ist oder Adresse bzw. Key fehlt | Administration |
| "Image generation is not enabled." / "Image connection not configured." (Bild-Generierung aus bzw. kein Bild-Modell) | die Bild-Generierung ist aus oder kein Bild-Modell ist ausgewählt | Administration |
| "The configured image connection type does not support image generation." (Verbindungstyp unterstützt keine Bilder) / die KI erzeugt nie Bilder | das Bild-Modell gehört zu einer Anthropic-Verbindung — es wird dann stillschweigend nicht angeboten | ein Bild-Modell an einer OpenAI-kompatiblen oder Azure-OpenAI-Verbindung verwenden |
| "Image endpoint responded with HTTP …" (der Dienst meldet einen Fehler) | der Dienst meldet einen Fehler | Modellname und Kontingent prüfen |
| "Image endpoint returned no URL (b64-only is not supported)." (keine Bild-URL geliefert) | der Dienst liefert das Bild in einer nicht unterstützten Form | ein anderes Bild-Modell wählen |
| Ein Bild-Link funktioniert nicht mehr | Bild-Links der Anbieter sind oft nur kurz gültig | das Bild erneut erzeugen und zügig herunterladen |
Meldungen im Dashboard-Gadget
| Meldung | Ursache | Lösung |
|---|---|---|
| "Noch nicht konfiguriert — über „Bearbeiten" eine Frage hinterlegen." | keine Frage gespeichert | den Bearbeiten-Modus des Gadgets öffnen und eine Frage eingeben |
| "Bitte eine Frage eingeben." | das Feld war beim Speichern leer | eine Frage eingeben |
| "Speichern fehlgeschlagen." | die Gadget-Konfiguration konnte nicht gespeichert werden | erneut versuchen |
| "Noch keine Antwort — „↻ Aktualisieren" klicken." | es wurde noch keine Antwort erzeugt | ↻ Aktualisieren klicken |
| "Gadget konnte nicht geladen werden." | die App-Konfiguration war nicht abrufbar | das Dashboard neu laden |
| "Aktualisierung fehlgeschlagen." / "Fehler." | die Anfrage konnte nicht gestartet werden oder endete mit einem unbestimmten Fehler | erneut ↻ Aktualisieren klicken; bei Wiederholung Administration |
| "Keine Antwort vom Stream — bitte erneut versuchen." | 60 Sekunden lang kamen keine Daten | erneut aktualisieren |
| "Streaming currently unavailable." (Streaming derzeit nicht verfügbar) | das Gadget kann nur streamen | später erneut versuchen |
| "Hourly limit reached (… requests/hour) — please try again later." (Stundenlimit erreicht) | das persönliche Limit der Person, die ↻ Aktualisieren geklickt hat | warten |
| "Not configured yet — …" / "The AnyLLM subscription for this site is inactive …" (Server-Meldungen) / "Diese Funktion wurde von deinem Administrator deaktiviert." | Administration nötig | siehe Die App startet nicht oder ist gesperrt |
Häufige Fehlkonfigurationen und Abhilfe
| Symptom | Wahrscheinliche Ursache | Abhilfe |
|---|---|---|
| Nutzer:innen sehen Noch nicht eingerichtet, obwohl Verbindungen existieren | keine Verbindung hat einen hinterlegten API-Key | den Key eintragen und speichern — LLM-Verbindungen einrichten |
| Der Chat funktioniert in Jira, aber nicht in Confluence | der Endpoint ist in Confluence nicht freigegeben, oder Confluence ist nicht mit der App verbunden | den Endpoint auf der Confluence-Einstellungsseite freigeben; fehlt die App in Confluence, Confluence in der Atlassian-Administration zur Installation hinzufügen (Jira ist das Pflichtprodukt; Confluence kommt danach hinzu) |
| Nach einem Konfigurations-Import scheitert jede Anfrage | die Netzfreigabe für die importierte Adresse fehlt | Jetzt freigeben im gelben Hinweis klicken — Endpoint-Freigaben verwalten |
| Ein Modell wird nicht gefunden | der Modellname weicht vom Namen beim Dienst ab | Verbindung testen zeigt die sichtbaren Modellnamen |
| Nutzer:innen bekommen das erste Modell statt des Default-Modells | das Default-Modell gehört zu einer Verbindung ohne Key oder wurde entfernt | ein Default-Modell wählen, dessen Verbindung einen Key hat — Allgemeine Einstellungen |
| Antworten sind spürbar langsam | ein Modell mit interner Überlegungsphase | ein anderes Default-Modell wählen |
| Antworten brechen ohne Text ab | das Antwort-Budget ist für ein Reasoning-Modell zu klein | Nutzer:innen: Max. Antwort-Tokens erhöhen oder in ⚙ Modell-Parameter … auf Zurücksetzen klicken |
| Nutzung bleibt leer | der KI-Dienst liefert in seinen Streaming-Antworten keine Token-Verbrauchswerte | beim Anbieter nachfragen, ob seine Streaming-API Verbrauchswerte (usage) zurückgibt — Nutzungsstatistik, Import/Export und Sicherung |
| Die Web-Suche funktioniert nicht | die Adresse ist nicht freigegeben, der Key fehlt oder wurde durch einen Wechsel des Dienstes oder der Adresse verworfen | Web-Suche und Bild-Generierung aktivieren |
| Die Bild-Generierung wird nie angeboten | das Bild-Modell liegt an einer Anthropic-Verbindung | es an eine OpenAI-kompatible oder Azure-OpenAI-Verbindung verlegen |
| Nutzer:innen sehen abgeschaltete Flächen weiterhin im Menü | Plattformverhalten — Menüeinträge lassen sich nicht je Installation ausblenden | erwartet; siehe Module |
| Die Chat-Leiste bleibt nach einer Änderung eine Weile sichtbar oder verborgen | ihr Status wird 10 Minuten lang im Browser zwischengespeichert | warten oder die Website-Daten löschen |
| Die Einstellungen lassen sich nicht öffnen | fehlende Administrationsrechte | die Rechte im Produkt prüfen |
| Die Freigabe-Aktionen sind auf der Confluence-Einstellungsseite deaktiviert | keine Jira-Admin-Berechtigung | ein Jira-Administrator-Konto verwenden |
Was Sie im Zweifel zurückholen können
- Konfiguration: regelmäßig ↓ Als JSON exportieren (Import/Export). Der Export enthält alles außer den API-Keys — Nutzungsstatistik, Import/Export und Sicherung.
- API-Keys: lassen sich nicht auslesen. Bewahren Sie sie dort auf, wo Sie sie ohnehin verwalten.
- Unterhaltungen und Memory: liegen bei den einzelnen Personen und lassen sich weder zentral sichern noch wiederherstellen. Wer einen Chat dauerhaft behalten will, archiviert ihn nach Confluence — Verläufe verwalten.
Support kontaktieren
Wenden Sie sich zuerst an Ihre eigene Produkt-Administration — sie kann Verbindungen, Freigaben und Einstellungen einsehen. Muss die Administration weiter eskalieren, ist der Hersteller der App maplee; fragen Sie Ihre Administration nach den vereinbarten Support-Wegen. Dieses Handbuch nennt bewusst keine Adressen oder Reaktionszeiten.
Diese Angaben helfen — und sind unbedenklich:
- das Produkt (Jira oder Confluence) und wo genau Sie waren (z. B. „Vorgangs-Panel", „Chat-Leiste", „Dashboard-Gadget")
- die Meldung im Wortlaut
- die Uhrzeit mit Zeitzone
- was Sie getan haben, bevor es auftrat
- ob es reproduzierbar ist und ob es andere ebenfalls betrifft
- ob es in beiden Produkten auftritt
Bitte niemals mitschicken: API-Keys, Passwörter, Tokens, vollständige Chat-Inhalte mit vertraulichen Daten oder personenbezogene Daten Dritter. Für die Diagnose genügen Meldung, Zeitpunkt und Fläche.
Verwandte Themen
- Häufige Fragen (FAQ) — häufige Fragen für Nutzer:innen und Administrator:innen
- Berechtigungen, Rollen und Datensichtbarkeit — wer darf was und wer sieht was
- Mit der KI chatten · Verläufe verwalten · Eigene Agents und Skills anlegen
- Die KI in Jira und Confluence suchen, lesen und erstellen lassen — Vorschlagskarten
- AnyLLM in Confluence · AnyLLM in Jira · Dashboard-Gadget (AI-Report)
- LLM-Verbindungen einrichten · Endpoint-Freigaben verwalten · Allgemeine Einstellungen · Module
- Lizenz, Datenhaltung und automatische Löschung
Aufnahmen der App-Oberfläche mit Beispieldaten; der umgebende Jira-/Confluence-Rahmen ist nicht abgebildet.
Dokumentationsstand: App-Version 0.2.0 · 2026-08-30