انتقل إلى المحتوى

أدوات WebMCP بمعاملات غير موصوفة أو بعدد كبير

webmcp-tools-unclearمعلومة
في هذه الصفحة

لماذا يهم

  • يبني الوكيل قيمة كل معامل من اسمه ووصفه. معامل اسمه q أو d بلا وصف قد يُملأ بما لا تقصده.
  • والصفحة التي تعرض عشرات الأدوات تزحم اختيار الوكيل، فيخطئ الأداة أو يتركها. ويحذّر Lighthouse 13.6 فوق 40 أداة.
  • هذه معلومة: Lighthouse يعطي هذه التحذيرات نصف الدرجة لا صفراً.

مثال

خطأ
<script>
  navigator.modelContext?.registerTool({ name: 'search_products', description: 'ابحث في منتجات المتجر', inputSchema: { type: 'object', properties: { q: { type: 'string' } } }, execute: () => [] })
</script>
صحيح
<script>
  navigator.modelContext?.registerTool({ name: 'search_products', description: 'ابحث في منتجات المتجر', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'ما يبحث عنه الزائر' } } }, execute: () => [] })
</script>

كيف تُصلح

صف كل معامل بـ description (أو title)، وفي النماذج بالخاصية toolparamdescription، واجمع الأدوات المتشابهة في أداة واحدة بمعامل يختار بينها:

html
<form toolname="book_table" tooldescription="احجز طاولة في المطعم">
  <input name="date" type="date" toolparamdescription="يوم الحجز" required>
  <input name="people" type="number" toolparamdescription="عدد الأشخاص">
</form>

كيف نكشف

بالمسجِّل نفسه الذي تقرؤه قاعدة أدوات WebMCP غير الصالحة، في كل محرك: نعدّ لكل أداة معاملاتها، والتي بلا عنوان ولا وصف منها (أو بلا اسم أو toolparamdescription في النماذج)، ونعدّ الأدوات في الصفحة.