Anwendungseinstellungen

Die Anwendungseinstellungen ermöglichen es dir, das Verhalten deiner branchly-Anwendung, den Such-Retrieval-Modus, bevorzugte KI-Modelle und das Nutzertracking zu konfigurieren und anzupassen. Diese Einstellungen gewährleisten ein konsistentes, optimiertes Nutzererlebnis über alle Benutzeroberflächen hinweg.

Allgemein

Anwendungsname: Vergib einen Namen für deine Anwendung zur einfachen Identifizierung.
Website-Standort: Gib die exakten URLs ein, auf denen die Benutzeroberflächen eingebettet werden. Es können mehrere URLs angegeben werden, falls die Interfaces auf verschiedenen Seiten erscheinen sollen. Wichtig: Aus Sicherheitsgründen müssen alle Domains, auf denen deine Benutzeroberflächen eingebunden werden, hier hinterlegt sein. Wird ein Interface auf einer nicht gelisteten Domain geladen, schlägt die Initialisierung fehl oder es wird ein Fehler zurückgegeben, um unautorisiertes Embedding zu verhindern.
Sprache der Wissensbasis: Wähle Sprach- und Ländercode für die Inhalte deiner Wissensbasis. Für mehrsprachige Setups füge Kombinationen aus zweistelligen ISO-Sprach- und Ländercodes hinzu (z. B. en_US für Englisch/USA, de_DE für Deutsch/Deutschland).

Browsersprache verwenden: Wenn aktiviert, passen sich alle branchly-Interfaces – Chat-Widget, Such-Widget und jede eingebettete UI – automatisch dem Browser-Locale des Besuchers an. Dies beeinflusst zwei Aspekte gleichzeitig:

UI-Textlokalisierung — alle statischen Texte des Interfaces (Platzhalter in Eingabefeldern, Button-Beschriftungen, Hinweistexte/Disclaimer, Fragevorschläge und Fehlermeldungen) werden in der Sprache des Besuchers ausgeliefert. Übersetzungen für konfigurierte Locales werden serverseitig gespeichert und verwaltet; für Besucher mit einer Sprache, die du nicht explizit konfiguriert hast, generiert branchly beim ersten Besuch automatisch Übersetzungen und cacht diese für nachfolgende Anfragen.
Inhaltsabruf und KI-Antworten — branchly trennt das Inhalts-Locale (in welcher Sprache deiner indexierten Inhalte gesucht werden soll) von der Nutzersprache (in welcher Sprache geantwortet werden soll). Wenn das Browser-Locale eines Besuchers keinem deiner konfigurierten gültigen Locales entspricht, wechselt branchly zu einer multilingualen dichten semantischen Suche (Dense Search) – unter Umgehung des sprachspezifischen Keyword-Modells (BM25) – und weist die KI an, in der Sprache des Besuchers zu antworten, während die am nächsten liegenden verfügbaren Inhalte herangezogen werden.

Wie die Sprache ermittelt wird

Jede Anfrage transportiert zwei Signale: das Seiten-Locale (die Sprache der Seite, auf der das Widget eingebettet ist) und das Browser-Locale (die bevorzugte Sprache des Besuchers laut Browser). branchly gleicht diese wie folgt ab:

Browser-Locale des Besuchers	Inhalte abgerufen aus	KI antwortet auf
Stimmt mit einem deiner gültigen Locales überein (z. B. `en`, `de`)	Dem Seiten-Locale – Besucher befindet sich auf der passenden Sprachseite	Seiten-Locale
Stimmt mit keinem gültigen Locale überein (z. B. `ja` auf einer `de`/`en`-Seite)	Seiten-Locale als Fallback unter Nutzung multilingualer semantischer Suche	Browser-Locale – Best-Effort für nicht unterstützte Besucher
Nicht übermittelt	Seiten-Locale	Seiten-Locale

