Betreiben

Projektleitung

Kosten allein sagen wenig. Tokenwacht rechnet Kosten je Ergebnis — und stellt Ihre Prozesse selbst nach, wo es nichts am Ergebnis ändert. Wo es etwas ändern könnte, nur als Versuch auf einem Teil der Läufe, mit automatischem Rückbau.

Das Prinzip: gestuft

Stufe	Beispiele	Was Tokenwacht tut
ergebnisneutral	Vorlauf nach Tempo (nicht mehr vorbereiten als verbraucht wird), Cache-Marke aus, wo der Cache nie gelesen wird	stellt sofort um; als Ersparnis zählt nur, was Sie als verhindert melden (Vorlauf) bzw. jeder Aufruf ohne Cache-Schreiben — nie eine bloße Differenz zu vorher
Versuch	weniger Websuchen, weniger Aufwand	jeder zweite Lauf (fest je Laufname), Vergleich der Wirkung; fällt sie, nimmt Tokenwacht den Versuch selbst zurück, hält sie bei weniger Kosten, gilt er für alle
Freigabe	günstigeres Modell	nur ein Vorschlag; mit Ihrem Ja läuft er als Versuch mit demselben Rückbau
Hinweis	viele Läufe ohne Wirkung	zeigt es mit Betrag, ändert nichts
Eingriff	Bestand vor Zufuhr (der Mensch kommt nicht hinterher: die Zufuhr-Rolle arbeitet an der Qualität des Bestands statt an Neuem), Rolle ruht (Dauerschleife: Läufe ohne Wirkung)	wirkt sofort, zeitlich begrenzt, hebt sich von selbst auf, sobald der Anlass vorbei ist; Sie erlauben Eingriffe im Cockpit und nehmen jeden jederzeit zurück

Zwei Grenzen gelten immer: Tokenwacht setzt nie einen Wert über Ihrem eigenen Standard (nur weniger Suchen, weniger Aufwand, weniger Vorlauf), und ist Tokenwacht nicht erreichbar, gelten Ihre Standardwerte. Agenten auf der Schutzliste bekommen keine automatischen Versuche. Einstellen unter Cockpit › Projektleitung (gestuft, nur Vorschläge, aus).

1. Ergebnisse melden

Nach einem Lauf melden Sie unter dem Laufnamen (dem Wert aus X-TW-Run), was er bewirkt hat. Nur Zählwerte, keine Inhalte.

POST /v1/ergebnisse
Authorization: Bearer tw_live_…
{"ergebnisse": [
  {"lauf": "RECH-aa1a730c", "art": "lauf", "wert": "wirksam", "agent": "recherche", "projekt": "kunde-4711",
   "kennzahlen": {"ertrag": 6}, "arme": [{"massnahme": "…", "arm": "test"}]},
  {"lauf": "TEXT-3f2c9a10", "art": "entwurf", "wert": "verwendet"}
]}

art „lauf“: wirksam, leer oder fehler; art „entwurf“ (vorbereitete Texte, Pläne …): verwendet oder verworfen. Bis zu 500 je Aufruf; ein Ergebnis darf sich ändern (zuerst verworfen, später doch verwendet). kennzahlen.ertrag ist die Zahl, an der Versuche gemessen werden.

2. Vor dem Lauf fragen

Nennen Sie Ihre Standardwerte — Tokenwacht schlägt nur vor, was Sie umsetzen können:

POST /v1/steuerung
{"agent": "recherche", "laufart": "RECH", "projekt": "kunde-4711", "lauf": "RECH-aa1a730c",
 "parameter": {"web_search_max": 30, "effort": "high", "cache": true, "model": "claude-sonnet-5"}}

→ {"einstellungen": {"web_search_max": 14}, "arme": [{"massnahme": "…", "parameter": "web_search_max", "arm": "test"}], "gueltig_s": 300}

Übernehmen Sie nur, was innerhalb Ihrer Grenzen liegt, und geben Sie die arme mit dem Ergebnis zurück. Kurzes Zeitlimit (1–2 s) und bei jedem Fehler die eigenen Werte — die Steuerung darf nie einen Lauf aufhalten.

