لماذا يهم
- يتيح WebMCP للصفحة أن تعرض على وكلاء الذكاء الاصطناعي في المتصفح أفعالاً محددة، مثل البحث في المنتجات أو حجز موعد، بدل أن يحاول الوكيل النقر في الصفحة.
- الوكيل يختار الأداة من اسمها ووصفها، ويبني مدخلاتها من وصفها (JSON Schema). أداة بلا اسم لا تُستدعى، وبلا وصف لا تُختار، ومعامل مطلوب بلا اسم لا يُملأ.
- هذه هي الأخطاء التي يعدّها تدقيق webmcp-schema-validity في Lighthouse 13.6 فاشلة.
مثال
<script> navigator.modelContext?.registerTool({ name: 'search_products', execute: () => [] }) </script>
<script> navigator.modelContext?.registerTool({ name: 'search_products', description: 'ابحث في منتجات المتجر', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'ما يبحث عنه الزائر' } } }, execute: () => [] }) </script>
كيف تُصلح
أعطِ كل أداة اسماً ووصفاً، ووصفاً للمدخلات بنوع object وأسماء لكل خصائصه:
html
<script>
navigator.modelContext?.registerTool({
name: 'search_products',
description: 'ابحث في منتجات المتجر بالاسم أو الفئة',
inputSchema: {
type: 'object',
properties: { query: { type: 'string', description: 'ما يبحث عنه الزائر' } },
required: ['query'],
},
execute: async ({ query }) => searchProducts(query),
})
</script>وفي النماذج: toolname وtooldescription على <form>، وname على كل حقل مطلوب.
كيف نكشف
قبل أن تعمل سكربتات الصفحة، نضع في كل محرك (Chromium وFirefox وWebKit) مسجِّلاً لـ navigator.modelContext وdocument.modelContext يحفظ ما تُعطاه registerTool وprovideContext: الاسم والوصف ووصف المدخلات. ولا نستدعي أي أداة. وبعد التحميل نقرأ النماذج التي لها toolname. ثم نطبق أخطاء Lighthouse: أداة بلا اسم أو وصف، ومعامل مطلوب بلا اسم؛ ونزيد عليها وصف مدخلات ليس كائناً. ويذكر كل خطأ المحركات التي رأته.
المراجع
- مسودة WebMCP في مجموعة W3C لتعلم الآلة على الويب (بالإنجليزية)
- Lighthouse: تدقيق webmcp-schema-validity (بالإنجليزية)
- JSON Schema (بالإنجليزية)