WebMCP-Tools debuggen

Verwenden Sie den Bereich WebMCP in den Chrome-Entwicklertools, um die clientseitigen KI-Tools zu untersuchen, zu debuggen und zu testen, die Ihre Website für KI-Agents bereitstellt. 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 DevTools-Bereich „Anwendung“ mit dem ausgewählten Bereich „WebMCP“ in der Seitenleiste „Anwendung“.
Der Bereich „Anwendung“ in den 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 Bereich Verfügbare Tools werden die Tool-Namen und ‑Beschreibungen so angezeigt, wie sie für den KI-Agenten sichtbar sind. 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.
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 Kundenservicemitarbeiter vorhergesagt und an das Tool gesendet hat.
  • Ausgabe:Der Rückgabewert oder die Fehlermeldung des Tools.

Log filtern

Verwenden Sie die Filterleiste, 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. Wenn Sie alle Tooltypen sehen möchten, darf keiner der Filter aktiv sein.

Testtools manuell testen

Sie können die Entscheidungslogik des KI-Agents 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 Agents 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. Hinweis: Wenn Sie das Tool aus der Liste „Verfügbare Tools“ ausgewählt haben, sind die Parameter im Bereich für manuelle Tests leer. Wenn Sie ein aufgerufenes Tool ausgewählt haben, wird der Bereich für manuelle Tests geöffnet und die Parameter aus dieser Sitzung sind bereits eingetragen.
  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 mit dem Mauszeiger auf ein Element in der Liste „Aufgerufene Tools“ zeigen, wird das Play-Symbol eingeblendet und der vorausgefüllte Bereich für manuelle Tests wird geöffnet.
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.

Integrationsprobleme 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.
  • Agent-Ablehnung:Sehen Sie im Aufrufzähler in der Liste Verfügbare Tools nach, 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 Entwicklung mit Unterstützung durch KI-Agents 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

Bei 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: