Best Bets Connector

Installation und Konfiguration

Installation

Vor der Installation des Best Bets Konnektors muss sichergestellt werden, dass der Mindbreeze Server installiert und der Best Bets Konnektor in der Lizenz inkludiert ist. Zur Installation oder Aktualisierung des Konnektors verwenden Sie bitte das Mindbreeze Management Center.

Best Bets Konnektor Plugin und Konfigurations-Plugin

Der Best Bets Konnektor ist standardmäßig als Plugin installiert. Eine Liste aller installierten Plugins finden Sie im Menüpunkt „Konfiguration“ im Tab „Plugins“.

Neben dem Best Bets Konnektor Plugin, stehen auch Konfigurations-Plugins zur Verfügung. Durch die Installation eines Konfigurations-Plugins wird automatisch eine Änderung an der Konfiguration durchgeführt. So können Sie ohne großen Aufwand eine Basiskonfiguration oder eine spezielle Konfiguration erhalten. Sie finden die folgenden Konfigurations-Plugins als Download in Updates & PI:

• Basiskonfiguration: BestBets-Config.tar.gz
• NLQA-Konfiguration: BestBets-NLQA-Config.tar.gz
• GSA-Basiskonfiguration: GSA-Replacement-Config.tar.gz

Installation von Plugins via Mindbreeze Management Center

Zur Installation des Plugins, öffnen Sie das Mindbreeze Management Center. Wählen Sie aus dem linken Menü den Punkt „Konfiguration“ aus. Anschließend navigieren Sie auf den Reiter „Plugins“. Im Abschnitt „Plugin Management“ wählen Sie die entsprechende Zip-Datei aus laden sie durch Auswahl der Schaltfläche „Upload“ hoch. Damit wird der Konnektor automatisch installiert oder gegebenenfalls aktualisiert. In diesem Zuge werden die Mindbreeze Dienste neugestartet.

Konfiguration von Mindbreeze

Wählen Sie zur Konfiguration die Installationsmethode „Advanced“.

Konfiguration von Index und Crawler

Konfiguration des Index

Navigieren Sie auf den Reiter „Indices“ und klicken Sie auf das Symbol „Add new index“ rechts oben, um einen neuen Index zu erzeugen. Alternativ kann das Plugin „BestBets-Config“ installiert werden, welches die weitere Konfiguration automatisch durchführt.

Geben Sie den Pfad zum Index ein und ändern Sie gegebenenfalls den Display Namen.

Grundkonfiguration des Crawlers

Fügen Sie eine neue Datenquelle durch Klick auf das Symbol „Add new custom source“ rechts oben hinzu. Wählen Sie die Category „BestBets“ und konfigurieren Sie die Datenquelle nach Ihren Bedürfnissen. Unter den CSV Settings kann das gewünschte, auf der Appliance gespeicherte CSV File ausgewählt und das Trennzeichen für die einzelnen Zeileneinträge angegeben werden.  Unter den Metadata Settings kann angegeben werden, welche Spalten des CSV Informationen als Liste beinhalten und welches Trennzeichen für die einzelnen Einträge der Liste verwendet wird.

Zusätzliche Metadaten

Mit „Additional Metadata“ können Sie weitere Metadaten für die Best Bets Dokumente definieren. Das Attribut „Name“ ist der Name des Metadatums, „Value“ stellt den Wert des Metadatums dar. Metadatumswerte können Platzhalter für bestehende CSV Felder enthalten, z.B. {{URL}}. Diese Platzhalter werden ersetzt durch die referenzierte CSV-Felder.

Konfiguration der vorgeschlagenen Seiten

Im Management Center, unter Search Experience -> Suggested Sites, befindet sich ein CSV mit Informationen darüber, welche Ergebnisse mit welchen Suchverhalten unter den Best Bets aufgelistet werden (Falls das BestBets-Config Plugin verwendet wurde).

Wenn die Bearbeitung abgeschlossen ist, werden bei einer passenden Suche der Title verlinkt mit der URL, der OrganizationName und der OrganisationalUnitName angezeigt. In der Searchable Spalte kann zusätzlich (durch Beistrich getrennt) angegeben werden, welche Spalten für die Suche verwendet werden sollen. Dazu müssen lediglich die Namen der Spalten angegeben werden, die durchsuchbar sein sollen. Zusätzlich kann in der Spalte Upload ein Icon hinzugefügt werden.

