Zum Inhalt

Wiki

Vorschau-Funktion

Das Wiki ist standardmäßig ausgeschaltet — Menüpunkt, Seite, API und die Wiki-Knöpfe an Checks sind gesperrt, bis ein Super-Admin den Bereich unter Admin → System → Vorschau-Funktionen freischaltet. Solange es aus ist, nutzt auch die KI das Wiki nicht als Quelle. Der Bereich ist noch nicht fertig. Instanzen, die vor dem Update schon selbst geschriebene Artikel hatten, behalten das Wiki eingeschaltet.

Das Wiki ist die zentrale Ablage für „wie wir Dinge tun", Runbooks, Service-Dokumentation, Notiz-Sammlungen.

Konzept

  • Ordner (Kategorien) gruppieren Artikel — jeder Mandant hat seine eigenen. Wer Zugriff auf mehrere Mandanten hat, schaltet im Wiki zwischen ihnen um; ein Artikel lässt sich nur in einen Ordner des eigenen Mandanten legen. Ordnernamen und Artikeltitel sind je Mandant eindeutig — ein doppelter Name wird mit einer Meldung abgelehnt.
  • Artikel werden in einem Rich-Text-Editor geschrieben und als Markdown gespeichert — mit Volltext-Index und, wenn ein Embedding-Modell eingerichtet ist, Vector-Embeddings.
  • Mitgelieferte Anleitungen: Vesana legt in jedem Mandanten einige Artikel und Ordner an. Sie lassen sich bearbeiten, aber nicht löschen.
  • Service-Linking — ein Artikel kann an einen Check-Typ, einzelne Hosts oder konkrete Profile-Checks hängen.
  • AI-RAG-Quelle — der AI-Chat und die KI-Analyse ziehen als erste Quelle aus dem Wiki.

Artikel anlegen

/wiki → Neuer Artikel.

Feld Bedeutung
Titel Pflicht, je Mandant eindeutig
Kategorie aus der Liste der Ordner oder „keine"
Tags optional, kommagetrennt
Inhalt Rich-Text-Editor

Editor-Werkzeuge: Fett, Kursiv, Überschrift, Aufzählung, nummerierte Liste, Zitat, Inline-Code, Link, Trennlinie, Rückgängig/Wiederholen.

Service-Linking

Ein Artikel lässt sich verknüpfen mit:

  • einem Check-Typ generell (z. B. alle agent_disk-Checks, egal auf welchem Host)
  • einem einzelnen Host (für Eigenheiten, die nur für eine bestimmte Maschine gelten)
  • einem konkreten Profile-Check

In der Oberfläche entsteht eine Verknüpfung beim Anlegen aus einem Check heraus: Artikel für diesen Service erstellen im Wiki-Vorschlag eines Checks oder Als Wiki-Artikel speichern in der KI-Analyse verknüpft den neuen Artikel mit dem Check-Typ; mit Nur für Host: … zusätzlich nur mit diesem Host. Beim späteren Bearbeiten bleiben die Verknüpfungen unverändert. Verknüpfungen mit einzelnen Profile-Checks und nachträgliche Änderungen gehen über die API.

Wirkung: Der Wiki-Vorschlag am Check zeigt die verknüpften Artikel zuerst; die KI-Analyse nutzt das Wiki als Kontext.

Beispiel: Ein Artikel „Disk-Voll-Runbook" wird an den Check-Typ agent_disk gebunden — sobald ein Disk-Voll-Alert kommt, ist das Runbook direkt erreichbar, unabhängig vom konkreten Host.

Suche

Die Artikelliste unter /wiki blättert in Seiten zu 50 Artikeln und zeigt je Artikel eine Textvorschau. Das Suchfeld nutzt die Volltextsuche über Titel und Inhalt; jedes eingegebene Wort wird als Wortanfang gesucht („postgr" findet „PostgreSQL"). Teile mitten im Wort findet die Suche nicht.

Die semantische Suche über Embeddings nutzt die KI (Chat und Analyse), nicht das Suchfeld der Liste.

Embeddings

Beim Speichern eines Artikels wird im Hintergrund ein Embedding berechnet (asynchron, blockiert das Speichern nicht):

  • Modell: das unter AI-Provider konfigurierte Embedding-Modell (z. B. nomic-embed-text über Ollama); ist keins gesetzt, das Chat-Modell
  • Die Vektorlänge passt sich dem jeweiligen Modell an (z. B. 768 bei nomic-embed-text). Nach einem Wechsel des Embedding-Modells passen alte und neue Vektoren nicht zusammen; die KI fällt dann für betroffene Artikel auf die Volltextsuche zurück, statt die Anfrage abzubrechen.

Fehlende Embeddings (z. B. nach einem Bulk-Import oder wenn beim Speichern kein Provider konfiguriert war) werden von einem Hintergrund-Job periodisch nachgeholt. Solange das Wiki als Vorschau-Funktion ausgeschaltet ist, ruht dieser Job.

Wiki-Vorschlag am Check

Auf der Fehlerübersicht, der Host-Detail-Seite und im Check-Detail öffnet der Wiki-Knopf eines Checks eine Liste passender Artikel — ohne LLM-Aufruf, rein deterministisch:

  1. Direkter Treffer über verknüpfte Artikel (Check-Typ, Profile-Check oder Host)
  2. Fallback: Volltext-Suche über den Service-Namen

Findet sich nichts, bietet die Liste Artikel für diesen Service erstellen an.

Soft-Delete

Artikel werden soft-deleted (siehe Papierkorb) — gelöscht heißt erstmal versteckt und aus der Liste verschwunden, nach 30 Tagen physisch weg. Service-Verknüpfungen bleiben beim Soft-Delete erhalten und sind nach einem Restore wieder vollständig da. „Papierkorb leeren" lässt Wiki-Artikel liegen, solange das Wiki ausgeschaltet ist.

URL Wirkung
/wiki Übersicht
/wiki?article=<id> Artikel direkt öffnen
/wiki?new=1 Neuer Artikel mit leerem Modal

Permissions

Permission Wirkung
wiki.view Artikel sehen
wiki.edit Bearbeiten
wiki.create Neue anlegen
wiki.delete Soft-Delete

Wiederherstellen aus dem Papierkorb braucht wiki.create; endgültiges Löschen läuft über die allgemeinen Papierkorb-Permissions.

Anschluss