XWiki - Datenquelle

Die Datenquelle xWiki verbindet sich mit einer xWiki-Instanz und indexiert deren Bereiche und Seiten, damit Ihr Assistent Fragen zu den Wiki-Inhalten beantworten und auf die Originalseite verweisen kann.

Info

Der Connector liegt im Tab Add data des Assistenten-Editors. Wenn Sie noch keinen Assistenten haben, beginnen Sie mit KI-Assistenten erstellen.

xWiki-Connector hinzufügen

Öffnen Sie Ihren Assistenten im Editor, wechseln Sie in den Tab Add data klicken Sie auf Add connector und wählen Sie xWiki.

Schritt 1: Mit xWiki verbinden

QAnswer authentifiziert sich per Basic Authentication am Wiki und benötigt daher ein xWiki-Konto, das die zu indexierenden Inhalte lesen darf:

xWiki base URL (erforderlich): die Adresse Ihrer xWiki-Instanz, zum Beispiel https://wiki.example.com.
xWiki username (erforderlich): der Benutzer, mit dem QAnswer sich anmeldet. Sichtbar sind nur Seiten, die dieser Benutzer lesen darf.
Password (erforderlich): das Passwort dieses xWiki-Benutzers.
Wiki name (optional): das zu indexierende Wiki auf einer Multi-Wiki-Instanz. Leer gelassen gilt „xwiki“.

Das Feld Connector's name über den Schritten ist mit „xWiki“ vorbelegt. Vergeben Sie einen eigenen Namen, wenn der Assistent aus mehreren Wikis liest — dieser Name erscheint anschließend in der Connector-Liste.

Klicken Sie auf Connect um die Zugangsdaten zu prüfen. Sind sie akzeptiert, klappt Schritt 1 zu und Schritt 2 öffnet sich.

Sicherheitshinweis

Ihre xWiki-Zugangsdaten werden verschlüsselt beim Connector gespeichert und für spätere Synchronisationen wiederverwendet — Sie müssen sie nie erneut eingeben.

Schritt 2: Bereiche und Seiten zum Indexieren auswählen

QAnswer zeigt das Wiki als Baum ab seiner Wurzel. Indexiert wird erst, was Sie auswählen:

Markieren Sie einen Bereich, um ihn mit allen darin verschachtelten Seiten und Unterbereichen aufzunehmen.
Klappen Sie einen Bereich mit dem Pfeil auf, um gezielt einzelne Seiten oder Unterbereiche zu markieren.
Ein Elternknoten mit Teilauswahl zeigt einen Strich statt eines Hakens — so ist immer sichtbar, wie weit die Auswahl reicht.
Klicken Sie auf Finish um den Connector zu speichern und die Indexierung im Hintergrund zu starten.

Tipp

Beginnen Sie mit einem Bereich, prüfen Sie das Ergebnis und fügen Sie dann das restliche Wiki hinzu. Weniger, dafür passendere Bereiche halten die Antworten fokussiert.

Indexierte Seiten

Zurück im Tab Add data zeigt die Connector-Zeile, wie viele Seiten sie enthält und wie viel Platz diese belegen. Klappen Sie sie auf, um alle indexierten Seiten zu sehen:

Die Spalte Status und der Statusfilter zeigen, welche Seiten fertig indexiert sind und welche noch ausstehen.
Das Suchfeld findet eine Seite im Connector anhand ihres Titels.
Das Öffnen-Symbol führt direkt zur Originalseite in Ihrer xWiki-Instanz.
Das Inhalts-Symbol zeigt den von QAnswer extrahierten Text, und das Zeilenmenü enthält die Aktionen je Seite.

Später weitere Bereiche hinzufügen

Um mehr aus dem Wiki zu indexieren, klicken Sie auf Add files in der Connector-Zeile. Dort können Sie außerdem die indexierten Inhalte herunterladen, den Connector umbenennen oder ihn samt allem Indexierten löschen.

Hinweis

Da die gespeicherten Zugangsdaten wiederverwendet werden, führt Add files direkt zum Bereichsbaum — ein erneutes Eingeben von xWiki-Benutzer und Passwort ist nicht nötig. Funktionieren die Daten nicht mehr, landen Sie wieder im Verbindungsschritt.

Den Index aktuell halten

xWiki-Seiten ändern sich, deshalb kann der Connector sie erneut einlesen. Öffnen Sie Update Files in der Connector-Zeile und wählen Sie, wie oft das geschehen soll:

Never: keine automatische Aktualisierung — die Voreinstellung eines neuen Connectors.
Now: aktualisiert sofort und liest die ausgewählten Seiten neu ein, deren xWiki-Version sich geändert hat.
Daily, Weekly, Monthly: aktualisiert von nun an in diesem Rhythmus. Die aktive Option bleibt im Menü hervorgehoben.

Fehlerbehebung

Verbindung fehlgeschlagen

Prüfen Sie, ob die Basis-URL auf Ihre xWiki-Instanz zeigt und von QAnswer erreichbar ist.
Prüfen Sie, ob Benutzername und Passwort korrekt sind und das Konto aktiv ist.
Stellen Sie sicher, dass der Wiki-Name zu einem existierenden Wiki passt (Standard „xwiki“).

Keine Bereiche oder Seiten aufgelistet

Stellen Sie sicher, dass der xWiki-Benutzer Leserechte auf die erwarteten Bereiche hat.
Manche Bereiche enthalten nur Unterbereiche; klappen Sie den Bereich auf, um zu seinen Seiten zu kommen.

Tipp

Alle Connectoren verhalten sich beim Indexieren gleich und haben dieselben Grenzen. Den Gesamtüberblick gibt Datenquellen.