„KeyMatch“ Suche für BestBets

Wenn der „KeyMatch“ Modus aktiv für die BestBets Datenquelle aktiv ist, müssen in der BestBets CSV Datei für alle Dokumente die folgende zwei Spalten definiert und ausgefüllt werden: „SearchTerm“ und „MatchType“. Die „SearchTerm“ Spalte beinhaltet Suchbegriffe die das BestBets Dokument als Ergebnis liefern. „MatchType“ definiert wie die definierten Suchbegriffe mit der Suche übereinstimmen sollen. Drei Varianten werden unterstützt:

ExactMatch: die Suche muss exakt gleich sein mit den Suchbegriffen in „SearchTerm“ definierten Suchbegriffen

PhraseMatch: der Suchbegriff muss in der Suche als direkter Substring vorkommen. Die Reihenfolge muss übereinstimmen und es dürfen keine anderen Wörter dazwischen sein.

z.B: SearchTerm: it security

Suche „mindbreeze it security“ und „it security mindbreeze“ liefert das Dokument aber „it network security“ oder „security it“ nicht.

KeywordMatch: alle Wörter aus SearchTerm müssen in der Suche enthalten sein

KeyMatch Suche Aktivieren

Wichtig: damit die KeyMatch Suche funktioniert, darf im Index nur eine BestBets-Datenquelle vorhanden sein.

Um die KeyMatch Suche für den BestBets Index verwenden zu können stellen Sie sicher, dass der BestBets Query Transformation Service aktiviert ist. Beachten Sie, dass der BestBets Query Transformation Service NICHT unter Global Index Settings konfiguriert werden darf sondern direkt am Index der BestBets-Datenquelle konfiguriert werden muss:

Als „BestBets CSV Path“ sollte das gleiche CSV File konfiguriert werden wie in der BestBets Datenquelle.

Als „Best Bets Column Separator“ sollte das gleiche Trennzeichen konfiguriert werden wie in der BestBets Datenquelle.

Mit den Optionen „Search Term Column Name“ und „Match Type Column Name“ können die CSV Spaltennamen für KeyMatch Suchbegriffe bzw. KeyMatch Match-Typen gesetzt werden. Diese Spalten müssen im BestBets CSV als durchsuchbar markiert sein, entweder im CSV mit der Spalte „Searchable“ oder „Searchable“ gesetzt als Zusätzliches Metadatum (Additional Metadata).

Ein Beispiel für BestBets CSV mit KeyMatch Suche ist:

Icon;Title;URL;Description;OrganizationName;OrganisationalUnitName;Searchable;SearchTerm;MatchType

;2018 Calendar 1;http://mycompany.com/2018calendar/;Calendar of 2018;Organization;Unit;SearchTerm,MatchType;calendar;ExactMatch

;2018 Calendar 2;http://mycompany.com/2018calendar/;Calendar of 2018;Organization;Unit;SearchTerm,MatchType;calendars;ExactMatch

;2018 Calendar 3;http://mycompany.com/2018calendar/;Calendar of 2018;Organization;Unit;SearchTerm,MatchType;2018 calendar;KeywordMatch

;IT Security;http://mycompany.com/itsecurity/;IT Security;Organization;Unit;SearchTerm,MatchType;IT Security;PhraseMatch

Die Spalten „SearchTerm“ und „MatchType“ sind im CSV mit „Searchable“ durchsuchbar markiert: SearchTerm,MatchType.

Wenn in den Spalten „SearchTerm“ und „MatchType“ keine Werte gesetzt ist, wird die Standardsuche für die BestBets Datenquelle verwendet.

Troubleshooting

Problem: BestBets werden nicht angezeigt

• Falls Sie das „KeyMatch“ Feature nicht benutzen wollen, stellen Sie sicher, dass im BestBets CSV die Spalten „SearchTerm“ oder „MatchType“ nicht existieren oder komplett leer sind.
• Falls Sie das „KeyMatch“ Feature benutzen, stellen Sie sicher, dass im BestBets CSV die Spalten „SearchTerm“ und „MatchType“ existieren und jeder Eintrag valide Werte beinhaltet.

