As ferramentas registradas são os recursos específicos (como "Reservar uma mesa" ou "Adicionar ao carrinho") que seu site expõe aos agentes de IA.
Como funciona a auditoria de ferramentas registradas do WebMCP
Essa auditoria é informativa. O Lighthouse lista todas as ferramentas do WebMCP registradas na página usando as APIs declarativa ou imperativa. Se nenhuma ferramenta estiver registrada, a lista de resultados vai ficar vazia.
O Lighthouse emite um aviso quando mais de 40 ferramentas são registradas. Ao incluir um excesso de ferramentas, é provável que você consuma tokens de contexto do modelo, adicione latência e aumente o risco de confusão para os agentes sobre qual ferramenta usar.
Como corrigir
É possível registrar ferramentas usando a API declarativa ou a API imperativa:
- API declarativa: adicione atributos
toolnameetooldescriptiondiretamente aos elementos<form>. - API imperativa: use JavaScript para registrar ferramentas usando
document.modelContext.registerTool.
Práticas recomendadas
- Use nomes claros e orientados à ação (por exemplo,
toolname="book_appointment"). - Forneça descrições detalhadas que expliquem o que a ferramenta faz e quando um agente deve usá-la.
- Evite registrar mais de 40 ferramentas de uma só vez. Registre ferramentas apenas quando elas forem úteis para o estado atual da página e cancele o registro quando não forem mais necessárias.
- Para saber mais, leia a documentação do WebMCP.