Wenn die Sprache eines Besuchers nicht zu deinen gültigen Locales gehört, nutzt branchly ausschließlich Dense Search (semantische Suche) anstelle der Hybridsuche. Der Grund: Keyword-basierter Abgleich (BM25) ist sprachspezifisch und liefert bei unterschiedlichen Schriftsystemen keine sinnvollen Ergebnisse (z. B. japanische Anfragen auf deutschen Inhalten). Multilinguale semantische Modelle liefern in solchen Fällen weiterhin aussagekräftige Ergebnisse.

Wann dieses Feature genutzt werden sollte

Deaktiviert (Standard) — Das Widget antwortet stets in der Sprache der Seite, auf der es sich befindet. Sicher und vorhersehbar. Empfohlen, wenn deine Zielgruppe dieselbe Sprache spricht wie deine Inhalte.

Aktiviert — Ermöglicht sprachübergreifende Antworten für Besucher, deren Browsersprache nicht zu deinen konfigurierten gültigen Locales gehört. Empfohlen, wenn deine Website Besucher in Sprachen empfängt, für die du keine Inhalte indexiert hast.

Szenario	Empfehlung
Einsprachige Website, homogene Zielgruppe — z. B. ein deutsches SaaS für deutschsprachige Kunden	Deaktivieren — einfachstes Setup, keine Überraschungen. Das Widget antwortet stets in der Sprache der Seite.
Einsprachige Website, gelegentliche internationale Besucher — z. B. eine deutsche Website, die von japanischen oder französischen Nutzern besucht wird	Aktivieren — deine deutschen Inhalte bleiben deutsch, internationale Besucher erhalten jedoch eine Antwort in ihrer eigenen Sprache.
Mehrsprachige Website (z. B. getrennte `/de/`- und `/en/`-Seiten) mit konsistenter Zielgruppe	Deaktivieren — jede Seite bedient bereits die passende Sprache. Das Widget übernimmt das Seiten-Locale automatisch; keine zusätzliche Konfiguration nötig.
Mehrsprachige Website + gelegentliche Besucher in nicht unterstützten Sprachen — z. B. eine EN/DE-Seite mit französischen Besuchern	Aktivieren — EN- und DE-Besucher erhalten Antworten passend zur Seite, auf der sie sich befinden; ein französischer Besucher auf einer der beiden Seiten erhält dennoch eine französische Antwort, gestützt auf die am besten passenden verfügbaren Inhalte.

Browsersprache verwenden ist eine globale Einstellung, die für alle Interfaces gilt. Die chatspezifische Einstellung In Nutzersprache antworten (im Abschnitt „Chat“ unten) behandelt einen separaten Aspekt: das Erkennen der Sprache einer getippten Nutzernachricht innerhalb einer Sitzung und die Anweisung an die KI, in derselben Sprache zu antworten. Beide Einstellungen können gleichzeitig aktiv sein.

Status: Wähle zwischen den Modi Development, Production und Disabled. Wechsle zu Production, sobald deine Benutzeroberflächen für den Live-Betrieb bereit sind.
Dynamische Navigation: Konfiguriere die dynamische Navigation basierend auf Nutzungsdaten innerhalb eines bestimmten Zeitraums.
- Primäre Metrik: Die primäre Methode zur Kantengewichtung. Wir empfehlen, mit weight_manual und weight zu beginnen.
  
  Tipp: Starte mit weight_manual und weight, um eine solide Basis zu schaffen, bevor du zur dynamischen Kantengewichtung auf Basis von Nutzerinteraktionsdaten übergehst.
- Sekundäre Metrik: Kommt zum Einsatz, wenn die primäre Metrik keine eindeutige Kantengewichtung liefert oder Node-Gewichte identisch sind.
- Methoden der Kantengewichtung:
  - weight_manual: Bestimmte Nodes manuell hervorheben (z. B. um einen Kontakt-Node prominent zu halten).
  - weight: Ein anpassbarer Wert, der beim Daten-Upload festgelegt wird.
  - weight_rolling_30: Berechnet Durchschnittsgewichte der letzten 30 Tage der Nutzung.
  - weight_rolling_60: Berechnet Durchschnittsgewichte der letzten 60 Tage der Nutzung.
  - weight_rolling_alltime: Berechnet Durchschnittsgewichte aller Nutzungsdaten seit dem Deployment.
