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

  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 panelem WebMCP wybranym na pasku bocznym Aplikacja.
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: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 w bieżącej sesji.

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

Wywołane narzędzia

Log Wywołane narzędzia zawiera trwały zapis interakcji z narzędziami. Po wybraniu wpisu w logu 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 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 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 logu Wywołane narzędzia najechać kursorem na narzędzie, aby wyświetlić ikonę Odtwórz (➜), i kliknąć ją. Otworzy się obszar testu ręcznego. Uwaga: jeśli narzędzie zostało wybrane z listy Dostępne narzędzia, parametry w obszarze testu ręcznego są puste. Jeśli natomiast wybrano wywołane narzędzie, obszar testu ręcznego otworzy się z już wypełnionymi parametrami z tej sesji.
  2. W obszarze testu ręcznego wpisz lub dostosuj parametry w polach wejściowych.
  3. Kliknij Uruchom narzędzie.
Najechanie kursorem na element na liście Wywołane narzędzia, aby wyświetlić ikonę odtwarzania, i otwarcie wstępnie wypełnionego obszaru testu ręcznego.
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 wyjściowym 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 odpowiedzi na dany komunikat.

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ą agenta projekt Chrome DevTools for agents udostępnia specjalny interfejs, który używa tego protokołu, aby pomóc agentom AI testować i używać narzędzi WebMCP.

Flagi wiersza poleceń

Niektóre interfejsy agentów wymagają wyraźnego włączenia flagi --categoryWebMCP.

Przydatne materiały

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