Cloud Intelligence™ CLI v2 – für Menschen und Agenten gleichermaßen

Die Hälfte aller Aufrufe eines modernen CLI stammt heute von einem KI-Agenten, nicht von einer Tastatur. `dci` v1.x wurde entwickelt, bevor das so war – und das merkte man in beide Richtungen: Menschen bekamen Ausgaben im Maschinenformat, und Agenten bekamen Ausgaben im Menschenformat. Das heute erscheinende v2.0 baut die Ausgabeschicht, die Fehlerbehandlung und den Kontrakt gegenüber Maschinen neu auf. Befehle und API bleiben unverändert.

Wer mit CLI v1.x einen monatlichen Kostenbericht abrief, bekam etwas, das einem flachen Datenbank-Dump glich. Eine Zeile pro Gruppe und Zeitraum, rohe Fließkommazahlen wie 239927.13841529994 und Epoch-Timestamps. Ein Bericht in Euro sah exakt so aus wie einer in Dollar – beim aktuellen Wechselkurs weist man die Ausgaben so schnell um 8 % falsch aus. Beim Auflisten von Anomalien wurden sechzehn Spalten in die Terminalbreite gequetscht, jede Zelle abgeschnitten – und ausgerechnet die eine Spalte, die man brauchte, das Datum, wurde ausgeblendet.

KI-Agenten traf es noch härter. Ein Tippfehler im Befehl, und das CLI gab 258 Zeilen Hilfe aus und beendete sich mit Exit-Code 0 – das Skript lief also weiter, als wäre nichts gewesen. Ein unbekanntes Feld im Query-Body wurde stillschweigend ignoriert, und das CLI lieferte Standard-Berichtsdaten zurück, die mit dem eigenen SQL nichts zu tun hatten – ein Agent präsentierte sie mit voller Überzeugung als die Antwort. Ein erfolgreicher Delete kam in einen "retryable"-Fehler verpackt zurück, sodass Agenten eine Operation wiederholten, die längst geglückt war. Und eine 30-Tage-Abfrage, gruppiert nach Service, konnte 7.500 Zeilen – rund 120.000 Tokens – ungebremst ins Kontextfenster des Agenten kippen.

Was Menschen mit CLI v2 bekommen

Berichte werden standardmäßig pivotiert. Gruppen im Zeitverlauf, Summen mit Währungssymbol, sortiert nach Ausgaben, inklusive Trend-Spalte – ganz ohne Flag. Der Bericht über drei Monate und vier Services, der früher aus 12 ineinander verschränkten Zeilen voller Fließkommazahlen bestand, ist jetzt eine Tabelle, die Sie direkt in ein Budget-Review einfügen können. Zahlen tragen ihr Währungssymbol – ein EUR-Bericht sieht endlich auch danach aus. Wer in Skripten mit flachen Zeilen arbeitet, behält sie mit --flat – jetzt mit lesbaren Datumsangaben und ausgerichteten Spalten. Und --raw-numbers liefert bei Bedarf wieder die exakten Werte.

Auflistungen wurden genauso überarbeitet. ID- und Datumsspalten überstehen die Breitenanpassung immer, ausgeblendete Spalten werden benannt – samt der Flags, um sie zurückzuholen – und Null-Werte erscheinen als leere Zellen statt als wörtliches <nil>.

Fehleingaben scheitern sofort. dci list-bugets liefert eine einzige Zeile – "did you mean list-budgets?" – mit Exit-Code 2, auf den Ihr Skript reagieren kann. Ein ungültiger Kundenkontext wird in dem Moment abgelehnt, in dem Sie ihn setzen – nicht erst drei Befehle später als rätselhafter 403. Derselbe Fehler führt in jedem Modus zum selben Exit-Code.

Zwei Neuerungen verbinden das Terminal mit dem Rest Ihrer Arbeit: dci open report <id> verlinkt direkt in die Konsole, und dci query --output csv exportiert geradewegs in die Tabellenkalkulation.

Was Agenten mit dem Upgrade bekommen

Für KI-Agenten laufen die Änderungen auf zwei Dinge hinaus: Vertrauen und Kosten. Unbekannte Request-Felder schlagen jetzt mit einem strukturierten Fehler und einem Hinweis auf das Schema fehl – eine fehlerhafte Abfrage kann also keine plausibel wirkenden, aber falschen Daten mehr zurückgeben. Erfolgreiche Deletes melden Erfolg, und Client-Fehler werden nie als retryable markiert – das beendet die Retry-Schleifen. Läuft das CLI in der CI ohne Zugangsdaten, kommt in rund 10 Millisekunden ein strukturierter Fehler zurück, statt an einem Browser-Login zu hängen, der sich nie öffnen wird.

Die Token-Kosten sind auf ganzer Linie gesunken. Große Ergebnisse sind standardmäßig auf 500 Zeilen begrenzt; die Kürzung wird explizit ausgewiesen, samt Anleitung, die Abfrage einzugrenzen oder das Limit zu erhöhen. Aus der 120.000-Token-Antwort werden so rund 9.500 – eine Reduktion um 92 %. Die --help-Ausgabe ist um 84 % geschrumpft; die vollständigen Request- und Response-Schemata sind über --help-full nur ein Flag entfernt. Und --rows keyed liefert Objekte mit Schema-Namen und einem expliziten currency-Feld – niemand muss mehr Array-Positionen abzählen, um die Kosten zu finden.

Probieren Sie es aus

dci upgrade                # v2 installieren
dci skill <agent>          # den eingebetteten Agenten-Skill aktualisieren
dci query --help-full      # die Schemata sind weiterhin da, wenn Sie sie brauchen

Den vollständigen Vorher-Nachher-Vergleich mit echten Ausgaben beider Versionen finden Sie im Help Center, zusammen mit dem Überblick What's new in v2.