Zum Inhalt springen
Farbschema wählenSprache wählen

Autonomie und die Delivery-Engine

Die Autonome Delivery-Engine macht aus einer einzigen Zahl pro Scope — der Autonomiestufe, einer Ganzzahl von 0 bis 100 — eine vollständige Verhaltensrichtlinie dafür, wie selbstständig SupaCloud Arbeit aufnehmen, dir Fragen stellen und Ergebnisse mergen darf. Ein Schieberegler steuert alle Achsen zugleich, sodass du über ein einziges Stellrad nachdenkst statt über eine Tafel voneinander unabhängiger Schalter.

Diese Seite erklärt, was die Stufe bedeutet, was jede benannte Stufe freischaltet und wie die von dir gesetzte Stufe in die Richtlinie aufgelöst wird, nach der ein Run tatsächlich handelt.

Die Autonomiestufe bildet sich — nach einer festen, reinen Regel — auf vier Verhaltensweisen ab, die zusammen die Richtlinie für einen Run ergeben:

Auslösung

Ob die Engine überhaupt von sich aus Arbeit aufnehmen darf. Unterhalb der Stufe Assistiert löst die Engine niemals automatisch aus — Arbeit beginnt nur, wenn du sie manuell auslöst.

Rückfragen (Klärungs-Gate)

Wie bereitwillig ein Agent vor einem Werkzeugaufruf für eine Rückfrage pausiert: vor jedem markierten Werkzeug, nur vor riskanten Werkzeugen oder nie.

Aufwand

Ein Anstoß für den Modell-Aufwands-Router — sparsam, ausgewogen oder großzügig — sodass höhere Autonomie bei schwierigerer Arbeit auch freigiebiger investieren darf. Diese Achse ist heute nur eine Vorschau: Sie wird aufgelöst und festgehalten, aber vom Router noch nicht ausgewertet (der Routing-Aufwand wird derzeit aus der Schwere des Eintrags abgeleitet).

Merge-Obergrenze

Wie weit die Engine eine Änderung treiben darf: einen Pull Request öffnen und stoppen, automatisch mergen, sobald die CI grün ist, oder vollautomatisch mergen. Dies ist eine Obergrenze — sie kann die eigene Merge-Einstellung eines Projekts nur einschränken, niemals erhöhen.

Die Abbildung ist monoton: Wenn du die Stufe anhebst, wird die Auslösung aktiviert und bleibt aktiv, das Klärungs-Gate wird nur lockerer, der Aufwands-Bias steigt nur, und die Merge-Obergrenze wird nur weiter. Du bekommst nie eine überraschende Mischung, bei der mehr Autonomie etwas verschärft.

Der Schieberegler rastet an fünf beschrifteten Stufen ein. Jede Stufe ist eine Stufe (ein Zahlenwert), und die Richtlinie ergibt sich daraus, was diese Stufe auflöst.

Stufe Wert Auslösung Rückfragen Aufwand Merge-Obergrenze
Manuell 0 Nur manuell Jedes markierte Werkzeug Sparsam Nur Pull Request
Assistiert 25 An (manuelle Auslösung) Nur riskante Werkzeuge Sparsam Nur Pull Request
Überwacht 50 An Nur riskante Werkzeuge Ausgewogen Auto-Merge bei grün
Autonom 75 An Nur riskante Werkzeuge Großzügig Auto-Merge bei grün
Entfesselt 100 An Nie Großzügig Vollautomatisches Merge
  • Manuell — Es wird nichts automatisch ausgelöst; der Agent fragt vor jedem markierten Werkzeug nach. Du behältst die volle Kontrolle.
  • Assistiert — Die Engine darf auslösen, aber nur, wenn du sie auslöst; der Agent fragt weiterhin vor riskanten Werkzeugen nach, und Änderungen stoppen bei einem Pull Request.
  • Überwacht — Die Engine löst von sich aus aus und fragt nur vor riskanten Werkzeugen nach; sie merged automatisch, sobald die CI grün ist.
  • Autonom — Die Engine löst aus und arbeitet großzügig, fragt nur vor riskanten Werkzeugen nach und merged automatisch bei grün.
  • Entfesselt — Volle Autonomie: keine Rückfragen vom Schieberegler und vollautomatisches Merge.

Autonomie wird nicht an einer einzigen globalen Stelle gesetzt. Sie wird pro Scope gesetzt, und eine Aufgabe löst ihre Stufe auf, indem sie die Scope-Kette durchläuft und die erste explizit gesetzte Stufe nimmt:

Agentprofil → Projekt → Arbeitsbereich

Die Stufe des Arbeitsbereichs hat immer einen konkreten Wert (Standard 0), sodass die Kette immer terminiert — darunter gibt es keinen impliziten Rückfall. Ein Projekt oder Agentprofil, das seine Stufe nicht setzt, erbt schlicht den nächsthöheren Scope. Wenn du eine Stufe auf einem engeren Scope setzt, überschreibt sie die breiteren für Aufgaben in diesem Scope.

Der Schieberegler jedes Scopes zeigt dir genau, woher sein effektiver Wert kommt — etwa „Erbt von Arbeitsbereich = 50“, wenn der Scope selbst nicht gesetzt ist, oder „Hier gesetzt: 75“, wenn er einen eigenen Wert hat.

Nachdem die Kette eine Stufe ausgewählt hat, können zwei harte Obergrenzen sie nur noch senken — die effektive Stufe ist das Minimum aus der gesetzten Stufe und beiden Obergrenzen.

Die Tarifobergrenze. Autonomie ist eine Berechtigung, die — wie jede andere Funktion — durch deinen Tarif und die Deployment-Edition gesteuert wird (die Berechtigung autonomy.level_max). Ein Tarif, der etwa Stufe 50 gewährt, bedeutet, dass der Schieberegler keine Stufe über Überwacht auswählen kann, egal was ein Scope anfordert. Das Gate ist fail-closed: Ein Tarif, der nichts gewährt, löst zu 0 auf. Eine Instanz der Enterprise-Edition löst automatisch zur vollen Obergrenze auf.

Die Onboarding-Begrenzung. Solange ein Arbeitsbereich im Onboarding-Modus ist, wird die effektive Stufe auf 25 begrenzt (das Band Assistiert). Das gibt einem neuen Arbeitsbereich einen bewusst vorsichtigen Start — die Engine löst nicht automatisch aus und Merges bleiben bei „nur Pull Request“ — bis der Arbeitsbereich das Onboarding abschließt.

Wenn eine der Obergrenzen tatsächlich greift, sagt der Schieberegler es: „Durch Tarif begrenzt: 50“ oder „Während Onboarding begrenzt: 25“, neben der aufgelösten „Effektiv“-Stufe.

Für die Feinsteuerung hat der Schieberegler jedes Scopes ein Feld Erweiterte Überschreibungen. Die dortige Stufen-Überschreibung setzt eine explizite Zahl, die den Rastpunkt des Schiebereglers übersteuert — nützlich, wenn du einen Wert zwischen zwei benannten Stufen möchtest —, ist aber weiterhin durch beide Obergrenzen gedeckelt. Überschreibungen pro Achse (für die einzelnen Verhalten Auslösung, Rückfragen, Aufwand oder Merge) komponieren entlang derselben Scope-Kette nach dem Prinzip „spezifischster gewinnt“, und die Merge-Achse bleibt eine Obergrenze: Eine Überschreibung kann die eigene Merge-Richtlinie eines Projekts nur einschränken, nie erhöhen.

Jeder Standardwert weist von Überraschungen weg:

  • Ein brandneuer Arbeitsbereich startet bei Stufe 0 — es wird nichts von selbst ausgelöst.
  • Das Onboarding begrenzt die effektive Stufe auf 25, sodass selbst eine ehrgeizige Konfiguration nicht unbeaufsichtigt läuft, bevor du bereit bist.
  • Die Tarifobergrenze ist fail-closed: fehlende oder nicht interpretierbare Berechtigungen lösen zu 0 auf, nicht zu voller Autonomie.
  • Die Merge-Achse ist eine Obergrenze. Mehr Autonomie kann die Engine niemals aggressiver mergen lassen, als es die eigene Merge-Einstellung eines Projekts bereits erlaubt.
  • Die harte Deploy-Bestätigung ist vom Schieberegler unabhängig und gilt immer.

Die Richtlinie, die ein Run verwendet, wird beim Start als Momentaufnahme festgehalten, sodass eine Aufgabe immer mit der Autonomie handelt, die du beim Starten konfiguriert hattest — spätere Änderungen am Schieberegler ändern einen laufenden Run nicht rückwirkend.