Zarejestrowane narzędzia to konkretne funkcje (np. „Zarezerwuj stolik” lub „Dodaj do koszyka”), które Twoja witryna udostępnia agentom AI.
Jak działa audyt zarejestrowanych narzędzi WebMCP
Ten audyt ma charakter informacyjny. Lighthouse wyświetla listę wszystkich narzędzi WebMCP zarejestrowanych na stronie za pomocą interfejsów API deklaratywnych lub imperatywnych. Jeśli nie zarejestrowano żadnych narzędzi, lista wyników będzie pusta.
Lighthouse wyświetla ostrzeżenie, gdy zarejestrowanych jest więcej niż 40 narzędzi. Jeśli uwzględnisz zbyt wiele narzędzi, prawdopodobnie zużyjesz tokeny kontekstu modelu, zwiększysz opóźnienie i zwiększysz ryzyko, że agenci będą mieli problem z wyborem odpowiedniego narzędzia.
Rozwiązanie
Narzędzia możesz rejestrować za pomocą interfejsu Declarative API lub Imperative API:
- Deklaratywny interfejs API: dodaj atrybuty
toolnameitooldescriptionbezpośrednio do elementów<form>. - Interfejs API w trybie imperatywnym: użyj JavaScriptu, aby zarejestrować narzędzia za pomocą
document.modelContext.registerTool.
Sprawdzone metody
- Używaj jasnych nazw zorientowanych na działanie (np.
toolname="book_appointment"). - Podaj szczegółowe opisy, które wyjaśniają, co robi narzędzie i kiedy agent powinien go używać.
- Unikaj rejestrowania więcej niż 40 narzędzi naraz. Rejestruj narzędzia tylko wtedy, gdy są przydatne w bieżącym stanie strony, i wyrejestrowuj je, gdy nie są już potrzebne.
- Więcej informacji znajdziesz w dokumentacji WebMCP.