有效的結構定義可確保 AI 代理瞭解要提供的資料結構。
WebMCP 結構定義有效性稽核失敗的原因
如果發生以下情況,稽核就會失敗:
- 表單含有
tooldescription,但缺少toolname屬性。 - 表單含有
toolname,但缺少tooldescription屬性。 - 必填表單欄位缺少
name屬性。
如果選填欄位有 name,但缺少 toolparamdescription 或相關聯的 <label>,Lighthouse 也會發出警告。
如何修正
- 確保對稱性:請務必為每個工具提供名稱和說明。
- 為輸入內容新增名稱:確認工具表單中的每個輸入元素都有不重複的
name屬性。 - 提供參數內容:在輸入內容中加入
toolparamdescription,協助代理程式瞭解預期值。