WebMCP-Tools debuggen

Im Bereich WebMCP der Chrome-Entwicklertools können Sie die clientseitigen KI-Tools prüfen, debuggen und testen, die Ihre Website KI-Agenten zur Verfügung stellt. Der Bereich bietet vollständige End-to-End-Transparenz für den Tool-Lebenszyklus, einschließlich Registrierung, Schemaüberprüfung und Aufrufverlauf.

Bereich „WebMCP“ öffnen

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

  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 Seitenleiste auf oberster Ebene den Bereich WebMCP aus.
Der Bereich „Anwendung“ der Entwicklertools mit dem Bereich „WebMCP“ in der Seitenleiste „Anwendung“.

Übersicht: Benutzeroberfläche

Der Bereich WebMCP verwendet ein Layout mit zwei Bereichen, damit Sie Ihre Tools 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 Toolnamen 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 anklickbaren Statussymbolen zum Filtern.

Aufgerufene Tools

Das Protokoll Aufgerufene Tools enthält eine dauerhafte Aufzeichnung der Tool-Interaktionen. Wenn Sie einen Eintrag im Protokoll auswählen, können Sie die folgenden Details prüfen:

  • Status:Das Ergebnis des Aufrufs (Abgeschlossen, Abgebrochen, In Bearbeitung oder Fehler).
  • Eingabe:Die genauen Parameter, die der Agent vorhergesagt und an das Tool gesendet hat.
  • Ausgabe:Der Rückgabewert oder die Fehlermeldung des Tools.

Protokoll 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 Aufrufe nach ihrem aktuellen Status, z. B. Abgeschlossen, Fehler, Abgebrochen oder In Bearbeitung.
  • Tooltyp: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.

Tools 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 Agentenanfrage 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 Wiedergabe (➜) einzublenden, 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 Symbol „Wiedergabe“ eingeblendet und der Bereich für manuelle Tests wird mit den entsprechenden Parametern 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.
  • Agentenablehnung:Im Aufrufzähler in der Liste Verfügbare Tools können Sie sehen, ob der Agent Ihr Tool jemals für eine bestimmte Anfrage in Betracht gezogen hat.

Automatisierung und Agenten

WebMCP wurde für das agentengestützte Web entwickelt, in dem KI-Agenten die Tools Ihrer Website finden und mit ihnen interagieren können. Für die agentengestützte Entwicklung bietet das Chrome Entwicklertools für Agenten Projekt eine spezielle Schnittstelle, die dieses Protokoll verwendet, damit KI Agenten Ihre WebMCP-Tools testen und verwenden können.

Befehlszeilen-Flags

Um mit bestimmten agentengestützten Schnittstellen zu interagieren, müssen Sie das Flag --categoryWebMCP explizit aktivieren.

Weitere Informationen

Weitere Informationen zu WebMCP und dem agentengestützten Web finden Sie in den folgenden Ressourcen: