Frontmatter in Dokumenten
Beim Einlesen von Textdateien (z. B. Markdown, .txt) in das Wissen erkennt skai einen optionalen Frontmatter-Block am Dateianfang. Der Block wird ausgewertet, bevor der Inhalt der KI zur Verfügung gestellt wird – die KI sieht den Frontmatter selbst nicht.
Format
Der Frontmatter-Block steht ganz am Anfang der Datei, umschlossen von zwei ----Trennzeilen:
Jede Zeile innerhalb des Blocks folgt dem Format Schlüssel: Wert. Unbekannte Schlüssel werden stillschweigend ignoriert.
Unterstützte Schlüssel
skaiWebUrl
Setzt die Web-URL, die skai dem Dokument zuordnet. Diese URL erscheint in Quellenangaben, wenn die KI dieses Dokument als Quelle zitiert.
Eigenschaft | Beschreibung |
|---|---|
Wert | Eine gültige URL mit Schema |
Verhalten bei ungültiger URL | Der Schlüssel wird ignoriert; es wird keine Web-URL gesetzt |
Priorität | Überschreibt eine vom Quellsystem gelieferte URL (z. B. OneDrive-Link) |
Beispiel:
Wird dieses Dokument als Quelle zitiert, zeigt skai den Link https://wiki.beispiel.de/artikel/schnabelwale an – unabhängig davon, woher die Datei stammt.
Anwendungsbeispiele
Exportierte Wissensdatenbank-Artikel: Eine Markdown-Datei enthält den exportierten Inhalt eines Wiki-Artikels. Mit
skaiWebUrlwird der Link zur Originalseite hinterlegt, damit Nutzer direkt zum Quellsystem navigieren können.Externe Quellen mit abweichender URL: Eine über OneDrive eingebundene Datei hat intern eine technische Speicherpfad-URL. Per Frontmatter wird stattdessen eine lesbare öffentliche URL verknüpft.
Zentrale Dokumentensammlungen: Mehrere Dokumente einer Quelle erhalten jeweils eine eigene
skaiWebUrl, um präzise Verlinkungen in den KI-Antworten zu ermöglichen.
Kompatible Quelltypen
Frontmatter wird bei allen Quelltypen ausgewertet, die Textdateien verarbeiten, unter anderem:
Dateien und Ordner (direkter Upload)
OneDrive, Google Drive, SharePoint, Nextcloud, Azure Blob Storage, SMB-Dateiserver
Bei Quelltypen ohne Dateiinhalt (z. B. SQL-Datenbank, Glossar, Links) hat Frontmatter keine Wirkung.