Datenaufbewahrungsrichtlinie: Bestimmt die Anzahl der Tage, nach denen Nutzeranfragedaten gelöscht werden. Beachte, dass Insights und detaillierte Analysen keine historischen Daten anzeigen, die älter als diese Frist sind – mit Ausnahme der Gesamtzahl der aktiven Sitzungen.

Suche

Dense Embedding-Modell: Ein proprietäres semantisches KI-Modell, das wichtige Sprachen unterstützt und hervorragend für konzeptionelle Suchaufgaben geeignet ist.
Sparse Embedding-Modell: Ein Information-Retrieval-Modell, optimiert für fortgeschrittene Stichwortsuche (nutzt derzeit eine maßgeschneiderte BM25-Implementierung).
Suchmodus: Definiert den in allen Interfaces verwendeten Suchalgorithmus:
- Dense: Standardmäßige semantische Suche.
- Hybrid (empfohlen): Kombiniert Sparse- und Dense-Modelle mittels Reciprocal Rank Fusion (RRF) für hochpräzise Keyword- und semantische Ergebnisse.
- Sparse: Reine stichwortbasierte Suche.
Hervorhebung in Suchergebnissen: Bestimme, welcher Text in den Ergebnissen hervorgehoben wird. Wähle Chunk, um den am besten passenden Textausschnitt hervorzuheben, oder Page Metadata Description, um die HTML-Meta-Description der Seite anzuzeigen.
Rerank-Einstellungen: Erweiterte Einstellungen zur Feinabstimmung der Relevanz und Sortierung von Suchergebnissen. Du kannst unterschiedliche Regeln für Such- und Chat-Interfaces konfigurieren:
- Datumsbasiertes Reranking: Reiht neuere Inhalte in Suchergebnissen weiter oben ein. Du kannst nach published_date oder modified_date auswerten.
- Datensatzquellen-Reranking: Erhöht die Relevanzwerte von Ergebnissen abhängig davon, ob die Suchanfrage mit den Feldern title oder text übereinstimmt.
- Benutzerdefiniertes Boosting: Verwendet das Feld score_boost an Nodes, um die Suchranking-Prioritäten manuell anzupassen.

Chat

Chat-Strategie: Wähle zwischen Agent (unterstützt aktive Tools und Workflows) und Standard RAG. Dies kann nur aktiviert werden, wenn mindestens ein knowledge_base-Tool aktiv ist. Siehe KI-Aktionen für Details.
In Nutzersprache antworten: Standardmäßig aktiviert. Erkennt automatisch die Sprache der Nutzeranfrage und weist die KI an, in der erkannten Sprache zu antworten. Ist die Sprache uneindeutig, greift sie standardmäßig auf das Locale der Wissensbasis zurück.
Folgeaktionen (Beta): Ermöglicht Fragevorschläge und Navigationsempfehlungen basierend auf dem Konversationskontext. Zeigt ein vorgeschlagener Link auf deine konfigurierte Domain, navigiert das Chat-Interface innerhalb desselben Frames; andernfalls öffnet sich ein neuer Tab.
Routing-Modell (Deaktiviert): Das Modell zur Orchestrierung des Multi-Tool-Routings.
Generierungs-Modell (Deaktiviert): Das Modell zur Generierung von Dialogantworten (nutzt Modelle der Klasse gpt-5.4 via Azure OpenAI).

KI-Modellanbieter: Neben Azure OpenAI-Modellen unterstützt branchly eine Vielzahl weiterer Modellanbieter wie Mistral, Cohere, Google, DeepSeek und Qwen.

Tracking

Konfiguriere das Tracking von Seiten- und Elementinteraktionen, um Nutzerpfade und das Verhalten auf deiner Website zu analysieren.