• Stellen Sie sicher, dass der BestBets Crawler konfiguriert ist und seit der letzten Änderung des BestBets CSVs einen erfolgreichen Crawl-Run durchgeführt hat.
• Stellen Sie sicher, dass der BestBets Query Expression Transformator konfiguriert ist und keine Fehlermeldungen zeigt.

Redaktionelle Pflege von Antworten

Einleitung

Analog zur Spezifikation von vorgeschlagenen semantischen Suchergebnissen kann der Best Bets Index auch zur Konfiguration von kuratierten Antworten für passende Fragen verwendet werden. Im Folgenden wird gezeigt, wie der Best Bets Index Service und die Datenquelle für die redaktionelle Pflege von NLQA-Antworten konfiguriert werden können.

Initiale Konfiguration

Falls Sie ein Mindbreeze InSpire Setup ohne einen bereits konfigurierten Best Bets Index und eine Datenquelle haben, kann die Konfiguration automatisch erfolgen, indem Sie das Plugin bestbets-nlqa-baseconfig-<inspire_version>.tar.gz installieren. Das Plugin finden Sie unter https://www.mindbreeze.com/updates-spi.html im Bereich „Zusätzliche Downloads“.

Das Plugin kann im Mindbreeze InSpire Management Center unter Verwendung des Standard-Installationsprozesses für Erweiterungen installiert werden.

Automatisierte Einrichtung

Die erfolgreiche Installation des bestbets-nlqa Plugins führt zu den folgenden Änderungen in der Mindbreeze InSpire Konfiguration:

Die automatische Konfiguration mit dem Plugin bestbets-nlqa-baseconfig funktioniert, wenn nicht bereits eine automatische Konfiguration von Best Bets vorhanden ist.

Wenn es eine selbsterstellte BestBets Konfiguration in /data/resources/bestbets,csv gibt, wird diese nicht wiederhergestellt.

Die automatischen Konfigurationsänderungen werden nur einmal ausgeführt. Die nachfolgende Installation des Konfigurations-Plugins wird die aktuelle Konfiguration von Mindbreeze InSpire nicht verändern.

Die Konfigurationsschritte können manuell wiederholt werden.

Redigieren von NLQA-Antworten

Die kuratierten NLQA-Antworten können in der Standardkonfigurationsdatei von Best Bets angegeben werden. Der folgende Parameter sollte für jeden Eintrag gesetzt werden:

• Beschreibung: Der Parameter “Beschreibung” des Best-Bets-Eintrags sollte den kuratierten Antworttext für die Benutzeranfrage enthalten, die mit dem angegebenen MatchTerm übereinstimmt.
• URL: Die URL ist die Quell-URL der kuratierten Antwort.
• Suchbegriff: Best Bets Keymatch-Ausdruck für die Übereinstimmung mit der Eingabe.
• MatchType: Einer der unterstützten Best Bets MatchTypes: PhraseMatch, KeywordMatch und ExactMatch.

Die passenden kuratierten Antworten werden mit dem Best Bets KeyMatch-Matching identifiziert, wie im Abschnitt "KeyMatch"-Suche für Best Bets beschrieben.

Beispiel:

Eine kuratierte Antwort mit den folgenden Parametern:

• URL: https://inspire.mindbreeze.com/management
• Titel: Daniel Fallmann Gründer & CEO
• Beschreibung: Daniel Fallmann gründete Mindbreeze im Jahr 2005.
• Suchbegriff: wer ceo Mindbreeze
• MatchType: KeywordMatch

Gibt man "Wer ist der Geschäftsführer von Mindbreeze?" ein, ergibt die Suche nach allen angegebenen Schlüsselwörtern gemäß dem MatchType "KeywordMatch" die folgende Antwort:

Die passenden kuratierten Antworten werden mit einer “Top Antwort” Punktzahl generiert, wodurch sie in der Antwortliste für die eingegebene Frage ganz oben stehen. Sie werden in der Mindbreeze InSpire Suchoberfläche als "kuratierte Antworten" gekennzeichnet.