agentfdr

agentfdr

agentfdr von kamihork ist ein Debugging-Tool für KI-Agenten, das nachträglich detaillierte Ausführungslogs pro Schritt anzeigt. Es erkennt Endlosschleifen, Zielabweichungen und Token-Verschwendung – ganz ohne Instrumentierung und lokal ausgeführt.

KI-Agenten-DebuggingAusführungsprotokolleToken-Verschwendung erkennenZielabweichungsanalyseLokales Debugging-Tool
Open site
image for agentfdrOpen site

Was ist agentfdr?

agentfdr ist ein Debugging-Werkzeug für KI-Agenten, das nachträglich schrittweise Ausführungsprotokolle offenlegt. Es erkennt Endlosschleifen, Zielabweichungen und Token-Verschwendung ohne Instrumentierung und läuft lokal. Stellen Sie es sich wie einen Flugschreiber für autonome Agentensitzungen vor – es zeichnet jeden Tool-Aufruf, die Context-Window-Zusammensetzung und jedes Ausgabe-Token auf, damit Sie Fehler nach ihrem Auftreten analysieren können. Es wurde entwickelt, um Ingenieuren zu helfen, „eine Schleife zu entwickeln, die man sehen kann“, und verwandelt unsichtbares Agentenverhalten in eine überprüfbare Zeitleiste.

Application scenarios

  • Debuggen von Endlosschleifen

    Erfassen von Agenten, die in einem „Bearbeiten → Test schlägt fehl → gleiche Bearbeitung“-Zyklus stecken, der 40 Minuten läuft.

  • Erkennen von Zielabweichungen

    Feststellen, wenn ein Agent nach einem Bugfix gefragt wurde, stattdessen aber den Router umgestaltet hat.

  • Analysieren von Token-Verschwendung

    Identifizieren, wann große Tool-Ergebnisse den Context-Window überladen, was zu Cache-Fehlern und 200.000 Token-Neulesungen pro Schritt führt.

  • Untersuchen von Fehlabschlüssen

    Verstehen, warum ein Agent „Fertig!“ sagt, obwohl Tests fehlschlagen, oder nie aufhört.

  • CI-Pipeline-Überwachung

    Einrichten einer Auslöseschwelle für autonome Pipelines mit `agentfdr assert`, um Schleifen oder übermäßigen Token-Verbrauch zu blockieren.

  • Kostenverfolgung

    Zusammenführen von Transkripten über Projekte hinweg, um die Nutzung pro Modell und geschätzte Kosten im Vergleich zu Abonnementplänen zu überwachen.

  • Post-Mortem-Berichte

    Erstellen von Markdown-Autopsieberichten, die direkt in Issue-Tracker oder Slack-Threads eingefügt werden können.

Core Features

  • Zeitleisten-Ansicht

    Die gesamte Sitzung auf einem Bildschirm sehen – jeden Schritt mit Tool-Aufrufen, Context-Window-Zusammensetzung, Ausgabe-Token sowie Prompt- und Kompaktionsmarkierungen.

  • Anomalieerkennung

    Automatische Markierung von Tool-Schleifen, Fehlerserien, Context-Überlastung, Token-Spitzen, Cache-Thrashing, Datei-Churn und Ablehnungen – ein Klick von den Beweisen entfernt.

  • Schrittanalyse

    Ein größenveränderbares Seitenfeld mit Nutzungsaufschlüsselung, Dauer jedes Tool-Aufrufs, Ergebnisgröße und Auszug. Mit ←/→-Tasten durch die Schritte navigieren.

  • Live-Überwachungsmodus

    `agentfdr watch` verfolgt eine noch laufende Sitzung und zeigt den Context-Anstieg in Echtzeit.

  • CI-Gate

    `agentfdr assert --no-loops --max-tokens 2M` beendet sich mit Code 1 bei Verstoß und fungiert als Auslöseschwelle für autonome Pipelines.

  • Markdown-Autopsie

    `agentfdr blame` erstellt die gesamte Analyse als Markdown, bereit zum Einfügen in ein Issue oder einen Slack-Thread.

  • Nutzungsverfolgung

    Fasst alle Transkripte eines Projekts in derselben Form zusammen wie die Abonnement-Messung – aktuelles 5-Stunden-Fenster, täglicher Verlauf, rollierende Woche – mit Aufschlüsselung pro Modell und geschätzten Kosten.

  • Budgetkalibrierung

    Erkennt automatisch Ihren Tarif, setzt Budgets, kalibriert einmalig gegen den /usage-Bildschirm von Claude Code und zeigt Warnbalken vor dem Erreichen von Limits.