Seiten-Navigationen / Link-Klicks erfassen: Schalter zum Aufzeichnen von Nutzernavigationen und Klicks. Wenn aktiv, werden Navigations- und Klick-Events an die API gesendet, sodass du User Journeys über deine gesamte Website hinweg nachverfolgen kannst.
Benutzerdefiniertes Element-Tracking: Bestimme gezielt spezifische Elemente (wie individuelle Cards oder Banner) für das Tracking, indem du deinen HTML-Elementen das Attribut data-branchly hinzufügst.
Tracking-Regeln: Definiere Regeln, um global alle Link- (<a>) und Button-Elemente zu erfassen oder spezifische CSS-Selektoren anzusteuern.
Dashboard-Ausschluss: Navigationsereignisse innerhalb der branchly-Benutzeroberflächen werden automatisch ignoriert.

Externe Web-Analytics

branchly erfasst Analytics-Events, die bereits auf deiner Website laufen, und leitet sie an branchly Insights weiter, wo sie mit der branchly-Sitzung verknüpft werden. Aktiviere unter Einstellungen → Tracking die Anbieter, die du auf deiner Website nutzt:

Google Analytics: Erfasst gtag- und Google Tag Manager dataLayer-Events von deiner Website.
Umami: Erfasst Umami-Analytics-Events von deiner Website.
Matomo: Erfasst Matomo _paq-Tracking-Events von deiner Website.

Diese Einstellungen gelten sowohl für das Chat-Widget als auch für das Such-Interface. Deinerseits ist keine zusätzliche Einrichtung erforderlich: Sobald ein Anbieter aktiviert ist, lauscht das branchly-Embed auf dessen Tracking-Aufrufe (z. B. jedes Event, das du in gtag definierst oder in den GTM-dataLayer pushst) und leitet diese automatisch weiter – GTM-interne Events wie gtm.js werden herausgefiltert. Erfasste Events erscheinen live neben den durch das branchly-eigene Tracking aufgezeichneten Ereignissen, sodass du dein bestehendes Analytics-Setup in Insights direkt mit branchly-Sitzungen korrelieren kannst.

Integrationen

Verbinde Drittanbieter-Plattformen, um die Fähigkeiten deiner branchly-Anwendung zu erweitern. Dieser Tab bündelt sichere OAuth-Verbindungen und Konfigurationen.

WordPress: Verbinde deine WordPress-Website über die REST-API v2, um Beiträge und Seiten direkt in deine Wissensbasis zu importieren, und konfiguriere Webhooks, um Aktualisierungen automatisch zu synchronisieren.
Calendly: Verbinde dein Calendly-Konto, um den KI-Agenten zu autorisieren, Meetings und Telefonate direkt im Chat-Widget in deinem Namen zu buchen.
Token Endpoint: Wenn deine APIs und Tools durch einen benutzerdefinierten Login-Endpunkt geschützt sind, binde ihn hier an. branchly tauscht an diesem Endpunkt einen API-Schlüssel oder Benutzername/Passwort-Zugangsdaten gegen ein Bearer-Token ein und fügt dieses (standardmäßig als Authorization: Bearer-Header) automatisch in Anfragen von OpenAPI-Datenquellen und API-Tools ein. Im Verbindungsformular konfigurierst du die Token-URL, wie der Login-Request gesendet wird, wo das Token aus der Antwort extrahiert wird sowie das Header-Format. Tokens werden gecacht und automatisch vor Ablauf erneuert, sodass du den Endpunkt nur einmal einrichten musst. Wähle die Integration nach dem Verbinden als Authentifizierungs-Integration in deinen API-Tools und OpenAPI-Datenquellen aus.

Benutzereinstellungen

Verwalte persönliche Benachrichtigungseinstellungen und Berichts-Abonnements für die aktuelle Anwendung.

Wöchentlicher Digest per E-Mail: Abonniere regelmäßige automatisierte E-Mail-Berichte mit Sitzungsmetriken, Trend-Klassifizierungen und Out-of-Scope-Anfragen. Diese Einstellung kann für jede Anwendung und jeden Nutzer individuell konfiguriert werden. Siehe Geplante E-Mail-Berichte für weitere Details.

Erweitert

Entwicklerbezogene Einstellungen für API-Integrationen und Sicherheit.

API-Schlüssel: Generiere und verwalte sichere API-Schlüssel zur Authentifizierung eigener API-Anfragen an die branchly-Endpunkte.