• Hilfe · Loslegen

Dein Firmenordner

Deine Firma lebt in einem Ordner mit einfachen Textdateien: deine Richtung, deine Angebote, deine Stimme, deine Regeln, die Ziele jeder Abteilung und ihre Fähigkeiten. Deine KI liest ihn, um dein Geschäft zu kennen, und schreibt beim Arbeiten hinein.

Was im Ordner liegt

  • direction.md, company.json, brand.json und AGENTS.md: wer du bist und wie dein Büro läuft.
  • rules/: deine Stimme, deine Angebote, deine Firmendaten und deine Hausregeln.
  • departments/: die Seite jeder Abteilung, ihre Ziele und ihre Rollen.
  • skills/: die schriftlichen Anleitungen für jede Aufgabe, mit ihren Nachschlageseiten. Diese Hilfeseiten liegen auch dort, in skills/get-help/references/.

Lesen

read nimmt genau eines von path, list oder search. offset und version gehen nur zusammen mit path.

Eine Datei schreiben

  • Pfade enden auf .md oder .json. Nur templates/ darf auch .html-Dateien enthalten.
  • Ein Pfad nutzt nur Buchstaben, Ziffern und . _ - /, bis 200 Zeichen, ohne .. und ohne //.
  • Der Text einer Datei hat 1 bis 200.000 Zeichen.
  • write braucht alle vier: path, body, base_version und note.
  • base_version ist die Version, die read dir gegeben hat, oder 0 für eine neue Datei. Hat jemand die Datei inzwischen geändert, wird eine veraltete Version abgelehnt, und die Antwort nennt dir die aktuelle. Lies die Datei noch einmal und mach die Änderung neu.

Kerndateien brauchen ein Ja

Manche Dateien prägen die ganze Firma, darum ändern sie sich nur mit dem Ja des Inhabers: Deine KI schlägt die Änderung vor (propose mit kind file_change), und du sagst Ja. Die Kerndateien sind AGENTS.md, company.json, direction.md, brand.json, alles in rules/, templates/ und connectors/ und jede departments/<id>/goals.md.

Was nie in den Ordner kommt

  • Website-Dateien: Die Dateien unter sites/ ändern sich nur über deploy_site.
  • E-Mail-Adressen oder Telefonnummern von Kunden. Menschen kommen in deine Kontaktliste, andere Angaben in Einträge.
  • Schlüssel, Passwörter oder alles, was so aussieht.

Einträge

Einträge halten deine Geschäftsdaten in Modulen, etwa Zahlungen, Buchungen oder Seiten, damit dein Dashboard sie zeigen kann.

  • Ein Eintrag fasst bis zu 20.000 Zeichen Daten.
  • Wenn ein Modul seinen ersten Eintrag bekommt, nennt deine KI die Abteilung, zu der es gehört.
  • Um einen Eintrag zu ändern, braucht es die Version, die gelesen wurde. Eine veraltete wird abgelehnt.
  • Ein Modul fasst höchstens 5.000 Einträge.
  • Deine KI darf nur Einträge löschen, die Agenten geschrieben haben, und nur, während sie eine Aufgabe in der Abteilung dieses Moduls hält. Alles andere, etwa eine Buchung, ein Mitglied oder etwas, das ein Mensch geschrieben hat, löscht sie nur über einen record_delete-Vorschlag, der auf dein Ja wartet.