Cloud Intelligence™ CLI v2, pensata tanto per le persone quanto per gli agenti AI

La metà delle invocazioni di una CLI moderna arriva da un agente AI, non da una tastiera. `dci` v1.x è stata progettata quando le cose stavano diversamente, e si notava in entrambe le direzioni: le persone ricevevano output formattato per le macchine, e gli agenti output formattato per le persone. La v2.0, disponibile da oggi, ricostruisce il livello di output, la gestione degli errori e il contratto con le macchine. I comandi e l'API restano invariati.

Eseguendo un report mensile dei costi con la CLI v1.x si otteneva qualcosa di molto simile al dump piatto di un database. Una riga per ogni gruppo e periodo temporale, float grezzi come 239927.13841529994 e timestamp epoch. Un report in euro era identico a uno in dollari: ai tassi di cambio attuali, un modo semplice per riportare la spesa con un errore dell'8%. L'elenco delle anomalie comprimeva sedici colonne nella larghezza del terminale, troncava ogni cella e nascondeva l'unica colonna davvero necessaria: la data.

Per gli agenti AI era ancora peggio. Bastava un errore di battitura in un comando e la CLI stampava 258 righe di help, per poi uscire con codice 0, così lo script continuava come se nulla fosse. Inserendo un campo sconosciuto nel body di una query, la CLI lo ignorava silenziosamente e restituiva dati di report predefiniti, privi di qualsiasi relazione con l'SQL inviato, che un agente presentava come risposta con piena sicurezza. Una delete andata a buon fine veniva restituita incapsulata in un errore "retryable", quindi gli agenti ritentavano un'operazione già riuscita. E una query su 30 giorni raggruppata per servizio poteva riversare 7.500 righe, circa 120.000 token, direttamente nella context window dell'agente.

Cosa ottengono le persone con la CLI v2

I report vengono presentati in formato pivot per impostazione predefinita: gruppi per periodo, totali con simbolo di valuta, ordinati per spesa, con una colonna di trend, senza bisogno di flag. Il report a tre mesi e quattro servizi che prima era fatto di 12 righe di float intercalate è ora una tabella da incollare direttamente in una revisione di budget. I numeri portano con sé il simbolo della valuta, così un report in EUR finalmente sembra tale. Se i suoi script si basano su righe piatte, --flat le mantiene, con date leggibili e colonne allineate, e --raw-numbers ripristina i valori esatti quando servono.

Gli elenchi hanno ricevuto lo stesso trattamento. Le colonne di identità e data sopravvivono sempre all'adattamento alla larghezza del terminale, le colonne nascoste vengono indicate per nome insieme ai flag per ripristinarle, e i valori null appaiono come celle vuote invece di un letterale <nil>.

Gli errori vengono intercettati subito. dci list-bugets restituisce una sola riga, "did you mean list-budgets?", con exit code 2 su cui il suo script può agire. Un contesto cliente non valido viene rifiutato nel momento in cui lo si imposta, non tre comandi dopo sotto forma di un misterioso 403. Lo stesso errore corrisponde allo stesso exit code in ogni modalità.

Due novità collegano il terminale al resto del suo lavoro: dci open report <id> apre un deep link nella console, e dci query --output csv esporta direttamente in un foglio di calcolo.

Cosa ottengono gli agenti con l'aggiornamento

Per gli agenti AI, i cambiamenti si riducono a due aspetti: affidabilità e costi. I campi di richiesta sconosciuti ora falliscono con un errore strutturato e un suggerimento che rimanda allo schema, così una query malformata non può più restituire dati errati ma dall'aspetto plausibile. Le delete riuscite riportano un successo e gli errori lato client non vengono mai contrassegnati come retryable, il che pone fine ai loop di retry. Eseguire la CLI senza credenziali in CI restituisce un errore strutturato in circa 10 millisecondi, invece di restare in attesa di un login da browser che non si aprirà mai.

I costi in token sono diminuiti su tutta la linea. I risultati di grandi dimensioni sono limitati a 500 righe per impostazione predefinita, con il troncamento dichiarato esplicitamente e le istruzioni per restringere la query o aumentare il limite. Questo porta la risposta da 120.000 token a circa 9.500, una riduzione del 92%. L'output di --help si è ridotto dell'84%, con gli schemi completi di richiesta e risposta a un solo flag di distanza tramite --help-full. E --rows keyed restituisce oggetti con i nomi dello schema e un campo currency esplicito, così nessuno deve più contare le celle posizionali di un array per trovare il costo.

La provi subito

dci upgrade                # per ottenere la v2
dci skill <agent>          # aggiorna la skill integrata dell'agente
dci query --help-full      # gli schemi sono sempre lì quando servono

Il confronto completo prima/dopo, con output reali di entrambe le versioni, è disponibile nell'Help Center, insieme alla panoramica Novità della v2.