Zielgruppe

Softwareentwickler und KI-Ingenieure, die autonome Agentensysteme entwickeln oder warten. Insbesondere diejenigen, die mit Agentenschleifen arbeiten, unvorhersehbares Verhalten debuggen oder Token-Kosten in Produktionspipelines verwalten. Auch nützlich für QA-Ingenieure, die CI-Gates für Agenten-Workflows einrichten, und Teamleiter, die Post-Mortem-Berichte für Agentenfehler benötigen.

So verwenden Sie agentfdr

agentfdr ist ein Kommandozeilen-Tool. Zu den wichtigsten Befehlen gehören:
  • agentfdr – die Zeitleiste der neuesten Sitzung öffnen
  • agentfdr list – alle aufgezeichneten Sitzungen über Projekte hinweg auflisten
  • agentfdr watch – eine laufende Sitzung live verfolgen
  • agentfdr blame 35cb18 – einen Markdown-Autopsiebericht für ein bestimmtes Problem erstellen
  • agentfdr usage – die Nutzungsübersicht anzeigen (5-Stunden-Fenster, täglich, wöchentlich)
  • agentfdr assert --no-loops --max-tokens 2M – CI-Gate, das bei Verstoß mit Code 1 beendet wird

Es wird keine Anmeldung oder Weboberfläche erwähnt; das Tool läuft lokal über Terminalbefehle.

Wirkungsbewertung

agentfdr adressiert einen echten Schmerzpunkt: die Unsichtbarkeit von Fehlern autonomer Agenten. Die Funktionsvielfalt ist umfassend für ein Debugging-Werkzeug – sie umfasst Zeitleistenvisualisierung, Anomalieerkennung, Live-Überwachung, CI-Integration und Kostenverfolgung. Die Kommandozeilen-Schnittstelle deutet darauf hin, dass es für Entwickler konzipiert ist, die bereits in Terminalumgebungen arbeiten. Obwohl auf der Website kein Benutzerfeedback oder Qualitätskennzahlen bereitgestellt werden, macht der Fokus des Tools auf Null-Instrumentierung und lokalen Betrieb es praktisch für das Produktionsdebugging ohne zusätzlichen Overhead. Für Teams, die mit Agentenschleifen-Engineering kämpfen, scheint dies eine fokussierte, schnörkellose Lösung zu sein.

Frequently Asked Questions

Was ist agentfdr?
agentfdr ist ein Debugging-Werkzeug für KI-Agenten, das nachträglich schrittweise Ausführungsprotokolle bereitstellt. Es hilft dabei, Endlosschleifen, Zielabweichungen und Token-Verschwendung zu erkennen, ohne dass eine Instrumentierung erforderlich ist.
Wie funktioniert agentfdr?
Das Tool läuft lokal und analysiert im Nachhinein die Ausführungsprotokolle des Agenten. Dabei werden die einzelnen Schritte offengelegt, sodass Sie erkennen können, wo Schleifen oder Zielabweichungen aufgetreten sind – ohne den Code des Agenten ändern zu müssen.
Muss ich meinen Agenten instrumentieren, um agentfdr zu nutzen?
Nein, agentfdr benötigt keinerlei Instrumentierung. Es arbeitet mit vorhandenen Protokollen und liefert Debugging-Erkenntnisse nach der Ausführung.
Welche Probleme kann agentfdr lösen?
Es hilft, Endlosschleifen, Zielabweichungen (wenn der Agent vom beabsichtigten Ziel abweicht) und Token-Verschwendung zu identifizieren, wodurch Ihre KI-Agenten effizienter und zuverlässiger werden.
Ist agentfdr kostenlos nutzbar?
Ja, agentfdr ist ein Open-Source-Tool und kostenlos verfügbar, wie das GitHub-Repository unter kamihork zeigt.
Kann agentfdr mit jedem KI-Agenten-Framework verwendet werden?
Ja, da es mit Ausführungsprotokollen nach der Ausführung arbeitet, ist es framework-unabhängig und kann mit jedem KI-Agenten eingesetzt werden, der Protokollausgaben erzeugt.

agentfdr - AI Tool Detail

agentfdr von kamihork ist ein Debugging-Tool für KI-Agenten, das nachträglich detaillierte Ausführungslogs pro Schritt anzeigt. Es erkennt Endlosschleifen, Zielabweichungen und Token-Verschwendung – ganz ohne Instrumentierung und lokal ausgeführt.

Category：Agents

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

Tags：KI-Agenten-Debugging、Ausführungsprotokolle、Token-Verschwendung erkennen、Zielabweichungsanalyse、Lokales Debugging-Tool