agentfdr

agentfdr

agentfdr de kamihork es una herramienta de depuración para agentes de IA que revela registros de ejecución paso a paso. Detecta bucles, desviaciones de objetivos y desperdicio de tokens sin necesidad de instrumentación, funcionando de manera local.

¿Qué es agentfdr?

agentfdr es una herramienta de depuración para agentes de IA que revela registros de ejecución paso a paso después del hecho. Identifica bucles, desviaciones de objetivo y desperdicio de tokens sin instrumentación, operando localmente. Piensa en ello como una grabadora de vuelo para sesiones de agentes autónomos: captura cada llamada a herramienta, composición de ventana de contexto y token de salida para que puedas analizar fallos después de que ocurran. Está diseñado para ayudar a los ingenieros a "diseñar un bucle que se pueda ver", convirtiendo el comportamiento invisible del agente en una línea de tiempo inspeccionable.

Application scenarios

  • Depuración de bucles infinitos

    Atrapa agentes atrapados en un ciclo "Editar → prueba falla → misma edición" que se ejecuta durante 40 minutos.

  • Detección de desviación de objetivo

    Detecta cuando un agente pidió una corrección de error pero en su lugar refactorizó el enrutador.

  • Análisis de desperdicio de tokens

    Identifica cuando grandes resultados de herramientas saturan la ventana de contexto, causando fallos de caché y relecturas de 200k tokens por turno.

  • Investigación de malos finales

    Entiende por qué un agente dice "¡Listo!" con pruebas fallidas o nunca se detiene.

  • Monitoreo de pipeline CI

    Coloca un sensor en pipelines autónomos con `agentfdr assert` para bloquear bucles o uso excesivo de tokens.

  • Seguimiento de costos

    Agrega transcripciones de todos los proyectos para monitorear el uso por modelo y los costos estimados frente a los planes de suscripción.

  • Informes post-mortem

    Genera informes de autopsia en Markdown listos para pegar en rastreadores de incidencias o hilos de Slack.

Core Features

  • Visor de línea de tiempo

    Ve toda la sesión en una pantalla: cada turno de llamadas a herramienta, composición de ventana de contexto, tokens de salida, con marcadores de solicitud y compactación.

  • Detección de anomalías

    Marca automáticamente bucles de herramientas, rachas de errores, inflación de contexto, picos de tokens, fallos de caché, cambios de archivos y rechazos—un clic desde la evidencia.

  • Disección de turnos

    Un panel lateral redimensionable que muestra el desglose de uso, la duración de cada llamada a herramienta, el tamaño del resultado y un fragmento. Navega por los turnos con las teclas ←/→.

  • Modo de vigilancia en vivo

    `agentfdr watch` sigue una sesión que aún se está ejecutando, mostrando el aumento de contexto en tiempo real.

  • Puerta CI

    `agentfdr assert --no-loops --max-tokens 2M` sale con código 1 en caso de violación, actuando como un sensor para pipelines autónomos.

  • Autopsia en Markdown

    `agentfdr blame` renderiza todo el análisis como Markdown, listo para pegar en una incidencia o hilo de Slack.

  • Seguimiento de uso

    Agrega todas las transcripciones de proyectos en la misma forma que la medición de suscripción—ventana actual de 5 horas, historial diario, semana móvil—con desglose por modelo y costo estimado.

  • Calibración de presupuesto

    Detecta automáticamente tu nivel de plan, establece presupuestos, calibra una vez contra la pantalla de /uso de Claude Code y obtén barras de advertencia antes de alcanzar los límites.

Usuarios objetivo

Ingenieros de software y desarrolladores de IA que construyen o mantienen sistemas de agentes autónomos. Específicamente, aquellos que trabajan con bucles de agentes, depuran comportamiento impredecible o gestionan costos de tokens en pipelines de producción. También es útil para ingenieros de QA que configuran puertas CI en flujos de trabajo de agentes y líderes de equipo que necesitan informes post-mortem para fallos de agentes.

Cómo usar agentfdr?

agentfdr es una herramienta de línea de comandos. Los comandos clave incluyen:
  • agentfdr – abre la línea de tiempo de la sesión más reciente
  • agentfdr list – lista todas las sesiones grabadas en todos los proyectos
  • agentfdr watch – sigue en vivo una sesión en ejecución
  • agentfdr blame 35cb18 – genera una autopsia en Markdown para una incidencia específica
  • agentfdr usage – ve el consumo del plan (ventana de 5 horas, diario, semanal)
  • agentfdr assert --no-loops --max-tokens 2M – puerta CI que sale con 1 en caso de violación

No se menciona registro ni interfaz web; opera localmente a través de comandos de terminal.

Revisión de efectos

agentfdr aborda un punto de dolor real: la invisibilidad de los fallos de agentes autónomos. El conjunto de características es completo para una herramienta de depuración—cubre visualización de línea de tiempo, detección de anomalías, monitoreo en vivo, integración CI y seguimiento de costos. La interfaz de línea de comandos sugiere que está diseñada para desarrolladores que ya trabajan en entornos de terminal. Aunque no se proporcionan comentarios de usuarios ni métricas de calidad en el sitio, el enfoque de la herramienta en cero instrumentación y operación local la hace práctica para depuración en producción sin agregar sobrecarga. Para equipos que luchan con la ingeniería de bucles de agentes, esto parece ser una solución enfocada y sin lujos.

Frequently Asked Questions

¿Qué es agentfdr?
agentfdr es una herramienta de depuración para agentes de IA que genera registros detallados de ejecución paso a paso después de que ocurren, ayudando a identificar bucles, desviaciones del objetivo y desperdicio de tokens sin necesidad de instrumentación.
¿Cómo funciona agentfdr?
Funciona localmente y analiza de forma retrospectiva los registros de ejecución del agente para revelar cada paso, permitiéndote ver dónde ocurrieron bucles o desviaciones del objetivo sin modificar el código de tu agente.
¿Necesito instrumentar mi agente para usar agentfdr?
No, agentfdr no requiere instrumentación. Funciona con registros existentes para proporcionar información de depuración después de la ejecución.
¿Qué problemas puede ayudarme a resolver agentfdr?
Ayuda a identificar bucles infinitos, desviaciones del objetivo (cuando el agente se aleja de su objetivo previsto) y desperdicio de tokens, haciendo que tus agentes de IA sean más eficientes y confiables.
¿Es agentfdr gratuito?
Sí, agentfdr es una herramienta de código abierto disponible de forma gratuita, como se indica en su repositorio de GitHub bajo kamihork.
¿Se puede usar agentfdr con cualquier framework de agentes de IA?
Sí, dado que funciona con registros de ejecución después de los hechos, es independiente del framework y se puede usar con cualquier agente de IA que genere salidas de registro.

agentfdr - AI Tool Detail

agentfdr de kamihork es una herramienta de depuración para agentes de IA que revela registros de ejecución paso a paso. Detecta bucles, desviaciones de objetivos y desperdicio de tokens sin necesidad de instrumentación, funcionando de manera local.

Category:Agente

Visit Link:https://kamihork.github.io/agentfdr/

Tags:depuración de agentes AI、registros de ejecución、detección de desperdicio de tokens、análisis de desviación de objetivos、herramienta de depuración local