Apidog’s KI-Agent-Debugger ist im neuesten Apidog-Client für alle Pläne, einschließlich Free, verfügbar. Der Debugger ermöglicht es Ihnen, KI-Agenten mit OpenAI- und Anthropic-Modellen auszuführen, MCP-Server zu verbinden, jeden Modellaufruf und jede Tool-Invocation in einem Traces-Panel zu inspizieren und die Kosten pro Ausführung zu verfolgen.
Dieser Artikel behandelt, wer den KI-Agent-Debugger verwenden kann, was er unterstützt, was er nicht unterstützt, wie man ihn aktiviert und was sich an Ihren bestehenden Apidog-Projekten nicht ändert.
Was ist verfügbar
Der KI-Agent-Debugger ist im Standard-Apidog-Client enthalten. Es gibt keine separate Lizenz, keinen Zusatzplan und keine Gebühr pro Arbeitsplatz.
- Die Pläne Free, Basic, Professional und Enterprise beinhalten alle den KI-Agent-Debugger.
- Die Funktion ist standardmäßig aktiviert; es gibt nichts umzuschalten.
- Sie müssen die neueste Version des Apidog-Clients verwenden. Ältere Clients verfügen nicht über den Reiter für den KI-Agent-Debugger.
Unterstützte Modell-Anbieter
| Anbieter | Status | Modelle |
|---|---|---|
| OpenAI | Unterstützt | GPT-5.5, GPT-5.5 Instant, o-series und jedes Modell im OpenAI-Konto |
| Anthropic | Unterstützt | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| Benutzerdefinierte OpenAI-kompatible Endpunkte | Unterstützt über Basis-URL-Überschreibung | Jeder Anbieter, der eine OpenAI-kompatible API bereitstellt |
| Andere Anbieter (Google, Mistral, xAI) | Auf der Roadmap | Derzeit nicht erstklassig unterstützt |
MCP-Server-Verbindungsmethoden
Der Debugger spricht das Model Context Protocol nativ. Drei Transportmethoden werden unterstützt:
- STDIO. Lokaler Subprozess. Am besten geeignet für MCP-Server in aktiver Entwicklung.
- HTTP Streamable. Gehostete MCP-Server, die über HTTP erreichbar sind.
- SSE. Veraltete Server-Sent Events. Immer noch verbreitet; wird zur Abwärtskompatibilität unterstützt.
Die Authentifizierung für MCP-Server umfasst zwei Muster: Standard-Header (API-Schlüssel) und OAuth 2.0 (vollständiger Token-Austausch).
Was der Debugger abdeckt
Der Debugger erfasst die vollständige Ausführungskette eines Agentenlaufs:
- Modellaufrufe mit vollständigen Anforderungs- und Antwort-Payloads.
- Modell-Denkspuren, wenn das Modell diese bereitstellt (OpenAI o-series, erweitertes Denken von Anthropic).
- Tool-Invokationen mit Parameterwerten und Rückgabedaten.
- MCP-Server-Verkehr, der im Traces-Panel wie jeder andere Tool-Aufruf aufgeführt ist.
- Integrierte Tools:
bash,web_fetch,read,edit,write,grep,glob,kill_shell. - Leistungsmetriken pro Ausführung: Antwortzeit, Eingabe-Tokens, Ausgabe-Tokens, geschätzte Kosten.
- Skills: gespeicherte Bündel aus System-Prompt + Tool-Liste + Parametern zur Wiederholung eines Szenarios.
Was der Debugger nicht abdeckt
- Produktions-Observability. Verwenden Sie ein dediziertes Observability-Tool für die langfristige Protokollierung des Datenverkehrs.
- Automatisierte Regressionstests. Für Prompt-Gitter gegen Fixtures verwenden Sie ein Framework wie Promptfoo.
- Agent-to-Agent (A2A) Protokollverkehr. Für A2A verwenden Sie Apidog’s separaten A2A-Debugger.
- MCP-Server-Validierung in Isolation. Zum Testen der Tools und Ressourcen eines einzelnen MCP-Servers ohne Agenten-Schleife verwenden Sie Apidog’s MCP-Server-Test-Workflow.
So aktivieren Sie es
- Aktualisieren Sie Apidog auf die neueste Version.
- Öffnen Sie Apidog und klicken Sie in der oberen Registerkartenleiste auf KI-Agent-Debugger.
- Wählen Sie einen Modell-Anbieter und ein Modell aus.
- Bestätigen Sie die Basis-URL (wird automatisch vom Anbieter ausgefüllt) oder überschreiben Sie sie für einen benutzerdefinierten Endpunkt.
- Fügen Sie Ihren API-Schlüssel ein.
- Klicken Sie auf Ausführen in einem leeren Thread, um die Verbindung zu bestätigen.
Es ist keine projektbezogene Konfiguration erforderlich. Der Debugger läuft in einem eigenen Arbeitsbereich.
Was gleich bleibt
- Bestehende Apidog-Projekte, API-Definitionen und Test-Suites bleiben unberührt.
- Der MCP-Server-Test-Workflow und der A2A-Debugger funktionieren weiterhin parallel.
- API-Endpunkt-Debugging, Mock-Server und OpenAPI-Bearbeitung bleiben unverändert.
- Abrechnung und Plan-Stufen bleiben unverändert; der KI-Agent-Debugger verbraucht keine neuen Credits.
Sie zahlen für die zugrunde liegenden Modell-API-Aufrufe gemäß der Abrechnung Ihres OpenAI- oder Anthropic-Kontos. Apidog berechnet keine Aufschläge für die Nutzung.
Für Team- und Enterprise-Administratoren
- Der KI-Agent-Debugger ist pro Benutzer aktiviert. Jedes Mitglied verwendet seinen eigenen Anbieter-API-Schlüssel.
- API-Schlüssel, die im Debugger eingegeben werden, werden lokal auf dem Client jedes Benutzers gespeichert. Sie werden nicht an Apidog-Server übertragen.
- Workspace-Inhaber können freigegebene MCP-Server-Endpunkte zentral über Standard-Apidog-Umgebungsvariablen verwalten.
- Audit- und Zugriffskontrollen für MCP-Server folgen dem eigenen Authentifizierungsmodell des MCP-Servers (Header oder OAuth 2.0).
Bekannte Einschränkungen
- Die Erweiterung der Anbieter über OpenAI und Anthropic hinaus ist auf der Roadmap; verwenden Sie in der Zwischenzeit die Basis-URL-Überschreibung für OpenAI-kompatible Anbieter.
- Das Teilen von Traces ist nur lokal möglich. Um einen Trace zu teilen, kopieren Sie das JSON der Rohansicht oder machen Sie einen Screenshot des Panels.
- Die Kostenschätzung ist eine lokale Annäherung basierend auf veröffentlichten Modellpreisen; für die Abrechnung beziehen Sie sich auf das Nutzungs-Dashboard Ihres Anbieters.