Die Laufart ist der Teil des Laufnamens vor dem Bindestrich (2–4 Großbuchstaben oder Ziffern, z. B. RECH-…, TEXT-…). Tokenwacht vergleicht nur Läufe derselben Art — wählen Sie sie so, dass gleiche Arbeit gleich heißt.

3. Wirkung melden

Eine Ersparnis rechnet Tokenwacht nie aus „vorher minus heute“ — ein Rückgang kann auch an Ihrem Budget, einem Ausfall oder Ihren eigenen Deckeln liegen. Was eine Maßnahme wirklich verhindert hat, sehen nur Sie. Beim Vorlauf: Hat der Vorrat einen Entwurf gesperrt, den Sie sonst geschrieben hätten, und wurde die Aufgabe danach ohne jeden Text erledigt, zählen Sie ihn je Tag und schicken den Stand mit jeder Steuerungsabfrage:

POST /v1/steuerung
{"agent": "schreiber", "laufart": "TEXT", …, "parameter": {"vorrat": null, "cache": true},
 "wirkung": {"vorrat_vermieden": {"2026-09-30": 0, "2026-10-01": 4}}}

Ein Tag zählt, sobald Sie nach seinem Ende gemeldet haben; ohne Meldung zählt er mit 0 €. Der erste, angebrochene Tag einer Maßnahme zählt nie.

4. Lage melden (für Eingriffe)

Damit Tokenwacht „Bestand vor Zufuhr" entscheiden kann, meldet Ihr System je Projekt und Tag seine Lage — Zahlen, nie Inhalte:

POST /v1/lage
{"projekt": "kunde-a",
 "werte": {"bestand_offen": 326, "bestand_tempo": 15.2, "bestand_reichweite_tage": 21,
           "zufuhr_je_tag": 4.5, "vorrat_tage": 9, "qualitaet_offen": 45},
 "rollen": {"zufuhr": {"agent": "a1-recherche", "laufart": "RL"}}}

Die Steuerung liefert dann modus (bestand oder ruhe) samt eingriff mit Enddatum und Grund — nur, wenn Sie modus: "normal" als Stellschraube anbieten. bestand heißt: keine neuen Datensätze, nur die Qualität der vorhandenen; ruhe heißt: keinen Lauf starten.

5. Der Projektmanager mit Modell

Einmal am Tag beurteilt ein Modell (Claude Fable 5.1, mit dem Schlüssel des Betreibers) Ihre Lage: Prozessbild, gemeldete Lage, Verlauf je Rolle, Maßnahmen und ihr Ausgang. Es sieht ausschließlich Zählwerte und Titel, nie Inhalte. Der Lagebericht steht im Cockpit und im Tagesbericht; Vorschläge kommen nur aus dem Maßnahmenkatalog und laufen durch dieselben Regeln, Grenzen und Freigaben wie alles andere — ein Eingriff braucht Belege in den Zahlen, sonst bleibt er Vorschlag. „Jetzt beurteilen" im Cockpit, höchstens dreimal am Tag.

Mit dem SDK

Das Python- und das Node-SDK (ab 0.2.0) bringen alles mit: steuerung() mit Zeitlimit und Ruhe nach Fehlern, pruefen() mit Ihren Grenzen (Mindestanteil der Suchen, höchstens eine Aufwandsstufe tiefer, ein Modell nur aus Ihrer Preisliste und nur billiger), ergebnis() und ergebnisse_melden() in Stapeln, Wirkung als Tageszähler.

with wacht.lauf(art="RECH") as lauf:
    st = wacht.steuerung({"effort": "high", "web_search_max": 30, "cache": True}, laufart="RECH", grenzen=Grenzen())
    werte = st.werte(standard)            # damit den Agenten aufrufen
wacht.ergebnisse_melden([wacht.ergebnis(lauf.id, "wirksam", kennzahlen={"ertrag": 3}, steuerung=st)])

Was im Cockpit steht

Das Prozessbild der letzten 14 Tage je Agent, Laufart und Projekt (Läufe, Kosten, Kosten je Erfolg, Kosten ohne Wirkung, Cache- und Suchverhalten), jede Maßnahme mit Begründung aus Ihren Zahlen, Stand der Messung und belegter Ersparnis. Eine Ersparnis, die ein zurückgenommener Versuch auf Kosten der Wirkung gebracht hat, zählt nicht.

← Regeln, Befunde, Alarme Modellplan →