有効なスキーマにより、AI エージェントは提供する必要があるデータの構造を理解できます。
WebMCP スキーマの有効性監査が失敗する原因
次の場合、監査は失敗します。
- フォームに
tooldescriptionがあるが、toolname属性がない。 - フォームに
toolnameがあるが、tooldescription属性がない。 - 必須のフォーム フィールドに
name属性がない。
また、オプションのフィールドに name があるが、
toolparamdescription または関連付けられた <label> がない場合、Lighthouse は警告を発行します。
修正方法
- 対称性を確保する: すべてのツールに名前と説明の両方を必ず入力します。
- 入力に名前を追加する: ツールフォーム内のすべての入力要素に一意の
name属性があることを確認します。 - パラメータのコンテキストを指定する: エージェントが想定される値を理解できるように、入力に
toolparamdescriptionを追加します。