Validade do esquema do WebMCP

Um esquema válido garante que o agente de IA entenda a estrutura dos dados que precisa fornecer.

Como a auditoria de validade do esquema do WebMCP falha

A auditoria falha se:

  • Um formulário tem uma tooldescription, mas não tem o atributo toolname.
  • Um formulário tem um toolname, mas não tem o atributo tooldescription.
  • Um campo de formulário obrigatório não tem um atributo name.

O Lighthouse também emite um alerta se um campo opcional tiver um name, mas estiver sem um toolparamdescription ou um <label> associado.

Como corrigir

  1. Garanta a simetria: sempre forneça um nome e uma descrição para cada ferramenta.
  2. Adicione nomes às entradas: verifique se cada elemento de entrada em um formulário de ferramenta tem um atributo name exclusivo.
  3. Forneça o contexto do parâmetro: adicione toolparamdescription às entradas para ajudar o agente a entender qual valor é esperado.