لماذا يهم
- يبني الوكيل قيمة كل معامل من اسمه ووصفه. معامل اسمه
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 في النماذج)، ونعدّ الأدوات في الصفحة.
المراجع
- مسودة WebMCP في مجموعة W3C لتعلم الآلة على الويب (بالإنجليزية)
- Lighthouse: تدقيقات WebMCP (بالإنجليزية)