Un esquema válido garantiza que el agente de IA comprenda la estructura de los datos que debe proporcionar.
Cómo falla la auditoría de validez del esquema de WebMCP
La auditoría falla en los siguientes casos:
- Un formulario tiene un
tooldescription, pero le falta el atributotoolname. - Un formulario tiene un
toolname, pero le falta el atributotooldescription. - A un campo de formulario obligatorio le falta un atributo
name.
Lighthouse también emite una advertencia si un campo opcional tiene un name, pero le
falta un toolparamdescription o una <label> asociada.
Cómo corregirlo
- Asegúrate de que haya simetría: Siempre proporciona un nombre y una descripción para cada herramienta.
- Agrega nombres a las entradas: Verifica que cada elemento de entrada dentro de un formulario de herramienta tenga un atributo
nameúnico. - Proporciona contexto de parámetros: Agrega
toolparamdescriptiona las entradas para ayudar al agente a comprender qué valor se espera.