WebMCP-Tools debuggen

Mit dem WebMCP-Bereich in den Chrome-Entwicklertools können Sie die clientseitigen KI-Tools, die Ihre Website KI-Agents zur Verfügung stellt, untersuchen, debuggen und testen. Das Steuerfeld bietet einen vollständigen Überblick über den Tool-Lebenszyklus, einschließlich Registrierung, Schemavalidierung und Aufrufverlauf.

Bereich „WebMCP“ öffnen

Der Bereich WebMCP befindet sich im Bereich Anwendung. So öffnen Sie sie:

  1. Öffnen Sie die Chrome-Entwicklertools auf einer Seite, auf der WebMCP-Tools verwendet werden.
  2. Klicken Sie auf den Tab Anwendung.
  3. Wählen Sie in der obersten Ebene der Seitenleiste den Bereich WebMCP aus.
Der Bereich „Anwendung“ der Entwicklertools mit dem Bereich „WebMCP“ in der Seitenleiste „Anwendung“.

Übersicht: Benutzeroberfläche

Im Bereich WebMCP wird ein Layout mit zwei Bereichen verwendet, damit Sie Ihre Tools besser verwalten und überwachen können:

  • Aufgerufene Tools:Ein chronologisches Protokoll der Interaktionen zwischen dem KI‑Agenten und der Seite.
  • Verfügbare Tools:Eine Live-Liste aller WebMCP-Tools, die auf dem aktiven Tab erkannt wurden.

Verfügbare Tools

Im Abschnitt Verfügbare Tools werden die Tool-Namen und ‑Beschreibungen so angezeigt, wie sie dem KI-Agenten präsentiert werden. Außerdem ist für jedes Tool ein Aufrufzähler enthalten, der angibt, wie oft ein Tool während der aktuellen Sitzung aufgerufen wurde.

Die Liste „Verfügbare Tools“ mit dem Aufrufzähler und klickbaren Statussymbolen zum Filtern.

Aufgerufene Tools

Das Protokoll Aufgerufene Tools enthält einen dauerhaften Datensatz der Tool-Interaktionen. Wenn Sie einen Eintrag im Log auswählen, können Sie die folgenden Details ansehen:

  • Status:Das Ergebnis des Aufrufs („Abgeschlossen“, „Abgebrochen“, „Wird ausgeführt“ oder „Fehler“).
  • Eingabe:Die genauen Parameter, die der Agent vorhergesagt und an das Tool gesendet hat.
  • Ausgabe:Der vom Tool zurückgegebene Wert oder die Fehlermeldung.

Log filtern

Verwenden Sie die Leiste Filter, um die Liste der aufgerufenen Tools anhand der folgenden Kriterien einzugrenzen:

  • Name oder Beschreibung:Geben Sie Text ein, um Tools zu finden, die einem bestimmten Namen oder Zweck entsprechen.
  • Statustyp:Filtern Sie Anrufe nach ihrem aktuellen Status, z. B. Abgeschlossen, Fehler, Abgebrochen oder Wird verarbeitet.
  • Tool-Typ:Wählen Sie diese Option aus, um nach deklarativen Tools, die in HTML definiert sind, und imperativen Tools, die in JavaScript definiert sind, zu filtern. Damit alle Tooltypen angezeigt werden, darf keiner der Filter aktiv sein.

Testtools manuell testen

Sie können die Entscheidungslogik des KI-Agenten umgehen, um die Zuverlässigkeit Ihres Tools unabhängig zu testen. Das ist nützlich, um die Funktionslogik zu überprüfen, ohne auf eine bestimmte Aufforderung des Agenten warten zu müssen.

  1. Klicken Sie in der Liste Verfügbare Tools auf das Tool, das Sie testen möchten. Alternativ können Sie im Protokoll Aufgerufene Tools den Mauszeiger auf ein Tool bewegen, um das Symbol Wiedergeben (➜) aufzurufen, und darauf klicken. Der Bereich für manuelle Tests wird geöffnet.

  2. Geben Sie im Bereich für manuelle Tests Parameter in die Eingabefelder ein oder passen Sie sie an.

  3. Klicken Sie auf Tool ausführen.

Wenn Sie den Mauszeiger auf ein Element in der Liste „Aufgerufene Tools“ bewegen, wird das Google Play-Symbol angezeigt und der vorausgefüllte Bereich für manuelle Tests wird geöffnet.

Probleme mit der Integration beheben

Im Bereich WebMCP können Sie häufige Integrationsfehler diagnostizieren:

  • Schemaverletzungen:Im Ausgabebereich werden Fehlermeldungen angezeigt, wenn die Toolparameter oder Rückgabewerte nicht dem definierten Schema entsprechen.
  • Ablehnung des Agents:Prüfen Sie den Aufrufzähler in der Liste Verfügbare Tools, um zu sehen, ob der Agent Ihr Tool jemals für einen bestimmten Prompt in Betracht gezogen hat.

Automatisierung und Agenten

WebMCP wurde für das agentische Web entwickelt, in dem KI-Agenten die Tools Ihrer Website erkennen und mit ihnen interagieren können. Für die agentengestützte Entwicklung bietet das Projekt Chrome DevTools for Agents eine spezielle Schnittstelle, die dieses Protokoll verwendet, um KI-Agents beim Testen und Verwenden Ihrer WebMCP-Tools zu unterstützen.

Befehlszeilen-Flags

Für die Interaktion mit bestimmten agentenbasierten Schnittstellen müssen Sie das Flag --categoryWebMCP explizit aktivieren.

Weitere Informationen

Weitere Informationen zu WebMCP und dem agentischen Web finden Sie in den folgenden Ressourcen: