Zum Inhalt

Runbook Websuche

Runbook: Websuche

Diagnose und Behebung von Problemen mit der Websuche für Inovetra AI (SearXNG + web-scraper). Voraussetzungen: Chart ≥ 0.81.67. Alle Befehle im Namespace inovetra-platform.

Erwartetes Verhalten

Die Websuche ist on-demand: Die Deployments inovetra-searxng und inovetra-web-scraper laufen nur bei aktivierter Websuche.

kubectl get deployment inovetra-searxng inovetra-web-scraper -n inovetra-platform
Websuche-Schalter Erwarteter Zustand
Aus (Standard) beide Deployments 0/0 — kein Fehler, gewollt
Ein beide Deployments 1/1, Pods Running

0/0 ist kein Defekt

Wenn die Websuche ausgeschaltet ist, ist READY 0/0 der Normalzustand und spart Ressourcen. Erst beim Einschalten skaliert die Customer API auf 1.

Schalter ist an, aber kein Globus / keine Ergebnisse

Symptom: Im Chat erscheint kein Websuche-Globus oder es kommen keine Web-Ergebnisse, obwohl der Schalter aktiviert wurde.

Diagnose:

# Laufen beide Deployments?
kubectl get pods -n inovetra-platform -l 'app in (inovetra-searxng,inovetra-web-scraper)'

# Falls Pods nicht Running:
kubectl describe pod <pod-name> -n inovetra-platform | grep -A10 "Events"

Häufige Ursachen & Lösungen:

  • Deployments noch auf 0 → Schalter im Customer Portal (KI-Einstellungen → Websuche) erneut aus- und einschalten; die Customer API skaliert dann auf 1.
  • ImagePullBackOff / ErrImagePull → das Pull-Secret hat keinen Zugriff auf das web-scraper-Package. GitHub-PAT (Scope read:packages) prüfen bzw. erneuern, siehe Runbook Pod-Fehler: 
    kubectl describe pod <web-scraper-pod> -n inovetra-platform | grep -A10 "Events"
  • LibreChat hat die Konfiguration nicht übernommen → die LibreChat-Pods müssen nach dem Einschalten neu erstellt worden sein: 
    kubectl get configmap inovetra-chat-config -n inovetra-platform -o yaml | grep -i websearch
kubectl get pods -n inovetra-platform -l app=librechat

Verifikation: Beide Deployments 1/1, Pods Running, Globus im Chat sichtbar.

web-scraper liefert bei manchen Seiten keinen Inhalt

Symptom: Die Websuche funktioniert grundsätzlich, einzelne Seiten liefern aber keinen oder leeren Inhalt.

Ursache: Der web-scraper rendert kein JavaScript. Bei stark JavaScript-getriebenen Seiten (Single-Page-Apps, Inhalte die erst clientseitig nachgeladen werden) kann kein Text extrahiert werden.

Maßnahme: Kein Defekt — erwartetes Verhalten. Der Assistent nutzt die übrigen Treffer. Textbasierte Seiten liefern die besten Ergebnisse.

„Inovetra RAG" sucht nicht im Web

Symptom: Anwender erwarten, dass der Wissensassistent Inovetra RAG Informationen aus dem Internet zieht, bekommen aber nur dokumentenbasierte Antworten.

Ursache: Ab Chart 0.82.13 kann Inovetra RAG im Web recherchieren — aber nur bei aktiviertem Globus-Symbol in der Unterhaltung. Ist es aus, bleibt er strikt dokumentenbasiert (beabsichtigt).

Prüfen:

kubectl logs -n inovetra-platform deploy/inovetra-rag-api | grep WebSearch
Logzeile Bedeutung
[WebSearch] toggle=False Globus war nicht aktiv — Anwender auf das Symbol hinweisen
[WebSearch] SearXNG nicht erreichbar SearXNG läuft nicht (siehe Scaling-Abschnitte oben)
[WebSearch] Relevanzfilter: 0 von N Treffern behalten Treffer thematisch zu weit weg — Schwellwert senken

Maßnahme: Erwartungsmanagement — die Websuche muss vom Administrator freigeschaltet und vom Anwender pro Unterhaltung aktiviert sein. Siehe Websuche.

Web-Treffer sind thematisch unpassend

Symptom: Unter den 🌐 Web-Quellen erscheinen fachfremde Seiten (z. B. Wörterbücher oder Hersteller-Dokumentation anderer Produkte).

Ursache: Der Relevanzfilter bewertet Treffer per Cross-Encoder gegen die Frage. Der Schwellwert ragApi.webSearch.minRelevance (Default -2.0) sortiert offensichtlich Themenfremdes aus, selektiert aber bewusst nicht scharf.

Maßnahme: Schwellwert anheben — ohne Image-Rebuild möglich:

helm upgrade ai-platform oci://ghcr.io/inovetra/ai-platform \
  -n inovetra-platform \
  --reuse-values --set ragApi.webSearch.minRelevance="0.0" --timeout 15m

Fallen umgekehrt brauchbare Treffer weg, den Wert senken (z. B. -4.0).

Siehe auch