Dry-Run-Modi für Agentenhandlungen: den Plan vor der Änderung zeigen

Ziel

Einem Agenten, und der ihn beaufsichtigenden Person, genau zeigen, was eine zustandsändernde Aktion bewirken würde, bevor sie es tut, unter Verwendung desselben Codepfads, der die Änderung später anwendet.

Voraussetzungen

Werkzeuge, die Planen von Anwenden trennen, oder die sich so umhüllen lassen. Etablierte Werkzeuge zeigen die Formen: rsync --dry-run führt einen Testlauf ohne jede Änderung aus; terraform plan ohne -out erzeugt, was die Dokumentation einen spekulativen Plan nennt, eine Beschreibung der Wirkung ohne jede Absicht, sie anzuwenden, während -out=FILE einen Plan speichert, den apply später ausführen kann; kubectl apply --dry-run=client gibt nur das Objekt aus, das gesendet würde, und --dry-run=server reicht die Anfrage ein, ohne die Ressource zu speichern; die Kubernetes-API-Dokumentation beschreibt den Dry-Run-Modus als Auswertung einer Anfrage durch die üblichen Stufen (Admission-Kette, Validierung, Merge-Konflikte) bis unmittelbar vor dem Speichern von Objekten, mit der Garantie, dass keine weiteren Nebenwirkungen auftreten.

Schritte

1. Jedem Werkzeug, das schreibt, löscht, sendet oder veröffentlicht, einen Parameter dry_run hinzufügen und ihn für den ersten Aufruf einer Session zum dokumentierten Standard machen. Die Werkzeugbeschreibung hält fest, dass das Ergebnis eines Dry Run ein Plan ist, keine Wirkung.
2. Den Plan in derselben Struktur wie das echte Ergebnis zurückgeben, plus einer Markierung ("applied": false), mit konkreten Objekten: den Dateipfaden und Hunks, den Datensatz-IDs und den Feldern, die sich ändern würden, den Empfängern, den Anzahlen. „Würde einige Zeilen aktualisieren" ist kein Plan.
3. Serverseitige Dry Runs bevorzugen, wo das Zielsystem sie anbietet; ein clientseitiger Plan sieht weder Berechtigungen noch Kontingente, Validierungsregeln oder gleichzeitige Änderungen.
4. Den Plan vor der Änderung verlangen: Der Host lehnt einen echten Aufruf ab, dessen Argumente nicht zuvor in derselben Session als Dry Run eingereicht wurden, oder leitet den Plan bei Aktionen oberhalb eines Schwellenwerts an ein menschliches Prüfgate weiter.
5. Mit denselben Argumenten anwenden, dann das echte Ergebnis gegen den Plan differenzieren und Unterschiede dem Agenten sowie dem Log sichtbar machen; eine Abweichung bedeutet, dass sich der Zustand zwischen Plan und Anwendung verändert hat oder die Plan-Logik fehlerhaft ist.
6. Plan und Ergebnis zusammen festhalten, damit eine Überprüfung sehen kann, was vorhergesagt wurde und was tatsächlich geschah.

Erwartetes Ergebnis

Jeder unumkehrbaren Aktion geht eine konkrete, überprüfbare Aussage über ihre Wirkung voraus, und Abweichungen zwischen beiden werden erkannt statt erst später entdeckt.

Grenzen und Prüfbasis

Ein Dry Run belegt, was das Werkzeug tun würde, nicht, was andere Systeme als Reaktion darauf tun werden (Webhooks, Trigger, nachgelagerte Jobs). Er schützt nicht vor einem Plan, der korrekt, aber unerwünscht ist; dafür sind Freigabegates und umkehrbare Aktionen da. Die Schrittfolge ist ein Vorschlag; es wird keine Verringerung der Fehlerrate behauptet.

Vorbedingungen beim Anwenden, Pläne nach Schwellenwert

Ein Plan und eine Anwendung sind zwei Aufrufe mit einer Lücke dazwischen, in der sich der Zustand verändern kann, sodass ein verpflichtender Dry Run vor jedem Schreibvorgang nichts über den Moment der Anwendung selbst beweist und bei risikoarmen Schreibvorgängen die Zahl der Aufrufe verdoppelt. Wo das Ziel es unterstützt, eine Vorbedingung für die Anwendung selbst verlangen: If-Match mit einem ETag, Kubernetes' resourceVersion, eine Dokumentversionsnummer oder ein gespeicherter Terraform-Plan, den apply ablehnt, wenn sich der Zustand geändert hat. Der Schreibvorgang scheitert dann atomar, wenn sich die Welt verändert hat, und der nachträgliche Vergleich wird zu einer Prüfung des Werkzeugs statt zur einzigen Verteidigung. Den verpflichtenden Plan für Aktionen ohne Weg zurück reservieren (Senden, Veröffentlichen, Löschen ohne Kopie) sowie für Massenaktionen oberhalb eines Grössenschwellenwerts; für alles andere bleibt der Dry Run auf Anfrage verfügbar.