Licensed to be used in conjunction with basebox, only.
// integration
Websuche
Gilt für
Produkt: Cloud · Server · Zielgruppe: Administrator · Platform Operator
Der Konnektor Websuche lässt den basebox-Assistenten das öffentliche Web in Echtzeit abfragen. Das Standard-Such-Backend ist Staan – der europäische Suchindex von Qwant und Ecosia (European Search Perspective, Paris): ein unabhängiger EU-Index mit EU-Datenverarbeitung, ausgelegt auf DSGVO-orientierte Deployments. Ein auf DuckDuckGo basierender Konnektor bleibt als Alternative verfügbar.
Wann einsetzen
Aktivieren Sie die Websuche, wenn Nutzer Antworten brauchen, die von aktuellen, öffentlichen Informationen abhängen – zum Beispiel:
- aktuelle Nachrichten und Ankündigungen,
- Produkt- oder Anbieterrecherchen,
- öffentliches Referenzmaterial, das nicht in Ihrem internen Wiki oder RAG-Korpus liegt.
Ist Ihr Anwendungsfall rein intern (z. B. klinische SOPs, interne Dokumentation), brauchen Sie die Websuche in der Regel nicht – nutzen Sie stattdessen DokuWiki oder eine RAG-App.
Konfiguration
Auf der Seite Admin → Konnektoren:
- Suchen Sie Staan Search (European).
- Schalten Sie ihn ein.
- Tragen Sie optional einen Staan-API-Schlüssel ein.
Der API-Schlüssel ist optional. Bleibt das Feld leer, laufen Suchen über das gemeinsame basebox-Staan-Konto (basebox-Kontingent). Tragen Sie den eigenen API-Schlüssel Ihrer Organisation aus der Staan-Konsole ein, um auf Ihrem eigenen Abonnement und Kontingent zu laufen – empfohlen für den Produktiveinsatz. Ein von Staan abgelehnter Schlüssel erzeugt einen expliziten Fehler; es gibt nie einen stillen Rückfall auf das basebox-Konto.
Firewall-/Egress-Anforderungen
Beschränkt Ihr Deployment ausgehenden Verkehr, benötigt der Websuche-Konnektor die folgenden Hosts in der Kunden-Firewall (nur ausgehendes HTTPS):
| Konnektor | Erforderliche ausgehende Hosts (TCP 443) |
|---|---|
| Staan Search (Standard) | api.staan.ai |
| DuckDuckGo (Alternative) | duckduckgo.com, html.duckduckgo.com, lite.duckduckgo.com |
Das ist die vollständige Liste je Konnektor: Der Staan-Konnektor spricht nur mit der Staan-API – er ruft nie selbst Webseiten ab (auch der Modus „detailed" für Seiteninhalte wird von der API bedient), sodass kein weiterer ausgehender Zugang nötig ist. basebox erzwingt das zusätzlich als Egress-Allowlist am MCP-Gateway: Der Konnektor-Container kann keinen anderen als die oben genannten Hosts erreichen, selbst wenn er es versuchte.
Suchfunktionen
- Sprachen/Märkte: Der Staan-Index konzentriert sich auf Englisch, Deutsch und Französisch; der Assistent kann je Anfrage eine Sprache (
en,de,fr) oder einen vollständigen Marktcode (z. B.en-gb) übergeben. - Kurz- und Detailmodus: Der Kurzmodus (Standard, schnell) liefert Titel, URLs und Snippets; der Detailmodus liefert zusätzlich den Seiteninhalt jedes Treffers als Markdown, serverseitig von der Staan-API abgerufen und in der Größe begrenzt.
- Zusätzliche Snippets: optional neu gewichtete Inhaltspassagen je Treffer – ein günstigerer Mittelweg zwischen kurz und detailliert.
Die Websuche ist standardmäßig aus und startet in jeder neuen Unterhaltung ausgeschaltet – ihre Aktivierung ist jedes Mal eine bewusste Entscheidung. Vor der ersten Suche in einer Unterhaltung fragt basebox nach der Zustimmung des Nutzers. Die Websuche lässt sich außerdem für eine gesamte Installation ein- oder ausschalten.
Datenschutzhinweise
- Anfragen werden an den Suchanbieter gesendet – sie verlassen Ihr basebox-Deployment. Bei Staan werden sie in EU-Rechenzentren von einem EU-Unternehmen verarbeitet (EUSP, Paris; ein AVV ist verfügbar, und EU-only-Routing kann beim Anbieter angefordert werden).
- Anfragen verlassen das System über die eigene Verbindung von basebox; keine basebox-Nutzeridentität und keine Nutzer-IP-Adresse wird mit der Anfrage gesendet.
- basebox protokolliert den Text von Anfragen nicht; das Audit-Log hält nur Metadaten fest (siehe Einführung in die Websuche-Sicherheit).
- In einer vollständig abgeschotteten Umgebung funktioniert die Websuche nicht.
Einschränkungen
- Der Staan-Index ist jung (der gemeinsame europäische Index startete 2025, der deutsche Index 2026) und konzentriert sich auf Englisch, Deutsch und Französisch; die Abdeckung anderer Sprachen und sehr seltener Inhalte kann begrenzt sein. Wo der EU-Index dünn ist, kann der Anbieter Ergebnisse aus einem Nicht-EU-Backend ergänzen – dieser Rückfall lässt sich für streng souveräne Deployments auf Anfrage beim Anbieter abschalten.
- Die API liefert bis zu 10 Treffer je Anfrage.
- Es gelten die Ratenlimits und Kontingente des genutzten Staan-Tarifs (gemeinsames basebox-Konto oder der Tarif Ihres eigenen Schlüssels).