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ść 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 menu bocznym najwyższego poziomu wybierz panel WebMCP.
Panel Aplikacja w Narzędziach deweloperskich z wybranym panelem WebMCP w menu bocznym Aplikacja.

Omówienie interfejsu

Panel WebMCP korzysta z układu dwupanelowego, 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:aktualna 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 w takiej postaci, w jakiej widzi je agent AI. Znajduje się tu 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 klikniętymi ikonami stanu do filtrowania.

Wywołane narzędzia

Dziennik Wywołane narzędzia zawiera trwały zapis interakcji z narzędziami. Gdy wybierzesz wpis 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:wartość zwracana lub komunikat o błędzie podany przez narzędzie.

Filtrowanie dziennika

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 celu.
  • Typ stanu:filtruj wywołania według ich bieżącego stanu, np. Ukończono, Błąd, Anulowano lub W toku.
  • Typ narzędzia:wybierz, aby filtrować narzędzia deklaratywne zdefiniowane w HTML 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 komunikat 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ę Odtwórz, i otwórz wstępnie wypełniony obszar testu ręcznego.

Rozwiązywanie problemów z integracją

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

  • Naruszenia schematu: jeśli parametry narzędzia lub wartości zwracane nie pasują do zdefiniowanego schematu, w panelu danych wyjściowych wyświetlają się komunikaty o błędach.
  • Odrzucenie przez 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 przypadku danego prompta.

Automatyzacja i agenci

WebMCP jest przeznaczony do sieci agentów, w której agenci AI mogą wykrywać narzędzia w Twojej witrynie i wchodzić z nimi w interakcje. W przypadku tworzenia aplikacji z pomocą agentów projekt Chrome DevTools for agents udostępnia specjalny interfejs, który korzysta z tego protokołu, aby pomóc agentom AI w testowaniu i używaniu narzędzi WebMCP.

Flagi wiersza poleceń

Aby wchodzić w interakcje z niektórymi interfejsami agentów, musisz wyraźnie włączyć flagę --categoryWebMCP.

Przydatne materiały

Więcej informacji o WebMCP i sieci agentów znajdziesz w tych materiałach: