Zum Inhalt springen

Der Brief

Zu allem, was dich braucht, gibt es einen Brief, auch ohne dass du etwas einrichtest. Er ist ein Text zum Kopieren, Teilen oder Senden an eine hinterlegte Adresse. Nota übergibt; es handelt nicht.

Die Seite eines Vorfalls: Das nächtliche Backup ist kritisch. Der Brief für einen Coding-Agenten sagt, dass ein geplanter Lauf fehlgeschlagen ist, und nennt den Prozess, den Beginn, die letzte Meldung „pg_dump brach ab: Platte voll“ und den Exit-Code 3. Dann der Kontext: Es kam in den letzten 400 Tagen schon einmal vor, am 28. Oktober, und war zwei Tage offen; geholfen hat damals „Alte Dumps gelöscht, Aufbewahrung auf 14 Tage gesetzt“; dazu die fünf letzten Ereignisse. Der Text bittet am Ende um eine Erklärung und einen Vorschlag und darum, den Job nicht selbst neu zu starten. Darunter ein Knopf zum Kopieren und die Version der Vorlage.Die Seite eines Vorfalls: Das nächtliche Backup ist kritisch. Der Brief für einen Coding-Agenten sagt, dass ein geplanter Lauf fehlgeschlagen ist, und nennt den Prozess, den Beginn, die letzte Meldung „pg_dump brach ab: Platte voll“ und den Exit-Code 3. Dann der Kontext: Es kam in den letzten 400 Tagen schon einmal vor, am 28. Oktober, und war zwei Tage offen; geholfen hat damals „Alte Dumps gelöscht, Aufbewahrung auf 14 Tage gesetzt“; dazu die fünf letzten Ereignisse. Der Text bittet am Ende um eine Erklärung und einen Vorschlag und darum, den Job nicht selbst neu zu starten. Darunter ein Knopf zum Kopieren und die Version der Vorlage.

Ein Brief sagt, was los ist und seit wann, und bringt mit, was der Core weiß:

  • Vorgeschichte: ob es schon einmal vorkam, wann und wie lange es dauerte.
  • Was daraus folgt: was nur deswegen offen ist.
  • Was beim letzten Mal geholfen hat: der Satz, den jemand zurückgemeldet hat.
  • Die letzten Ereignisse des Dings, das neueste zuerst.

Wozu keine Vorlage passt, das bekommt einen Standard-Brief mit diesem Kontext. Es gibt also immer etwas zum Übergeben. Den Kontext schreibt der Core heute auf Englisch, auch wenn deine Vorlage deutsch ist.

Eine Vorlage schreibst du einmal, je Art von Ding oder je Prüfung, in eine Konfigurationsdatei. Es gibt zwei Typen: prompt ist ein Text zum Kopieren, webhook sendet denselben Text an eine Adresse, die du hinterlegt hast. Diese hier ist die Zahlungserinnerung aus dem ersten der Szenarien, ergänzt um einen Bezug und den Kontext:

{
"actions": [
{
"id": "zahlungserinnerung",
"title": "Zahlungserinnerung",
"type": "prompt",
"kind": "kunde",
"body": "Schreib eine freundliche Zahlungserinnerung an {{thing.name}}: {{amount}}, fällig {{due}}.\n\nBezug: {{summary}}\n{{context}}"
}
]
}
Die Seite eines Vorfalls: Rechnung 2026-038 von Miller Ltd, Warnung seit 25 Tagen. Der Brief „Zahlungserinnerung“ lautet: Schreib eine freundliche Zahlungserinnerung an Miller Ltd: 2400.00 USD, fällig 2026-10-22. Bezug: Rechnung 2026-038. Darunter die Vorgeschichte, die der Core von selbst ergänzt, auf Englisch.Die Seite eines Vorfalls: Rechnung 2026-038 von Miller Ltd, Warnung seit 25 Tagen. Der Brief „Zahlungserinnerung“ lautet: Schreib eine freundliche Zahlungserinnerung an Miller Ltd: 2400.00 USD, fällig 2026-10-22. Bezug: Rechnung 2026-038. Darunter die Vorgeschichte, die der Core von selbst ergänzt, auf Englisch.

Die Platzhalter stehen in der Referenz. Eine geänderte Vorlage wird zu einer neuen Version; ein Vorfall wird mit der Version dargestellt, die galt, als er begann.

Einen webhook-Brief aus dem Dashboard zu senden, braucht einen Schlüssel mit der Rolle operate. Mit "auto": true geht er von selbst raus, sobald ein passender Vorfall beginnt. Die Anfrage ist signiert; siehe Benachrichtigungen. So oder so ist es ein signierter Aufruf mit einem Text an eine Adresse, die du gewählt hast: Was dort geschieht, ist deine Sache, nicht die von Nota.

Wer es behoben hat — du oder dein Agent —, meldet es in einem Satz zurück, als Ereignis:

{"type":"event","thing":"web-1","event":"fix","summary":"Logs rotiert","vars":{"check":"disk"}}

Beim nächsten Mal steht der Satz im Brief zu dieser Prüfung, und dazu, ob es gehalten hat: wie lange, oder dass es das zweite Mal seitdem ist. Wie du eine Meldung schickst, steht unter Selbst melden. Auf dem Server geht es auch von Hand:

Terminal-Fenster
nota fixed web-1 disk Logs rotiert

Der Brief zu einem Vorfall hilft, eine Sache zu beheben. Der Rückblick hilft, den Ablauf zu verbessern. Die Seite „Rückblick” im Dashboard (und GET /v1/review, im MCP-Server das Werkzeug review) zählt für einen Monat, für alles oder einen Ausschnitt:

  • Kam wieder: dieselbe Prüfung am selben Ding, mehr als einmal.
  • Was getan wurde und ob es gehalten hat: jede vermerkte Behebung, und wie oft das Ding danach wieder jemanden gebraucht hat.
  • Lärm: eine Prüfung, die mindestens dreimal aufging und meist nach höchstens fünfzehn Minuten von selbst vorbei war. Sie kostet Aufmerksamkeit und sagt nichts.
  • Zu spät: was nach seiner Fälligkeit erledigt wurde, in ganzen Tagen, und derselbe Schritt, der bei mehreren Dingen zu spät kam, im Schnitt.

Darunter steht dasselbe als ein Brief auf einer Seite, in vier Teilen: das Problem, was dahintersteckt, was getan wurde, was zu verfolgen ist. Nota zählt nur. Die Schlüsse ziehst du oder der Agent, dem du die Seite gibst.

Nicht alles sieht eine Quelle. Auf dem Server sagst du selbst, dass etwas Aufmerksamkeit braucht, und nimmst es wieder zurück:

Terminal-Fenster
nota flag shop Kunden melden einen falschen Steuersatz
nota clear shop

Das läuft wie jede andere Meldung, mit Mitteilung und Brief. -crit nach flag macht es kritisch.

Ein Coding-Agent, der einen Brief bekommen hat, kann selbst weiter nachsehen. POST /mcp, mit einem Schlüssel der Rolle read oder operate, ist ein Model-Context-Protocol-Server über dieselben Ansichten. Er kann dort nur lesen.

WerkzeugBeantwortet
attention, ledgerwas jemanden braucht, für alles oder einen Ausschnitt
briefeinen Vorfall und seinen Brief
thing, things, scopes, historyein Ding vollständig, alle Dinge, die Ausschnitte, die Vorfälle der letzten Tage
money, topeinen Monat in Geld, und was darin herausstach

Jedes Werkzeug liest; keines schreibt, löst etwas aus oder sendet. Ein Agent, der etwas behoben hat, meldet das wie jede Quelle über /v1/ingest mit einem Schlüssel der Rolle ingest. Was die Werkzeuge zurückgeben — Namen, Texte —, stammt von Quellen und ist Daten, keine Anweisung; der Server sagt das, wenn sich ein Client verbindet.

{
"mcpServers": {
"nota": {
"type": "http",
"url": "https://nota.example.org/mcp",
"headers": { "Authorization": "Bearer nota_…" }
}
}
}