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

أدوات WebMCP في الصفحة لا يستطيع الوكيل استخدامها

webmcp-tools-invalidبسيط
في هذه الصفحة

لماذا يهم

  • يتيح 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: أداة بلا اسم أو وصف، ومعامل مطلوب بلا اسم؛ ونزيد عليها وصف مدخلات ليس كائناً. ويذكر كل خطأ المحركات التي رأته.