Resources anlegen

Eine Resource ist ein Stück Wissen: ein Artikel, eine Anleitung, eine Richtlinie, eine Liste von Produktcodes, alles, was eine Suche finden können soll. Eine Resource enthält einen einzigen Textblock, den der Service in kleinere Stücke (Chunks) aufteilt und in dem Moment, in dem du speicherst, für die Suche vorbereitet. Eine Suche betrachtet nie eine ganze Resource auf einmal, sie liefert die einzelnen Chunks zurück, die am besten passen.

Der Resource-Editor

Öffne eine Gruppe unter Knowledge groups und dann Add new resource (oder Update bei einer bestehenden), um den Editor zu öffnen.

Statt zu tippen, kannst du eine Datei auf den Editor ziehen oder auf Browse files klicken. Aktuell werden nur reine Textdateien unterstützt (.txt, .md, .json, .yaml, .yml, .csv, .log). Binäre Formate wie PDF oder Word werden nicht verarbeitet. Das Auswählen einer Datei ersetzt den aktuellen Inhalt des Felds Text content durch den Dateiinhalt, prüfe ihn also vor dem Speichern; du kannst den Text danach trotzdem weiter bearbeiten, Upload und Tippen schliessen sich nicht gegenseitig aus.

Sowohl Name als auch Text content müssen ausgefüllt sein, bevor du speichern kannst.

Chunks verstehen

Ein Chunk ist die eigentliche Einheit, die durchsucht und zurückgegeben wird: Trifft eine Anfrage ein, vergleicht der Service sie mit jedem Chunk der Gruppe und antwortet mit den am besten passenden, jeweils mit eigenem Relevanz-Score. Das Feld Chunk size bestimmt in Zeichen, wie viel Text ungefähr in jeden Chunk kommt. Der Splitter versucht, an natürlichen Grenzen wie Absätzen oder Sätzen zu trennen statt mitten im Wort, und aufeinander folgende Chunks überlappen sich leicht, damit Informationen genau an der Schnittstelle nicht verloren gehen.

Es gibt keine einzig richtige Chunk-Grösse, sie hängt von der Form deines Inhalts ab:

• Kleinere Chunks (ein paar hundert Zeichen) eignen sich gut für Inhalte, die eigentlich eine Liste unabhängiger, in sich geschlossener Fakten sind: FAQ-Einträge, Produktspezifikationen, eine Tabelle mit Teilenummern. Jeder Fakt kann für sich gefunden und zurückgegeben werden, ohne unzusammenhängenden Nachbartext mitzuziehen.
• Grössere Chunks, bis hin zur Grösse der ganzen Resource, eignen sich besser, wenn eine Textstelle nur als Ganzes einen Sinn ergibt: eine Schritt-für-Schritt-Anleitung, eine Vertragsklausel, ein Absatz, dessen Sätze voneinander abhängen. Ein Split würde ein Fragment liefern, das für sich allein unvollständig oder irreführend wirkt.

Im Zweifel ist der Standardwert von 512 Zeichen ein vernünftiger Mittelweg für die meisten Fliesstexte. Du kannst die Chunk-Grösse einer Resource jederzeit über ihre Chunk size ändern, das ist keine Entscheidung, die du bei der Erstellung fest triffst.

Role Filter

Das Feld Role ist optional und Freitext: nutze es, um eine Resource mit einer für dich sinnvollen Kategorie zu markieren, meistens einer Nutzerrolle wie support, manager oder customer. Eine Suche kann selbst eine Role mitgeben, siehe Externe Integrationen, und sieht dann nur Resources, die mit genau dieser Role markiert sind.

Lässt du Role bei einer Resource leer, ist sie für jede Suche verfügbar, unabhängig davon, nach welcher Role diese Suche filtert. Betrachte das als Inhalt, den alle sehen dürfen, neben rollenspezifischem Inhalt, der nur bestimmten Suchen angezeigt werden soll.

Sobald eine Gruppe ein paar Resources enthält, probiere eine echte Suche im Dashboard aus, bevor du irgendeinen Integrationscode schreibst, siehe Suche und Ranking.