Bekannte Einschränkungen¶
Bekannte Einschränkungen
Dokumentierte Limitierungen der Inovetra AI Platform mit Auswirkungen, Workarounds und aktuellem Status.
Übersicht¶
| Einschränkung | Auswirkung | Workaround | Status |
|---|---|---|---|
| local-path StorageClass unterstützt keine dynamische PVC-Erweiterung | PVCs können nicht ohne Datenmigration vergrößert werden | Backup → PVC löschen → neu erstellen → Restore | Bekannt |
| bcrypt muss Version 4.0.1 sein | bcrypt 5.x bricht passlib-Kompatibilität | In requirements.txt auf bcrypt==4.0.1 gepinnt |
Behoben |
| MongoDB StatefulSet kann bei Updates hängen | Update schlägt fehl, Pod startet nicht | kubectl delete statefulset --cascade=orphan dann Re-Deploy |
Bekannt |
| Helm Timeout bei großen Deployments | Installation bricht ab | --timeout 15m wird automatisch gesetzt |
Behoben |
| Network Policy Egress deaktiviert | Potentiell offene ausgehende Verbindungen | Egress nur aktivieren mit vollständigen Regeln | Design-Entscheidung |
| Nur AMD64-Images | ARM-basierte VMs werden nicht unterstützt | AMD64-VM verwenden | Design-Entscheidung |
| Embedding-Modell-Wechsel erfordert Neuindexierung | Alle Dokumente müssen neu verarbeitet werden | Modellwechsel planen, ausreichend Zeit einrechnen | Bekannt |
| Multi-Group-RAG-Filter lieferte vor Chart 0.73.3 keine Treffer | Benutzer mit mehreren Gruppen fanden Dokumente nicht, die Admins fanden | Update auf Chart ≥ 0.73.3 (RAG API ≥ v0.48.3) |
Behoben |
Konnektor-access_groups-Änderungen propagierten vor Chart 0.73.3 nicht auf bestehende Chunks |
Berechtigungsänderungen wurden gespeichert, wirkten aber nicht | Update auf Chart ≥ 0.73.3 (RAG API ≥ v0.48.3, Connector Service ≥ v0.10.1) |
Behoben |
| Konnektor-Löschen ließ Dokumente verwaist in Qdrant zurück | Vektorindex wächst durch geloeschte Konnektoren | Update auf Chart ≥ 0.73.3 und ggf. POST /documents/inventory/cleanup ausführen |
Behoben |
Vor Chart 0.76.0 ingestierte Connector-Dokumente haben keine web_url im Qdrant-Payload |
Im Source-Click-Viewer fehlt der Button „Originalquelle öffnen“ für alte Dokumente, obwohl Confluence/SharePoint/GitHub-Quellen vorliegen | Nach Update auf Chart ≥ 0.76.0 (RAG API ≥ v0.50.0, Customer Portal ≥ v0.59.2) pro Konnektor einmalig „Komplett neu synchronisieren“ im Customer Portal auslösen |
Behoben (Migration erforderlich) |
| SMB- und Confluence-Konnektor erkennen gelöschte Inhalte im Delta-Sync nicht | Im Quellsystem gelöschte Dateien bzw. Seiten bleiben bis zum nächsten Abgleich in der Wissensdatenbank (Qdrant) | Ab Chart 0.83.12 regelmäßig „Komplett neu synchronisieren“ auslösen — die Aktion gleicht mit der Quelle ab und entfernt nicht mehr gelistete Dokumente. Einzelne Dokumente lassen sich auch auf der Seite Dokumente im Customer Portal löschen |
Design-bedingt (kein zuverlässiges Änderungsjournal in der Quelle) |
| Konnektor-Löschungen und Ordnergrenzen vor Chart 0.83.12 | In GitHub/Bitbucket gelöschte, umbenannte oder verschobene Dateien blieben auffindbar; Konnektoren mit Ordnerpfad übernahmen teils Dateien außerhalb des Ordners (SharePoint-Delta-Sync, Ordner mit gleichem Namensanfang) | Update auf Chart ≥ 0.83.12 (RAG API ≥ v0.53.21, Connector Service ≥ v0.12.22), danach pro Konnektor einmalig „Komplett neu synchronisieren“ |
Behoben (Full-Sync erforderlich) |
| Fehler der RAG API bei Gruppenänderung und Konnektor-Löschung blieben vor Chart 0.83.12 unbemerkt | Geänderte Zugriffsgruppen wurden gespeichert, wirkten aber nicht; gelöschte Konnektoren hinterließen durchsuchbare Dokumente | Update auf Chart ≥ 0.83.12; das Customer Portal meldet den Fehler jetzt und speichert bzw. löscht nichts |
Behoben |
| Konnektoren waren vor Chart 0.82.37 nur eingeschränkt bearbeitbar | Nach dem Anlegen ließen sich nur Name, Beschreibung, Sync-Intervall und Zugriffsgruppen ändern; Angaben wie Ordnerpfad, Dateimuster oder Zugangsdaten erforderten Löschen und Neuanlegen — samt Verlust der Sync-Historie | Update auf Chart ≥ 0.82.37 (Customer Portal ≥ v0.61.60); der Bearbeiten-Dialog zeigt danach alle Felder der Ersteinrichtung |
Behoben |
| Gruppenänderung und Löschen erfassten vor Chart 0.83.19 bei sehr großen Dokumenten nicht alle Abschnitte | Teile eines großen Dokuments behielten nach einer Gruppenänderung die alten Zugriffsgruppen bzw. blieben nach dem Löschen auffindbar | Update auf Chart ≥ 0.83.19. Erreicht eine Gruppenänderung keinen Inhalt, meldet das Customer Portal jetzt „Zum Dokument wurden keine Chunks gefunden; Gruppen nicht geändert“ und ändert nichts |
Behoben |
| Chat-Antworten des Wissensassistenten brachen vor Chart 0.83.19 bei internen Fehlern ohne Meldung ab | Der Chat blieb nach „Generiere Antwort…“ ohne Text stehen | Seit 0.83.19 erscheint eine verständliche Meldung, z. B. „Bei der Antwortgenerierung ist ein Fehler aufgetreten. Bitte versuche es erneut. (Referenz: …)“, bei einer schon begonnenen Antwort der Hinweis, dass sie unterbrochen wurde. Tritt der Fehler wiederholt auf, die Referenz-ID an den Support geben |
Behoben |
| Hinweis „Live-Fortschritt derzeit nicht verfügbar“ beim Upload (ab Chart 0.83.19) | Die Fortschrittsanzeige aktualisiert sich nicht live, sondern alle paar Sekunden. Der Upload und die Verarbeitung laufen unverändert weiter | Kein Eingriff nötig; das Portal versucht die Live-Verbindung regelmäßig neu und blendet den Hinweis danach aus. Bleibt er dauerhaft, die Erreichbarkeit von /api/rag/ws/ über den Ingress prüfen (Runbook Netzwerk) |
Design-bedingt (Rückfall auf Abfrage) |
Gebrandete Wartungsseite (0.81.20) benötigt NetworkPolicy allow-maintenance |
Ohne diese Regel sehen Anwender während eines Updates rohe 502/503/504 statt der Wartungsseite | NetworkPolicy ist Teil des Helm Charts (ingress.maintenancePage.enabled, Standard aktiv); bei eigenen NetworkPolicy-Anpassungen erhalten |
Behoben (im Chart enthalten) |
| LibreChat-Wartungs-Redirect benötigt TLS-Sidecar | In einem offenen Chat-Tab erfolgt der Auto-Reload zur Wartungsseite nur, wenn der nginx-TLS-Sidecar aktiv ist (tls.enabled) |
tls.enabled aktiv lassen; ansonsten Nutzer einmalig manuell neu laden lassen |
Design-bedingt (SPA lädt Dokument nicht selbst neu) |
| web-scraper rendert kein JavaScript | Stark JavaScript-getriebene Seiten liefern bei der Websuche keinen oder leeren Inhalt | Textbasierte Seiten liefern die besten Ergebnisse; der Assistent nutzt die übrigen Treffer | Design-bedingt (httpx + trafilatura, kein Headless-Browser) |
| Inovetra RAG sucht nur bei aktiviertem Globus im Web (ab Chart 0.82.13) | Ohne Globus-Symbol antwortet der Wissensassistent rein dokumentenbasiert; ohne passende Dokumente „keine Informationen in den Dokumenten" | Beabsichtigt — der frühere automatische Web-Fallback bleibt entfernt, gesucht wird nur auf Nutzeraktion; siehe Websuche | Design-Entscheidung |
| --- |
Aktualität
Diese Liste wird bei jedem Release aktualisiert. Für aktuelle bekannte Probleme siehe die Release Notes der jeweiligen Version.
Weiterführende Seiten¶
- Troubleshooting Übersicht — Allgemeine Diagnoseschritte
- Updates und Upgrades — Release-Prozess und Update-Verfahren