Websuche¶
Websuche für „Inovetra AI" (ab Chart 0.81.67)
Der allgemeine Chat-Assistent Inovetra AI kann optional im Internet nach aktuellen Informationen suchen. Die Funktion ist standardmäßig deaktiviert und wird über einen einzigen Schalter im Customer Portal aktiviert. Der Wissensassistent Inovetra RAG bleibt davon unberührt und arbeitet weiterhin ausschließlich dokumentenbasiert.
Beteiligte Komponenten¶
| Komponente | Typ | Zweck | Betrieb |
|---|---|---|---|
| SearXNG | Deployment (inovetra-searxng) |
Selbst-gehostete Meta-Suchmaschine — liefert Trefferlisten | on-demand (replicas 0 ↔ 1) |
| web-scraper | Deployment (inovetra-web-scraper) |
Inhaltsabruf der gefundenen Seiten (Firecrawl-kompatibel, FastAPI + httpx + trafilatura) | on-demand (replicas 0 ↔ 1) |
| LibreChat | Deployment | Bindet die Websuche im Chat-Assistenten ein (interface.webSearch) |
dauerhaft |
| Customer API | Deployment | Steuert Toggle, Scaling und Spiegelung nach LibreChat | dauerhaft |
web-scraper — Eckdaten
Der web-scraper (v0.1.2) ruft ausgewählte Webseiten ab und extrahiert den Textinhalt. Er rendert kein JavaScript und liefert daher die besten Ergebnisse bei textbasierten Seiten. Er besitzt SSRF-Schutz und ist über NetworkPolicies abgesichert.
Datenfluss¶
flowchart LR
subgraph Instanz["Kunden-Instanz (inovetra-platform)"]
LC["LibreChat\nInovetra AI"]
SX["SearXNG\n(on-demand)"]
WS["web-scraper\n(on-demand)"]
end
subgraph Internet["Internet (Egress 80/443)"]
SE["Externe\nSuchmaschinen"]
WEB["Webseiten"]
end
LC -->|"Suchbegriff"| SX
SX -->|"Meta-Suche"| SE
LC -->|"Inhaltsabruf"| WS
WS -->|"HTTP GET"| WEB
Daten verlassen die Instanz
Bei aktivierter Websuche werden Suchbegriffe an externe Suchmaschinen (via SearXNG) übermittelt und ausgewählte Webseiten über den web-scraper abgerufen (Internet-Egress über Ports 80/443). Die Aktivierung ist daher eine bewusste Administrator-Entscheidung mit Datenschutz-Relevanz.
Aktivieren / Deaktivieren¶
Die Steuerung erfolgt über einen einzigen Schalter im Customer Portal:
- Customer Portal → KI-Einstellungen öffnen
- Schalter Websuche umlegen (Ein/Aus)
- Speichern — die Customer API (
PATCH /rag/settings) übernimmt alle weiteren Schritte automatisch
Standard: deaktiviert
Die Websuche ist nach der Installation und nach jedem Update standardmäßig ausgeschaltet. Sie muss aktiv eingeschaltet werden.
Was beim Einschalten technisch passiert¶
| Schritt | Aktion |
|---|---|
| Scaling | Customer API skaliert inovetra-searxng und inovetra-web-scraper von replicas 0 → 1 |
| LibreChat-Spiegelung | interface.webSearch wird live in der ConfigMap inovetra-chat-config gesetzt und in inovetra-user-settings persistiert; die LibreChat-Pods werden neu erstellt |
| rag-api | wird NICHT neu gestartet (siehe Hinweis unten) |
Beim Ausschalten wird der Vorgang umgekehrt: beide Deployments werden auf replicas 1 → 0 herunterskaliert und interface.webSearch deaktiviert.
Kein rag-api-Neustart durch den Websuche-Toggle
Das Umlegen des Websuche-Schalters löst keinen Rollout der rag-api aus. Nur ein Wechsel des KI-Modellanbieters oder des Embedding-Modus startet die rag-api neu (siehe LLM-Modelle).
Inovetra RAG bleibt dokumentenbasiert¶
Wissensassistent sucht bewusst NICHT im Web
Der Wissensassistent Inovetra RAG nutzt die Websuche nicht. Der frühere Web-Fallback der RAG-API wurde vollständig entfernt. Findet der Assistent keine passenden Unternehmensdokumente, antwortet er ehrlich mit einem Hinweis wie „keine Informationen in den Dokumenten" — statt zu raten. Dies ist für das Erwartungsmanagement im Support relevant.
Siehe auch¶
- Komponenten — Komponentenübersicht inkl. SearXNG und web-scraper
- LLM-Modelle — KI-Modellanbieter und rag-api-Neustarts
- Runbook Websuche — Troubleshooting der Websuche
- Netzwerk und Kommunikation — Egress und interne DNS-Namen