Cloud Intelligence™ CLI v2, feita tanto para humanos quanto para agentes

Metade das invocações de uma CLI moderna vem de um agente de IA, não de um teclado. A `dci` v1.x foi projetada antes de isso ser realidade, e isso ficava evidente nos dois sentidos: humanos recebiam saída formatada para máquinas, e agentes recebiam saída formatada para humanos. A v2.0, lançada hoje, reconstrói a camada de saída, o tratamento de erros e o contrato com a máquina. Os comandos e a API continuam os mesmos.

Executar um relatório mensal de custos na CLI v1.x resultava em algo muito parecido com um dump cru de banco de dados. Uma linha por grupo, por período, floats brutos como 239927.13841529994 e timestamps em epoch. Um relatório em euros era idêntico a um em dólares, o que, com as taxas de câmbio atuais, é um jeito fácil de errar o gasto reportado em 8%. Listar anomalias espremia dezesseis colunas na largura do seu terminal, truncava todas as células e escondia justamente a coluna de que você precisava: a data.

Para os agentes de IA, a situação era ainda pior. Bastava errar a digitação de um comando para a CLI imprimir 258 linhas de ajuda e sair com código 0 — e o script seguia rodando como se nada tivesse acontecido. Um campo desconhecido no corpo de uma query era silenciosamente ignorado, e a CLI retornava dados de relatório padrão sem nenhuma relação com o seu SQL, que um agente apresentaria como resposta com total confiança. Uma exclusão bem-sucedida voltava embrulhada em um erro "retryable", fazendo os agentes repetirem uma operação que já tinha sido concluída. E uma query de 30 dias agrupada por serviço podia despejar 7.500 linhas, cerca de 120.000 tokens, direto na janela de contexto do agente.

O que os humanos ganham com a CLI v2

Os relatórios agora vêm pivotados por padrão. Grupos por período, totais com símbolo de moeda, ordenados por gasto e com uma coluna de tendência — sem precisar de nenhuma flag. Aquele relatório de três meses e quatro serviços, que antes eram 12 linhas intercaladas de floats, agora é uma tabela que você pode colar direto em uma revisão de orçamento. Os números carregam o símbolo da moeda, então um relatório em EUR finalmente parece um relatório em EUR. Se você tem scripts que dependem de linhas planas, --flat as mantém, com datas legíveis e colunas alinhadas, e --raw-numbers restaura os valores exatos quando você precisar.

As listagens receberam o mesmo tratamento. Colunas de identidade e data sempre sobrevivem ao ajuste de largura, colunas ocultas são nomeadas junto com as flags para trazê-las de volta, e valores nulos aparecem como células vazias em vez de um <nil> literal.

Erros falham na hora. dci list-bugets retorna uma única linha — "você quis dizer list-budgets?" — com código de saída 2, que seu script pode tratar. Um contexto de cliente inválido é rejeitado no momento em que você o define, e não três comandos depois na forma de um misterioso 403. A mesma falha gera o mesmo código de saída em todos os modos.

Duas novidades conectam o terminal ao resto do seu trabalho: dci open report <id> abre um link direto no console, e dci query --output csv exporta direto para uma planilha.

O que os agentes ganham com o upgrade

Para os agentes de IA, as mudanças se resumem a confiança e custo. Campos desconhecidos na requisição agora falham com um erro estruturado e uma dica apontando para o schema, então uma query malformada não consegue mais retornar dados errados com aparência plausível. Exclusões bem-sucedidas reportam sucesso, e erros de cliente nunca são marcados como "retryable", o que acaba com os loops de retry. Rodar sem credenciais em CI retorna um erro estruturado em cerca de 10 milissegundos, em vez de travar esperando um login de navegador que nunca vai abrir.

Os custos de tokens caíram de forma generalizada. Resultados grandes são limitados a 500 linhas por padrão, com o truncamento indicado explicitamente e instruções para refinar a query ou aumentar o limite. Isso reduz aquela resposta de 120.000 tokens para cerca de 9.500 — uma redução de 92%. A saída do --help encolheu 84%, com os schemas completos de requisição e resposta a uma flag de distância via --help-full. E --rows keyed retorna objetos nomeados conforme o schema, com um campo currency explícito, então nada mais precisa contar células por posição no array para encontrar o custo.

Experimente

dci upgrade                # instale a v2
dci skill <agent>          # atualize a skill de agente embutida
dci query --help-full      # os schemas continuam lá quando você precisar

A comparação completa do antes e depois, com saídas reais das duas versões, está na Central de Ajuda, junto com o resumo Novidades da v2.