Cloud Intelligence™ CLI v2, pensada tanto para humanos como para agentes

Hoy, la mitad de las invocaciones de una CLI moderna provienen de un agente de IA, no de un teclado. `dci` v1.x se diseñó antes de que eso fuera realidad, y se notaba en ambas direcciones: los humanos recibían salidas con formato para máquinas, y los agentes, salidas con formato para humanos. La v2.0, disponible desde hoy, reconstruye la capa de salida, el manejo de errores y el contrato con las máquinas. Los comandos y la API no cambian.

Si ejecutabas un reporte mensual de costos en la CLI v1.x, obtenías algo muy parecido a un volcado plano de base de datos. Una fila por grupo por período, floats sin procesar como 239927.13841529994 y timestamps en formato epoch. Un reporte en euros se veía idéntico a uno en dólares, lo que al tipo de cambio actual es una forma fácil de reportar mal el gasto en un 8%. Al listar anomalías, se comprimían dieciséis columnas en el ancho de tu terminal, se truncaba cada celda y se ocultaba justo la columna que necesitabas: la fecha.

Para los agentes de IA era aún peor. Si escribías mal un comando, la CLI imprimía 258 líneas de ayuda y salía con código 0, así que el script seguía ejecutándose como si nada hubiera pasado. Si incluías un campo desconocido en el cuerpo de una consulta, la CLI lo ignoraba en silencio y devolvía datos de reporte por defecto sin relación alguna con tu SQL, que un agente presentaba como la respuesta con total confianza. Una eliminación exitosa venía envuelta en un error "retryable", así que los agentes reintentaban una operación que ya había tenido éxito. Y una consulta de 30 días agrupada por servicio podía volcar 7,500 filas, unos 120,000 tokens, directo a la ventana de contexto del agente.

Qué ganan los humanos con la CLI v2

Los reportes vienen pivoteados por defecto. Agrupación por período, totales con símbolo de moneda, ordenados por gasto y con una columna de tendencia, sin necesidad de flags. El reporte de tres meses y cuatro servicios que antes constaba de 12 filas intercaladas de floats ahora es una tabla que puedes pegar directamente en una revisión de presupuesto. Los números llevan su símbolo de moneda, así que un reporte en EUR por fin se ve como tal. Si tus scripts dependen de filas planas, --flat las conserva, con fechas legibles y columnas alineadas, y --raw-numbers restaura los valores exactos cuando los necesitas.

Los listados recibieron el mismo tratamiento. Las columnas de identidad y fecha siempre sobreviven al ajuste de ancho, las columnas ocultas se nombran junto con los flags para recuperarlas, y los valores nulos se muestran como celdas vacías en lugar de un <nil> literal.

Ante un error, la CLI falla rápido. dci list-bugets devuelve una sola línea, "¿quisiste decir list-budgets?", con código de salida 2 sobre el que tu script puede actuar. Un contexto de cliente inválido se rechaza en el momento en que lo configuras, no tres comandos después como un misterioso 403. La misma falla se traduce al mismo código de salida en todos los modos.

Dos novedades conectan la terminal con el resto de tu trabajo: dci open report <id> abre un enlace directo a la consola, y dci query --output csv exporta directamente a una hoja de cálculo.

Qué ganan los agentes con la actualización

Para los agentes de IA, los cambios se resumen en confianza y costo. Los campos desconocidos en las solicitudes ahora fallan con un error estructurado y una pista que apunta al esquema, así que una consulta mal formada ya no puede devolver datos incorrectos con apariencia plausible. Las eliminaciones exitosas reportan éxito, y los errores de cliente nunca se marcan como "retryable", lo que pone fin a los bucles de reintento. Ejecutar sin credenciales en CI devuelve un error estructurado en unos 10 milisegundos, en lugar de quedarse colgado en un inicio de sesión de navegador que nunca se abrirá.

Los costos en tokens bajaron en todos los frentes. Los resultados grandes se limitan a 500 filas por defecto, con el truncamiento indicado de forma explícita e instrucciones para acotar la consulta o subir el límite. Eso reduce la respuesta de 120,000 tokens a unos 9,500, una reducción del 92%. La salida de --help se redujo un 84%, con los esquemas completos de solicitud y respuesta a un solo flag de distancia vía --help-full. Y --rows keyed devuelve objetos nombrados según el esquema con un campo currency explícito, así que ya nadie tiene que contar celdas posicionales de un arreglo para encontrar el costo.

Pruébala

dci upgrade                # obtén la v2
dci skill <agent>          # actualiza la skill integrada del agente
dci query --help-full      # los esquemas siguen ahí cuando los necesites

La comparación completa del antes y el después, con salidas reales de ambas versiones, está en el Centro de ayuda, junto con el resumen de novedades de la v2.