Debugowanie narzędzi WebMCP

Użyj panelu WebMCP w Narzędziach deweloperskich w Chrome, aby sprawdzać, debugować i testować narzędzia AI po stronie klienta, które Twoja witryna udostępnia agentom AI. Panel zapewnia pełną widoczność całego cyklu życia narzędzia, w tym rejestracji, weryfikacji schematu i historii wywołań.

Otwieranie panelu WebMCP

Panel WebMCP znajduje się w panelu Aplikacja. Aby go otworzyć, wykonaj te czynności:

  1. Otwórz Narzędzia deweloperskie w Chrome na stronie, która korzysta z narzędzi WebMCP.
  2. Kliknij kartę Aplikacja.
  3. W górnej części paska bocznego wybierz panel WebMCP.
Panel Aplikacja w Narzędziach deweloperskich z wybranym panelem WebMCP na pasku bocznym Aplikacja.

Omówienie interfejsu

Panel WebMCP ma układ dwupanelowy, który ułatwia zarządzanie narzędziami i ich monitorowanie:

  • Wywołane narzędzia: chronologiczny dziennik interakcji między agentem AI a stroną.
  • Dostępne narzędzia: lista wszystkich narzędzi WebMCP wykrytych na aktywnej karcie.

Dostępne narzędzia

W sekcji Dostępne narzędzia wyświetlają się nazwy i opisy narzędzi, które widzi agent AI. Zawiera też licznik wywołań każdego narzędzia, który pokazuje, ile razy narzędzie zostało wywołane podczas bieżącej sesji.

Lista Dostępne narzędzia z licznikiem wywołań i ikonami stanu, które można kliknąć, aby filtrować wyniki.

Wywoływane narzędzia

Dziennik Wywołane narzędzia zawiera trwały zapis interakcji z narzędziami. Po wybraniu wpisu w dzienniku możesz sprawdzić te szczegóły:

  • Stan: wynik wywołania (Ukończono, Anulowano, W toku lub Błąd).
  • Dane wejściowe: dokładne parametry, które agent przewidział i wysłał do narzędzia.
  • Dane wyjściowe: zwracana wartość lub komunikat o błędzie podany przez narzędzie.

Filtrowanie logu

Użyj paska Filtr, aby zawęzić listę wywołanych narzędzi na podstawie tych kryteriów:

  • Nazwa lub opis: wpisz tekst, aby znaleźć narzędzia pasujące do określonej nazwy lub przeznaczenia.
  • Typ stanu: filtruj połączenia według ich bieżącego stanu, np. Zakończono, Błąd, Anulowano lub W toku.
  • Typ narzędzia: wybierz, aby filtrować narzędzia deklaratywne zdefiniowane w HTML-u i narzędzia imperatywne zdefiniowane w JavaScript. Aby wyświetlić wszystkie typy narzędzi, upewnij się, że żaden filtr nie jest aktywny.

Ręczne testowanie narzędzi

Możesz pominąć logikę decyzyjną agenta AI, aby niezależnie przetestować niezawodność narzędzia. Jest to przydatne do weryfikowania logiki funkcji bez czekania na konkretny prompt agenta.

  1. Na liście Dostępne narzędzia kliknij narzędzie, które chcesz przetestować. Możesz też w dzienniku Wywołane narzędzia najechać kursorem na narzędzie, aby wyświetlić ikonę Odtwórz (➜), a następnie ją kliknąć. Otworzy się obszar testu ręcznego.

  2. W obszarze testu ręcznego wpisz lub dostosuj parametry w polach wejściowych.

  3. Kliknij Uruchom narzędzie.

Najedź kursorem na element na liście Wywołane narzędzia, aby wyświetlić ikonę odtwarzania i otworzyć wstępnie wypełniony obszar testu ręcznego.

Rozwiązywanie problemów z integracją

Panel WebMCP pomaga diagnozować typowe błędy integracji:

  • Naruszenia schematu: w panelu wyjściowym wyświetlają się komunikaty o błędach, jeśli parametry narzędzia lub zwracane wartości nie pasują do zdefiniowanego schematu.
  • Odrzucenie agenta: sprawdź licznik wywołań na liście Dostępne narzędzia, aby zobaczyć, czy agent kiedykolwiek rozważał użycie Twojego narzędzia w odpowiedzi na dany prompt.

Automatyzacja i agenty

WebMCP jest przeznaczony dla sieci agentów, w której agenty AI mogą wykrywać narzędzia w Twojej witrynie i wchodzić z nimi w interakcje. W przypadku rozwoju z pomocą agenta projekt Narzędzia deweloperskie w Chrome dla agentów udostępnia specjalny interfejs, który korzysta z tego protokołu, aby pomagać agentom AI w testowaniu i używaniu narzędzi WebMCP.

Flagi wiersza poleceń

Aby korzystać z niektórych interfejsów agenta, musisz wyraźnie włączyć flagę --categoryWebMCP.

Przydatne materiały

Więcej informacji o WebMCP i sieci opartej na agentach znajdziesz w tych materiałach: