Zum Inhalt springen
Ein persönliches Experiment · Alpha · Code noch nicht öffentlich · kein Angebot, kein Support Projektstatus →

Aktionskataloge

Vaicoa kennt Aktionen nur als Einträge in einem signierten Katalog. Niemand, weder Mensch noch Agent, kann etwas ausführen, das nicht darin steht. Jeder Eintrag legt fest:

  • die Parameter, als JSON Schema, das der Kern validiert;
  • die Risikoklasse: safe, routine, risky (und never in der Policy);
  • die Einschränkungen, CEL-Ausdrücke über die Parameter und den Zustand, den ein Modul liefert;
  • das verlangte Level dessen, der vorschlägt, und die Freigaberegel (das Quorum: wie viele Personen, welche Rollen, welches Level, welche Kanäle, wie lange die Freigabe gilt);
  • das Modul, das Zustand und Plan liefert, und den Executor, der sie ausführt (auf dem Node oder am Kern);
  • die Anzeige-Vorlage: wie die Freigabe auf jedem Gerät aussieht;
  • ob sie zerstörend ist (wer freigibt, wählt oder tippt dann zusätzlich das Ziel).

Das Format steht in der Referenz.

Version 2026.11.9 hat 74 Aktionen: 15 safe, 36 routine, 23 risky. Sie decken Podman-Umgebungen ab, Hosts (OS-Updates, Reboots, Isolation), k3s, Kubernetes-Workloads und -Volumes, Flux, Backups und Restores mit CloudNativePG, Cluster API, Server und Firewalls bei Hetzner Cloud, Forgejo (git.change, git.tag), Incidents und Alerts, Zugangsfreigaben, Zertifikate und Secrets, Restore-Übungen und Game Days. Dazu kommen fünf Playbooks: patch.window, release.rollout, incident.first_response, restore.drill und gameday.run (Betriebsprozesse).

Der Katalog ist mit dem Release-Schlüssel signiert und vom Kern und jedem Node gepinnt. Ein Node lehnt eine Op ab, deren Aktion nicht in seinem gepinnten Katalog steht.

Fünf Aktionen lesen nur: metrics.query, logs.query, traces.get, kube.get, kube.logs. Sie brauchen keine Freigabe und laufen sofort, sind aber eng gefasst: ein Lese-Budget pro Lauf, Schwärzung von Secrets, bevor die Antwort hinausgeht, und in einer Produktionsumgebung gar nichts, solange du Lese-Aktionen dort nicht einschaltest (agent-read). Das Audit hält fest, dass gelesen wurde und wie viel, nicht den Inhalt.

Eine Agent-Session sieht nur die Aktionen, die ihr Trigger erlaubt (mayPropose), als Tools von vaicoa-run. Name, Beschreibung und Eingabe-Schema kommen nur aus dem geprüften signierten Katalog, nie aus Text, den ein Agent oder ein Dritter beeinflussen kann; verifiziert die Signatur des Katalogs nicht, startet der MCP-Server nicht.

Eigene Aktionen liegen in einem internen Layer org.<name> neben dem eingebauten Katalog, signiert von den Ownern deines Teams und im Roster gepinnt. Ein Layer kann Aktionen und Playbooks hinzufügen; eine eingebaute kann er nicht ändern. Eine Layer-Aktion erscheint in der Freigabe als „aus Katalog org.…“. Kapitel 18 des Handbuchs führt eine durch (notify.send), von Hand und mit einem Coding-Agenten.

Bietet ein Provider einen MCP-Server an, entwirft vcx catalog import-mcp daraus einen Layer. Übernommen werden nur lesende Tools, als safe-Lese-Aktionen mit Budget und Schwärzung; Tools für beliebige Befehle oder SQL bleiben immer draußen. Der Entwurf ist ein Vorschlag: Verbindlich wird er erst mit den Signaturen deiner Owner. Ändert der Provider später ein Tool, markiert der Kern die Aktion als nicht verfügbar (MCP DRIFT) und lehnt sie ab, bis du einen neuen Layer signierst.