Saltar al contenido

Diagnóstico de Build con IA

Los logs de Native Build son largos. Cuando falla un build de iOS (Xcode / Fastlane) o Android (Gradle / Fastlane), Capgo puede pasar el log por un ingeniero de build con IA que identifica exactamente qué falló y cómo solucionarlo — para que no tengas que desplazarte por miles de líneas tú mismo.

Añadir --ai-analytics a tu build:

Ventana de terminal
bunx @capgo/cli@latest build request com.example.app --platform android --ai-analytics

El diagnóstico solo se activa cuando un build falla — los builds exitosos no se modifican.

Lo que ocurre en un build fallido depende de dónde lo ejecutes y si pasaste la flag:

Entorno--ai-analyticsComportamiento
Terminal interactivasíDiagnostica el fallo de inmediato
Terminal interactivanoPregunta primero y luego ofrece el diagnóstico
CI / no interactivoyesSe ejecuta automáticamente e imprime el diagnóstico en stderr
CI / no interactivonoOmitido — no se envía nada

Así que en CI debes activarlo con --ai-analytics; en una terminal siempre se pregunta primero, a menos que la flag te active previamente.

Un informe breve y enfocado en markdown:

  • Causa probable — una sola frase.
  • Evidencia — las 1–3 líneas más relevantes de tu log.
  • Solución sugerida — pasos numerados para cambiar en el tus proyecto (configuración de firma, una capability faltante, un problema de Gradle o CocoaPods, un conflicto de plugins, …).

Si los logs son ambiguos, lo indica y enumera las hipótesis principales en lugar de inventar un error inexistente.

El diagnóstico de IA es opcional — no se envía nada a menos que pases --ai-analytics o confirmes el prompt.

  • Capgo AI (por defecto): tu build log se recorta y se envía al endpoint de análisis de Capgo (que se ejecuta en Cloudflare Workers AI) solo el tiempo necesario para generar el diagnóstico. Los build logs no forman parte del almacenamiento normal: se transmiten a tu terminal durante el build.
  • Mantén los logs en tu máquina: en una terminal interactiva puedes hacer que CLI escriba un archivo de prompt local —las mismas instrucciones de diagnóstico junto con tu log— que pegas en tu propio LLM. Tus logs nunca salen de tu máquina.