Pon la observabilidad dentro del harness
Un agente que no puede mirar el runtime depura a oscuras, adivinando por qué el programa hace lo que hace. La observabilidad convierte el feedback del bucle de una corazonada en evidencia.
Un piloto entre nubes que vuela a ojo se estrella; los instrumentos son lo que mantiene el avión nivelado. Un agente que no puede leer el runtime vuela a ojo. La observabilidad pone los instrumentos dentro del bucle: el panel en vivo, los logs y la salida fallida de los tests, todo legible como evidencia.
Depurar por especulación
Cuando el agente no ve logs, trazas ni el programa en vivo, recurre a especulación que suena plausible: «esto probablemente es una condición de carrera», «quizá la config está mal». A veces la suposición acierta; a menudo manda al bucle por una rama equivocada que malgasta iteraciones. La etapa de feedback solo vale tanto como la evidencia que entra en ella.
flowchart LR Pane["Panel tmux en vivo por WS"] --> Watch["El watchdog lo lee"] Watch -->|contexto bajo| Compact["/compact"] Watch -->|firma de crash| Crash["session.crashed"] FailTail["cola fallida de verify.sh"] --> Err["expuesta como last_error"]
Haz visible el runtime desde dentro
La observabilidad no es una preocupación de ops aparte atornillada después, es parte del harness. El agente necesita acceso de primera clase a logs, salida de comandos y el estado vivo de lo que ejecuta, disponible dentro del bucle para que el feedback de cada iteración esté fundamentado. Cuando el runtime es visible, «¿por qué falló esto?» tiene una respuesta que el agente puede leer en vez de inventar.
La terminal es la evidencia
En Agentum el agente trabaja dentro de un panel tmux en vivo, transmitido por WebSocket, y ese panel es a la vez donde ocurre el trabajo y donde vive la evidencia. Un watchdog por sesión lee el mismo panel en busca de señales, contexto bajo dispara /compact, las firmas de crash emiten session.crashed, y la cola fallida de verify.sh se expone como el last_error de la función. Para trabajo web, un Chromium residente en el host corre en el host (así sobrevive a que tu cliente se duerma) y lo observas en vivo por un screencast CDP tunelizado sobre ssh -L. El feedback del bucle, tu supervisión y el runtime real son una sola fuente de verdad.
Puntos clave
- Sin visibilidad del runtime, los agentes depuran por especulación y malgastan iteraciones.
- La observabilidad es parte del harness, no un añadido aparte.
- El feedback fundamentado necesita acceso de primera clase a logs, salida y estado vivo.
- En Agentum la terminal tmux en vivo es la evidencia compartida para el agente y para ti.
Ejercicios
- Observa una corrida. Sigue los logs de tu próxima tarea. ¿Qué aprendiste que habrías adivinado mal?
- Expón una señal. Elige una señal de runtime que merezca alerta y decide dónde debe aparecer.