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) |
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 hat keinen Web-Fallback mehr (ab Chart 0.81.67) | Der Wissensassistent sucht nicht im Internet; ohne passende Dokumente antwortet er „keine Informationen in den Dokumenten" | Beabsichtigt — Websuche steht nur Inovetra AI zur Verfügung; 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