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.

Ursache: Beabsichtigtes Verhalten. Inovetra RAG ist strikt dokumentenbasiert; der frühere Web-Fallback der RAG-API wurde entfernt. Findet der Assistent keine passenden Dokumente, antwortet er ehrlich mit „keine Informationen in den Dokumenten".

Maßnahme: Erwartungsmanagement — die Websuche steht nur dem allgemeinen Assistenten Inovetra AI zur Verfügung. Siehe Websuche.

Siehe auch