Wissen — die Dokumente der Firma
Im Wissen liegen die Dokumente, die erklären, wie eure Firma arbeitet: das Handbuch, die Vereinbarungen mit einem Kunden, der Grund, warum ihr etwas anders macht als alle. Das ist das, was der Agent durchsucht, wenn er eine Frage nicht aus Datensätzen beantworten kann.
Drei Arten von Dokument
kyte kennt drei Arten von Dokument. Sie sehen gleich aus — Markdown, ein Titel, etwas Text —, liegen aber an verschiedenen Orten. Davon hängt ab, wer sie sieht und wo du sie änderst.
| liegt | wer es sieht | wo du es änderst | |
|---|---|---|---|
| Ein Dokument in deinem Ordner | als Markdown-Datei in dem Ordner, den du gewählt hast, auf diesem Rechner | wer diesen Ordner öffnen kann | im Wissen oder in jedem Editor |
| Eine Notiz an einem Datensatz | im Arbeitsbereich, an einem Kunden, Projekt, einer Aufgabe … | alle, die diesen Datensatz sehen dürfen — Kollegen und der Agent eingeschlossen | am Datensatz |
| Die Firmenbeschreibung | Prozesse, Rollen und Richtlinien, im Arbeitsbereich | alle im Arbeitsbereich | in der App, zu der sie gehört — ein Prozess in Prozesse |
Ein Dokument in deinem Ordner
Zeigt das Wissen auf einen Ordner, sind eure Dokumente gewöhnliche Markdown-Dateien darin: in jedem Editor änderbar, vom Betriebssystem durchsuchbar, gesichert von dem, was diesen Ordner ohnehin sichert. Die Unterordner sind der Baum links.
Die Datei ist die Wahrheit, und sie ist die einzige Fassung. kyte speichert nichts darüber in der Datenbank. Darum wandert auch nichts davon zu deinen Kollegen oder zu einem Agenten auf einem Server: Der Ordner gehört diesem Rechner. Teilt euer Team den Ordner — ein Netzlaufwerk, ein Git-Repository —, sieht jeder dieselben Dateien, weil der Ordner geteilt ist, nicht weil kyte etwas kopiert.
kyte beobachtet den Ordner. Eine Datei, die du in einem anderen Editor änderst, aus dem Finder hineinziehst oder per Git holst, erscheint sofort. Ändert sich das Dokument, das du gerade offen hast, auf der Platte, während du tippst, entscheidet kyte nicht für dich: Es sagt es dir, und du wählst Datei laden oder Meine behalten.
Für diese Dokumente gibt es in kyte keinen Verlauf. Ein Ordner, der einen Verlauf will, ist ein Git-Repository.
Eine Notiz an einem Datensatz
An jedem Datensatz — einem Kunden, einem Projekt, einer Aufgabe — schreibt Wissen → + Neu eine Notiz über diesen Datensatz. Sie liegt im Arbeitsbereich, nicht in einem Ordner. Darum erreicht sie alle, die den Datensatz sehen dürfen, auch den Agenten auf einem Server. Sie hat einen Verlauf wie der Datensatz selbst.
Die Firmenbeschreibung
Wie die Firma arbeitet, so aufgeschrieben, dass Menschen und Agenten danach handeln können: ihre Prozesse, Rollen und Richtlinien. Ein Prozess ist ein Teil davon — du schreibst und startest ihn in Prozesse.
Ist der Ordner, den du gewählt hast, schon das Beschreibungs-Repository eurer Firma (er enthält eine
company.yaml), sind seine Dateien Dateien wie alle anderen: Du liest, änderst, benennst und
löschst sie im Wissen. kyte lässt stehen, was sie zur Beschreibung macht — die api:-Zeile, die
Kennung, den Verantwortlichen — und ändert nur den Titel und den Text, den du tippst. Soll eine
Änderung erst geprüft werden? Dann liegt der Ordner in git, und ihr committet wie gewohnt.
Eines schreiben
+ Neu für ein Dokument im ausgewählten Ordner, mit Titel und einem Text in Markdown. Ein Dokument
öffnen heißt, es zu bearbeiten — es gibt keinen Bearbeiten-Modus. Überschriften, Listen, Tabellen,
[[Verweise]] zwischen Dokumenten — derselbe Umfang, den auch das Gespräch darstellt.
Was der Agent damit macht
Er liest sie. „Was haben wir mit Northwind zur Rechnungsstellung vereinbart?" durchsucht die Dokumente, die du sehen darfst, und antwortet daraus, mit der Angabe, wo es steht. Der Agent auf deinem Rechner liest deinen Ordner; ein Agent auf einem Server sieht die Notizen an Datensätzen und die Firmenbeschreibung, nie deinen Ordner.
Er kann auch eines schreiben: „Schreib auf, was wir gerade entschieden haben, als Dokument ins Wissen." Das ist ein Schreibvorgang, wird dir also vorher gezeigt.
Was hierher gehört und was nicht
Das Wissen ist die Bibliothek der Firma. Ein Ordner, den du dem Agenten für eine Aufgabe gibst, ist eine Werkbank — siehe Einen Ordner freigeben.
Faustregel: Wenn ein Kollege es nächstes Jahr brauchen würde, gehört es hierher. Wenn es Gerüst für die heutige Aufgabe ist, nicht. Und wenn das ganze Team es braucht, schreib es als Notiz an den Datensatz, um den es geht, oder leg den Ordner dorthin, wo das Team ihn teilt.