Agentes de IA

Ejemplos reales

Ejemplo: depurar un bug en producción

Los prompts de ejemplo son ilustrativos; los comandos están verificados contra la documentación oficial.

Escenario: el login devuelve un HTTP 500 después del último despliegue. Una investigación razonable guiada por el agente: recoger logs, formular una hipótesis, reproducir en local, arreglar y verificar.

El flujo

  1. Recoger evidencias (logs, cambios recientes, salida del error).
  2. Formular hipótesis con el agente.
  3. Reproducir el fallo.
  4. Arreglar la causa raíz.
  5. Verificar con tests y volviendo a ejecutar el camino que fallaba.

Claude Code

Abre una sesión y reúne evidencias — pega los logs directamente, o pásaselos por tubería sin sesión interactiva:

claude
Este es el stack trace de producción: [pegar]. Ejecuta también
`git log --oneline -10` y dime qué cambio reciente podría estar causando un
500 en POST /login.

Variante con tubería:

kubectl logs deploy/api --since=30m | claude -p "Encuentra la causa raíz del 500 de login en estos logs."

Usa la skill de diagnóstico integrada para problemas de ejecución:

/debug El login devuelve 500 después del último despliegue

Formula la hipótesis y reproduce:

Formula una hipótesis y luego reproduce el fallo en local levantando el
servicio de auth y haciendo un POST a /login con un usuario de prueba.

Arregla y verifica:

Arregla la causa raíz, añade un test de regresión que reproduzca el 500 y
ejecuta toda la suite de tests de auth.

Si un intento de arreglo se tuerce, /rewind devuelve el código y la conversación a un checkpoint.

Codex

Investiga de forma interactiva en la TUI, o automatiza el triaje de logs con codex exec (el sandbox por defecto de exec es de solo lectura, perfecto para analizar logs):

kubectl logs deploy/api --since=30m | codex exec "Resume la causa raíz del 500 de login a partir de estos logs."

En la TUI, cruza la información con los cambios recientes:

codex
POST /login devuelve 500 desde el último despliegue. Mira `git log -10` y el
código de auth, e identifica el culpable más probable.

Reproduce bajo el sandbox del workspace:

Levanta el servicio de auth en local, reproduce el 500 con curl y enséñame el
camino de código que falla.

Arregla y verifica:

Arregla la causa raíz y añade un test de regresión. Ejecuta `npm test -- auth`
hasta que esté en verde y luego resume el diff.

Comprueba el resultado con /diff antes de commitear. Los servidores de desarrollo en segundo plano aparecen en /ps; /stop los detiene.

Kimi Code

Abre una sesión y recoge los logs con el modo shell (! en la caja de entrada vacía ejecuta un comando local y su salida entra en la conversación):

kimi
!kubectl logs deploy/api --since=30m | tail -100
El login devuelve 500 después del último despliegue. Con los logs de arriba y
`git log --oneline -10`, ¿cuál es la causa raíz más probable?

Reproduce:

Levanta el servicio de auth en local en segundo plano, reproduce el 500 con un
POST de curl a /login y captura el stack trace.

Arregla y verifica:

Arregla la causa raíz, añade un test de regresión que reproduzca el 500 y
ejecuta la suite de tests de auth para confirmar que está en verde.

Para una investigación larga y desatendida, puedes delegarle un objetivo persistente:

/goal Reproduce el 500 de login en local, arregla la causa raíz y termina sólo
cuando la suite de tests de auth pase.

Relacionado


Última verificación: 2026-09-07

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.