Agent-Xray: Open-Source-Tool zum Debuggen von KI-Agent-Fehlern aus Trace-Logs
Agent-Xray ist ein Open-Source-Tool zum Debuggen von KI-Agenten durch die Analyse ihrer Trace-Protokolle. Es wurde entwickelt, um das Problem zu lösen, dass Agenten Aufgaben ohne klare Fehlermeldungen nicht erfüllen – Situationen, in denen der Code einwandfrei läuft, der Agent aber falsche Entscheidungen trifft, wie etwa das wiederholte Aufrufen des falschen Tools, obwohl Fehlermeldungen das richtige nahelegen.
Hauptfunktionen
Das Tool liest Trace-Protokolle und bietet strukturelle Bewertung und Ursachenklassifizierung für Agentenfehler. Es rekonstruiert, was der Agent in jedem Schritt gesehen hat, um zu verstehen, warum schlechte Entscheidungen getroffen wurden.
Fehlerkategorien
- Spin
- Tool-Bug
- Early-Abort
Enforcement-Modus
Die bedeutendste Funktion laut dem Ersteller ist der Enforcement-Modus. Nach der Behebung eines Agenten-Fehlers führt dieser Modus adversarische Herausforderungen gegen Ihre Korrekturen aus, um zu überprüfen, ob sie legitim sind. Er prüft auf:
- Hartkodierte Rückgaben
- Abgeschwächte Assertions
Dies behebt das Problem, dass Korrekturen bei bestimmten Testaufgaben funktionieren könnten, aber tatsächlich fragil sind, oder dass Agenten lernen, den Test zu umgehen.
Workflow-Integration
Das Tool läuft als MCP-Tools, sodass Claude Code es direkt nutzen kann. Ein typischer Workflow laut der Quelle:
- Claude Code anweisen, Agenten-Traces zu triagieren
- Es findet den schwerwiegendsten Fehler
- Spielt wieder, was der Agent gesehen hat
- Schlägt eine Korrektur vor
- Der Enforcement-Modus überprüft, ob die Korrektur legitim ist
Der Ersteller beschreibt dies als "Agenten, die Agenten debuggen".
Technische Details
- Installation:
pip install agent-xray - Schnellstart:
agent-xray quickstart(enthält Beispiel-Traces zum Testen ohne eigene Daten) - Lizenz: MIT
- Keine Abhängigkeiten
- Läuft offline
- Funktioniert mit OpenAI-, Anthropic-, LangChain-, CrewAI-, OpenTelemetry-Traces
- Projektalter: Etwa 9 Tage zum Zeitpunkt der Veröffentlichung
Anwendungsfall
Dieses Tool ist für Entwickler gedacht, die mit KI-Agenten arbeiten und Fehler debuggen müssen, die keine traditionellen Fehler oder Stack-Traces erzeugen – Situationen, in denen Agenten trotz Zugriff auf korrekte Tools und Informationen falsche Entscheidungen treffen.
📖 Read the full source: r/ClaudeAI
👀 Siehe auch
bad-ass-mcp: Kostenloses, Open-Source-MCP für native Desktop-GUI-Steuerung über Accessibility-API
bad-ass-mcp ist ein Open-Source-MCP-Server, der Claude und anderen KI-Agenten ermöglicht, macOS-, Windows- und Linux-Desktops über die native Barrierefreiheitsschicht zu steuern – ohne Screenshots, ohne Look-Move-Look-Schleifen. Kostenlose Alternative zu Computer Use, Operator oder UiPath.
CK Search: Lokales semantisches Suchtool mit MCP-Server-Integration
CK Search ist ein lokales semantisches Suchwerkzeug mit einem integrierten MCP-Server, das beliebige Textverzeichnisse ohne Cloud-Abhängigkeiten indiziert. Das Tool kann von KI-Agenten über MCP genutzt werden, und die Quelle bietet eine praktische Schritt-für-Schritt-Anleitung, die Einrichtung, Stärken und Grenzen im Vergleich zu grep abdeckt.
Jentic Mini: Selbst gehostete API- und Aktionsausführungsschicht für OpenClaw
Jentic Mini ist eine selbst gehostete API- und Aktionsausführungsschicht, die zwischen KI-Agenten und externen APIs sitzt, Anmeldedaten in einem verschlüsselten Tresor speichert und bereichsbezogene Toolkits mit individuell widerrufbaren Schlüsseln bereitstellt. Beim Hinzufügen von Anmeldedaten importiert es automatisch über 10.000 OpenAPI-Spezifikationen und Arazzo-Workflow-Quellen.
Storybloq: Ein Projekt-Tracker für Claude Code mit Mac-App, CLI und MCP
Storybloq ist ein kostenloser Open-Source-Projekt-Tracker, der in .story/ innerhalb deines Repos lebt. Er umfasst eine Mac-App (App Store), eine CLI und einen MCP-Server, um Tickets, Issues und Session-Handovers an Claude Code bereitzustellen.