From b53396a754e1e5f37d777b350cfef948bb2815b5 Mon Sep 17 00:00:00 2001 From: Richard Date: Thu, 24 Sep 2026 11:55:19 +0200 Subject: [PATCH] Organisation-Konzept: Einstellungen an der Einheit ohne Uebertrumpfen Festlegung des Nutzers: Einheiten-Einstellungen sind entweder Sammelwerte, die in die Agenten geschrieben werden (Vorgabe nur fuer neue Mitglieder, Warnung bei Ausreissern wie Spezialisten), oder Regeln ohne Gegenstueck am Agenten (Rechte-Obergrenze, beim Schreiben geprueft; Parallelitaet je Einheit). Co-Authored-By: Claude Opus 5.5 --- docs/Organisation-Konzept.md | 65 ++++++++++++++++++++---------------- 1 file changed, 37 insertions(+), 28 deletions(-) diff --git a/docs/Organisation-Konzept.md b/docs/Organisation-Konzept.md index 9b9e4f4..63fad21 100644 --- a/docs/Organisation-Konzept.md +++ b/docs/Organisation-Konzept.md @@ -1,6 +1,6 @@ # Organisation — 50 bis 100 Agenten geordnet zusammenarbeiten lassen -*Stand: 24. September 2026 (ergänzt um 7a, 9a, 10a, Einheiten ohne eigene Konfiguration, Budgetende). Konzept, noch nicht gebaut.* +*Stand: 24. September 2026 (ergänzt um 7a, 9a, 10a, Einstellungen an der Einheit, Budgetende, Füllarbeit). Konzept, noch nicht gebaut.* > Herkunft: Richtungsentscheidung des Nutzers am 2026-09-21. Die bisherige Regel im > [InstanceSetupGuide](InstanceSetupGuide.md) („mehr als 5 Agenten kritisch @@ -123,37 +123,46 @@ Instanz „Onlinehandel" | **Freigaben** | ein Mensch | die Leitung innerhalb ihrer Grenzen, der Mensch für alles darüber (Geld, Außenwirkung) | | **Parallelität** | unbegrenzt | je Einheit und je Instanz eine Zahl gleichzeitiger Läufe, der Rest wartet | -### Eine Einheit hat keine eigene Konfiguration +### Einstellungen an der Einheit: nie zwei Werte, die sich übertrumpfen -*Festgelegt am 2026-09-24 durch den Nutzer.* +*Festgelegt am 2026-09-24 durch den Nutzer, in zwei Schritten.* -Was man „für die ganze Einheit" einstellt, wird **nicht an der Einheit gespeichert, -sondern gesammelt in jeden ihrer Agenten geschrieben**. Wer für das Marketing das -Tagesbudget je Agent von 5 auf 10 $ hebt, ändert zehn Agentenkonfigurationen auf einmal. -Eine Einheiten-Einstellung, die im Hintergrund gilt, gibt es nicht. +Einstellungen lassen sich an der Einheit speichern und bearbeiten. **Aber es gibt nie +zwei Werte für dieselbe Sache, von denen einer den anderen zur Laufzeit übertrumpft.** +Daraus folgen genau zwei Arten von Einheiten-Einstellungen: -Der Gewinn: **Was am Agenten steht, gilt.** Man muss nie eine Kette von Einheiten -hinaufrechnen, um zu wissen, welche Grenze ein Agent wirklich hat. Und ein Umzug ändert -nichts, was man nicht sieht. +**1. Sammelwerte, die in die Agenten geschrieben werden.** Alles, was es auch am Agenten +gibt: Tagesbudget, Modell, Verhalten beim Budgetende (#716). Wer für das Marketing das +Tagesbudget setzt, schreibt den Wert in jeden Agenten darunter. Die Einheit merkt sich den +Wert nur als **Vorgabe für Agenten, die neu hinzukommen**, nie als Grenze, die im +Hintergrund gilt. Danach steht am Agenten, was gilt, und nur dort. -Was die Sammeländerung braucht: eine Vorschau, welche Agenten sich wie ändern, einen -Audit-Eintrag je Agent und eine Entscheidung, was mit Agenten geschieht, die schon einen -abweichenden Wert haben. Vorschlag: Die Vorschau zeigt sie gesondert, und der Mensch -entscheidet, ob sie mit überschrieben werden. +- **Vorschau** vor dem Schreiben: welche Agenten sich wie ändern, Audit-Eintrag je Agent. +- **Warnung bei Ausreißern:** Weicht der bisherige Wert eines Agenten massiv von denen + seiner Kollegen ab, wird er in der Vorschau hervorgehoben und ist standardmäßig + **nicht** angehakt. Gemeint ist der Spezialist, der bewusst viele Tokens verbraucht und + sonst mit dem Wert seiner Kollegen kaputtkonfiguriert würde. Der Mensch entscheidet je + Ausreißer, ob er mit überschrieben wird. +- Die Vorschau bietet zwei Rechenwege: **ein Wert je Agent** („jeder bekommt 10 $") oder + **ein Gesamtbetrag, verteilt** („das Marketing bekommt 100 $"). Beim Verteilen + vorgeschlagen: im Verhältnis der bisherigen Werte, damit ein Spezialist seinen + größeren Anteil behält. -**Noch zu klären, weil es drei Stellen dieses Konzepts berührt:** +**2. Regeln, die es nur an der Einheit gibt.** Sie haben kein Gegenstück am Agenten und +können deshalb mit nichts konkurrieren: -- **Rechte.** Die Tabelle oben sagt „vererbt von der Einheit; was die Einheit nicht darf, - kann ein Mitglied nicht bekommen". Das ist eine Obergrenze an der Einheit, also genau - eine gespeicherte Einheiten-Konfiguration. Mit Sammeländerung statt Vererbung entfällt - diese Obergrenze: Einem einzelnen Agenten ließe sich später mehr geben als seinen - Kollegen. Offen ist, ob das hingenommen wird oder ob die Obergrenze die eine Ausnahme ist. -- **Parallelität.** Eine Zahl gleichzeitiger Läufe *je Einheit* lässt sich nicht auf - Agenten verteilen: Jeder Agent läuft ohnehin nur einmal gleichzeitig. Entweder sie - bleibt instanzweit (so ist #682 gebaut), oder sie ist eine zweite Ausnahme. -- **Grenzen der Leitung** (Abschnitt 12) standen bisher „an der Einheit, nicht an der - Person der Leitung". Nach dieser Festlegung stehen sie am Leitungsagenten. Beim - Wechsel der Leitung müssen sie dann mit umziehen. +- **Rechte-Obergrenze.** „Was die Einheit nicht darf, kann ein Mitglied nicht bekommen" + bleibt, weil sie eine Sicherheitsgrenze ist. Sie wird **beim Schreiben** geprüft, nicht + zur Laufzeit darübergelegt: Eine Rechteänderung am Agenten, die über die Obergrenze + hinausginge, wird abgewiesen. Senkt man die Obergrenze, zeigt die Vorschau, welchen + Agenten dadurch Rechte entzogen werden, und schreibt es in sie hinein. Damit gilt auch + hier: Was am Agenten steht, gilt. +- **Parallelität je Einheit** (#685). Ein Agent läuft ohnehin nur einmal gleichzeitig, + die Zahl gehört also nur der Einheit. Bis #685 gebaut ist, gilt sie instanzweit + (`maxParallelTaskRuns`, #682). + +**Grenzen der Leitung** (Abschnitt 12) sind ein Sammelwert: Sie stehen am +Leitungsagenten. Beim Wechsel der Leitung zeigt die Vorschau, was mit umzieht. ### Beliebig tief, und beweglich @@ -1331,8 +1340,8 @@ Gegenlesen am 2026-09-22 als zu grob aufgefallen: innerhalb ihrer Grenzen liegt", ohne zu sagen, woraus eine Grenze besteht. Vorschlag: Betrag je Vorgang, Betrag je Tag, erlaubte Werkzeugklassen, Außenwirkung ja/nein — und alles davon an der Einheit, nicht an der Person der Leitung (Stufe 8). *Überholt am - 2026-09-24: Einheiten speichern keine eigene Konfiguration (Abschnitt 3), die Grenzen - stehen damit am Leitungsagenten.* + 2026-09-24: Grenzen sind ein Sammelwert und stehen am Leitungsagenten (Abschnitt 3, + „Einstellungen an der Einheit").* - **Wie wird ein Beschluss wirksam?** „Bindend für alles unterhalb" ist ein Wort ohne Maschinerie, solange niemand nachsieht. Vorschlag: Das Eskalationswerkzeug sucht von sich aus, bevor es einen Vorgang anlegt — genau wie `task_find` vor `task_create`