Licensed to be used in conjunction with basebox, only.
// integration
DokuWiki
Gilt für
Produkt: Cloud · Server · Zielgruppe: Administrator
Der Konnektor DokuWiki lässt den basebox-Assistenten Seiten einer selbst gehosteten DokuWiki-Instanz durchsuchen und lesen – etwa Ihre interne Wissensdatenbank, klinische SOPs oder Runbooks.
Wann einsetzen
Aktivieren Sie DokuWiki, wenn der Assistent:
- Fragen auf Grundlage Ihrer Wiki-Inhalte beantworten soll,
- in seinen Antworten direkt auf Wiki-Seiten verweisen oder verlinken soll,
- bestehende Dokumentation finden und zusammenfassen soll, statt sie von Grund auf neu zu erklären.
Konfiguration
DokuWiki arbeitet mit persönlichen Zugangsdaten: Der Administrator richtet den Konnektor einmal ein, und jeder Nutzer hinterlegt sein eigenes DokuWiki-Token. So sieht jede Person über basebox genau die Seiten, die sie auch im Wiki sehen darf (Konnektor-Authentifizierung).
Als Administrator suchen Sie auf der Seite Admin → Konnektoren den Eintrag DokuWiki und füllen aus:
| Feld | Beschreibung |
|---|---|
| Endpoint URL | Der XML-RPC-Endpunkt Ihres DokuWiki (typischerweise https://wiki.example.org/lib/exe/xmlrpc.php). Auf basebox Server kann der Platform Operator ihn auch per Helm setzen (Konnektoren konfigurieren). |
| Base URL info | Freitext, der die öffentliche Basis-URL Ihres Wikis beschreibt, z. B. https://wiki.example.org/doku.php?id=<page>. basebox gibt diesen Text in den Kontext des Assistenten, damit er korrekte, anklickbare Links zu Ihren Wiki-Seiten erzeugen kann. |
Anschließend:
- Klicken Sie auf Verbindung testen, um den Endpunkt zu prüfen.
- Schalten Sie den Konnektor ein und geben Sie ihn in den Apps frei, in denen er nutzbar sein soll.
Als Nutzer tragen Sie Ihr eigenes DokuWiki-Zugriffstoken beim Konnektor ein und prüfen es mit Verbindung testen. Die Token-Anmeldung muss in Ihrer DokuWiki-Instanz aktiviert sein. Wo Sie das Token eintragen, steht unter Konnektoren.
Verhalten im Chat
Wenn DokuWiki aktiviert ist und ein Nutzer etwas fragt, das der Assistent aus dem Wiki beantworten kann:
- Der Assistent durchsucht das Wiki, liest relevante Seiten und antwortet mit deren Inhalt.
- Links zu Wiki-Seiten werden so gerendert, dass sie in einem neuen Browser-Tab öffnen, damit der Chat des Nutzers nicht unterbrochen wird.
- Der Assistent verwendet den Wert aus Base URL info, um korrekt formatierte Links zu Ihrem Wiki zu bilden.
Tipps
- Je weniger Werkzeuge der Assistent zur Auswahl hat, desto besser arbeitet er in der Regel – aktivieren Sie DokuWiki nur, wenn Ihre Nutzer tatsächlich ein Wiki als Referenz haben.
- Jede Person sieht über basebox nur, was ihre eigenen Rechte im Wiki erlauben. Einen gemeinsamen Wiki-Benutzer braucht es nicht.
- Ändert der Administrator die Endpunkt-URL, wirkt die Änderung sofort – kein Neustart nötig.
Einschränkungen
- Es kann nur eine DokuWiki-Instanz gleichzeitig angebunden werden.
- Seiten hinter ACLs, die der jeweilige Nutzer nicht sehen darf, werden nicht zurückgegeben.