Déboguer les outils WebMCP

Utilisez le panneau WebMCP dans les outils pour les développeurs Chrome pour inspecter, déboguer et tester les outils d'IA côté client que votre site Web expose aux agents IA. Le panneau offre une visibilité complète de bout en bout sur le cycle de vie de l'outil, y compris l'enregistrement, la validation du schéma et l'historique des appels.

Ouvrir le volet WebMCP

Le volet WebMCP se trouve dans le panneau "Application". Pour l'ouvrir, procédez comme suit :

  1. Ouvrez les outils pour les développeurs Chrome sur une page qui utilise les outils WebMCP.
  2. Cliquez sur l'onglet Application.
  3. Au premier niveau de la barre latérale, sélectionnez le volet WebMCP.
Panneau "Application" des outils de développement avec le volet WebMCP sélectionné dans la barre latérale "Application".
Panneau Application des outils de développement avec le volet WebMCP sélectionné dans la barre latérale Application.

Présentation de l'interface

Le panneau WebMCP utilise une mise en page à deux volets pour vous aider à gérer et à surveiller vos outils :

  • Outils appelés : journal chronologique des interactions entre l'agent IA et la page.
  • Outils disponibles : liste en direct de tous les outils WebMCP détectés dans l'onglet actif.

Outils disponibles

La section Outils disponibles affiche les noms et les descriptions des outils tels qu'ils apparaissent pour l'agent IA. Elle inclut également un compteur d'appels pour chaque outil, qui indique le nombre de fois qu'un outil a été appelé au cours de la session actuelle.

Liste des outils disponibles affichant le compteur d'invocation avec des icônes d'état cliquables pour le filtrage.
Liste "Outils disponibles" affichant le compteur d'appels avec des icônes d'état cliquables pour le filtrage.

Outils appelés

Le journal Outils appelés fournit un enregistrement permanent des interactions avec les outils. Lorsque vous sélectionnez une entrée dans le journal, vous pouvez inspecter les détails suivants :

  • État : résultat de l'appel (Terminé, Annulé, En cours ou Erreur).
  • Entrée : paramètres exacts que l'agent a prédits et envoyés à l'outil.
  • Sortie : valeur renvoyée ou message d'erreur fourni par l'outil.

Filtrer le journal

Utilisez la barre Filtrer pour affiner la liste des outils appelés en fonction des critères suivants :

  • Nom ou description : saisissez du texte pour trouver les outils correspondant à un nom ou à un objectif spécifique.
  • Type d'état : filtrez les appels par état actuel, par exemple Terminé, Erreur, Annulé ou En cours.
  • Type d'outil : sélectionnez pour filtrer les outils déclaratifs définis en HTML et les outils impératifs définis en JavaScript. Pour afficher tous les types d'outils, assurez-vous qu'aucun filtre n'est actif.

Tester les outils manuellement

Vous pouvez contourner la logique de décision de l'agent IA pour tester la fiabilité de votre outil de manière indépendante. Cela est utile pour vérifier la logique des fonctions sans attendre une invite d'agent spécifique.

  1. Dans la liste Outils disponibles, cliquez sur l'outil que vous souhaitez tester. Vous pouvez également, dans le journal Outils appelés , passer la souris sur un outil pour afficher l'icône Lecture (➜), puis cliquer dessus. La zone de test manuel s'ouvre. Remarque : Si vous avez sélectionné l'outil dans la liste "Outils disponibles", les paramètres de la zone de test manuel sont vides. Sinon, si vous avez sélectionné un outil appelé, la zone de test manuel s'ouvre avec les paramètres de cette session déjà préremplis.
  2. Dans la zone de test manuel, saisissez ou ajustez les paramètres dans les champs d'entrée.
  3. Cliquez sur Exécuter l'outil.
Pointez sur un élément de la liste "Outils appelés" pour afficher l'icône Play et ouvrir la zone de test manuel préremplie.
Pointez sur un élément de la liste "Outils appelés" pour afficher l'icône "Lecture" et ouvrir la zone de test manuel préremplie.

Résoudre les problèmes d'intégration

Le panneau WebMCP vous aide à diagnostiquer les échecs d'intégration courants :

  • Violations de schéma : le volet de sortie affiche des messages d'erreur si les paramètres de l'outil ou les valeurs renvoyées ne correspondent pas au schéma défini.
  • Rejet de l'agent : consultez le compteur d'appels dans la liste Outils disponibles pour voir si l'agent a déjà envisagé votre outil pour une invite donnée.

Automatisation et agents

WebMCP est conçu pour le Web agentique, où les agents IA peuvent découvrir les outils de votre site et interagir avec eux. Pour le développement assisté par agent, le Chrome DevTools for agents projet fournit une interface spécialisée qui utilise ce protocole pour aider les agents IA à tester et à utiliser vos outils WebMCP.

Options de ligne de commande

Certaines interfaces agentiques nécessitent que vous activiez explicitement l'option --categoryWebMCP.

Ressources associées

Pour en savoir plus sur WebMCP et le Web agentique, consultez les ressources suivantes :