Le débogueur d'agents IA d'Apidog est disponible dans le dernier client Apidog pour tous les plans, y compris le plan Gratuit. Le débogueur vous permet d'exécuter des agents IA avec des modèles OpenAI et Anthropic, de connecter des serveurs MCP, d'inspecter chaque appel de modèle et invocation d'outil dans un panneau de Traces, et de suivre le coût par exécution.
Cet article couvre qui peut utiliser le débogueur d'agents IA, ce qu'il prend en charge, ce qu'il ne prend pas en charge, comment l'activer et ce qui reste inchangé concernant vos projets Apidog existants.
Ce qui est disponible
Le débogueur d'agents IA est intégré au client standard d'Apidog. Il n'y a pas de licence séparée, pas de plan complémentaire, et pas de frais par utilisateur.
- Les plans Gratuit, Basique, Professionnel et Entreprise incluent tous le débogueur d'agents IA.
- La fonctionnalité est activée par défaut ; rien à configurer.
- Vous devez utiliser la dernière version du client Apidog. Les clients plus anciens n'ont pas l'onglet Débogueur d'agents IA.
Fournisseurs de modèles pris en charge
| Fournisseur | Statut | Modèles |
|---|---|---|
| OpenAI | Pris en charge | GPT-5.5, GPT-5.5 Instant, o-series, et tout modèle sur le compte OpenAI |
| Anthropic | Pris en charge | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| Points de terminaison personnalisés compatibles OpenAI | Pris en charge via la surcharge de l'URL de base | Tout fournisseur exposant une API compatible OpenAI |
| Autres fournisseurs (Google, Mistral, xAI) | Sur la feuille de route | Actuellement non pris en charge en tant que service de premier ordre |
Méthodes de connexion aux serveurs MCP
Le débogueur utilise nativement le protocole MCP (Model Context Protocol). Trois transports sont pris en charge :
- STDIO. Sous-processus local. Idéal pour les serveurs MCP en cours de développement actif.
- Flux HTTP. Serveurs MCP hébergés et accessibles via HTTP.
- SSE. Server-Sent Events (hérités). Toujours courants ; pris en charge pour la rétrocompatibilité.
L'authentification pour les serveurs MCP couvre deux modèles : les en-têtes standard (clé API) et OAuth 2.0 (échange de jetons complet).
Ce que le débogueur couvre
Le débogueur capture la chaîne d'exécution complète d'une exécution d'agent :
- Appels de modèle avec les charges utiles complètes de requête et de réponse.
- Traces de réflexion du modèle, lorsque le modèle les expose (OpenAI o-series, Anthropic extended thinking).
- Invocations d'outils avec les valeurs des paramètres et les données de retour.
- Trafic du serveur MCP, listé dans le panneau Traces comme tout autre appel d'outil.
- Outils intégrés :
bash,web_fetch,read,edit,write,grep,glob,kill_shell. - Métriques de performance par exécution : temps de réponse, jetons d'entrée, jetons de sortie, coût estimé.
- Compétences : ensembles enregistrés de prompt système + liste d'outils + paramètres pour la réexécution d'un scénario.
Ce que le débogueur ne couvre pas
- Observabilité en production. Utilisez un outil d'observabilité dédié pour la journalisation du trafic à long terme.
- Tests de régression automatisés. Pour des grilles de prompts par rapport à des fixtures, utilisez un harnais comme Promptfoo.
- Trafic de protocole Agent-to-Agent (A2A). Pour l'A2A, utilisez le débogueur A2A séparé d'Apidog.
- Validation isolée du serveur MCP. Pour tester les outils et les ressources d'un seul serveur MCP sans boucle d'agent, utilisez le flux de test de serveur MCP d'Apidog.
Comment l'activer
- Mettez Apidog à jour vers la dernière version.
- Ouvrez Apidog et cliquez sur Débogueur d'agents IA dans la barre d'onglets supérieure.
- Sélectionnez un fournisseur de modèle et un modèle.
- Confirmez l'URL de base (remplie automatiquement par le fournisseur) ou remplacez-la pour un point de terminaison personnalisé.
- Collez votre clé API.
- Cliquez sur Exécuter sur un thread vide pour confirmer la connexion.
Aucune configuration au niveau du projet n'est requise. Le débogueur fonctionne dans son propre espace de travail.
Ce qui reste inchangé
- Les projets Apidog existants, les définitions d'API et les suites de tests ne sont pas affectés.
- Le flux de test du serveur MCP et le débogueur A2A continuent de fonctionner en parallèle.
- Le débogage des points de terminaison d'API, les serveurs de maquette et l'édition OpenAPI sont inchangés.
- La facturation et les niveaux de plan sont inchangés ; le débogueur d'agents IA ne consomme aucun nouveau crédit.
Vous payez pour les appels d'API du modèle sous-jacent selon la facturation de votre compte OpenAI ou Anthropic. Apidog n'impose pas de surtaxe pour l'utilisation.
Pour les administrateurs d'équipes et d'entreprises
- Le débogueur d'agents IA est activé par utilisateur. Chaque membre utilise sa propre clé API de fournisseur.
- Les clés API saisies dans le débogueur sont stockées localement sur le client de chaque utilisateur. Elles ne sont pas transmises aux serveurs Apidog.
- Les propriétaires d'espaces de travail peuvent gérer de manière centralisée les points de terminaison partagés des serveurs MCP via les variables d'environnement Apidog standard.
- L'audit et les contrôles d'accès pour les serveurs MCP suivent le modèle d'authentification propre au serveur MCP (en-têtes ou OAuth 2.0).
Limitations connues
- L'expansion des fournisseurs au-delà d'OpenAI et d'Anthropic est sur la feuille de route ; utilisez la surcharge de l'URL de base pour les fournisseurs compatibles OpenAI en attendant.
- Le partage des traces est uniquement local. Pour partager une trace, copiez le JSON de la vue brute ou faites une capture d'écran du panneau.
- L'estimation des coûts est une approximation locale basée sur les prix publiés des modèles ; consultez le tableau de bord d'utilisation de votre fournisseur pour la facturation.