WebMCP في Laravel: أضف أدوات وكلاء الذكاء الاصطناعي إلى تطبيق PHP

في تطبيق Laravel كل ما تحتاجه أدوات WebMCP موجود أصلًا: المسارات، والتحقق، وpolicies، والجلسة. ولا تضيف سوى سكربت صغير إلى الصفحة. جديد على الموضوع؟ ابدأ بمقال ما هو WebMCP.

الخطوة 1: مسار JSON صغير

استخدم مسارًا في routes/web.php لتسري جلسة الزائر، وأضف حدًّا لمعدّل الطلبات:

Route::get('/agent/products', function (Illuminate\Http\Request $request) {
    $data = $request->validate(['q' => 'required|string|max:80']);

    return App\Models\Product::query()
        ->where('published', true)
        ->where('name', 'like', '%'.$data['q'].'%')
        ->limit(5)
        ->get(['name', 'price', 'slug']);
})->middleware('throttle:30,1');

اختر فقط الأعمدة التي يحق للعميل رؤيتها. ولا تُعِد النموذج كاملًا أبدًا.

الخطوة 2: سجّل الأداة في Blade

أضف سكربتًا إلى التخطيط، أو ادفعه فقط إلى الصفحات التي تحتاج إليه:

@push('scripts')
<script>
  const mc = document.modelContext || navigator.modelContext;
  if (mc && mc.registerTool) {
    mc.registerTool({
      name: 'search_products',
      description: 'Search published products. Returns name, price and slug.',
      inputSchema: {
        type: 'object',
        properties: { q: { type: 'string', description: 'Keywords' } },
        required: ['q'],
      },
      annotations: { readOnlyHint: true },
      execute: async ({ q }) => {
        const res = await fetch('/agent/products?q=' + encodeURIComponent(q));
        return await res.text();
      },
    });
  }
</script>
@endpush

الخطوة 3: نماذج Blade كأدوات

أضف toolname وtooldescription إلى نموذج لديك بالفعل. تصبح الحقول ذات التسميات مدخلات الأداة. وأبقِ @csrf في مكانه. ويعبّئ المتصفح النموذج، ويبقى الزائر افتراضيًا هو من يضغط الزر.

الخطوة 4: الإجراءات الحساسة

في أداة POST، أرسل رمز CSRF في ترويسة X-CSRF-TOKEN، وتحقّق من صلاحية الإجراء عبر policy كالمعتاد. وميّز الأداة بـ consequentialHint: true.

قواعد الأمان

• ابدأ بالقراءة فقط. البحث والتفاصيل أولًا، وميّزها بـ readOnlyHint.
• اسأل قبل التنفيذ. ميّز إجراءات السلة والحجز والنماذج بـ consequentialHint ليؤكّدها الزائر.
• تحقّق على الخادم. المتصفح ليس حدًّا أمنيًّا، لذا تحقّق من كل مدخل وكل صلاحية في الواجهة الخلفية.
• أعِد أقل قدر ممكن. أرسل فقط ما يحق للعميل رؤيته، ولا ترسل أبدًا بيانات الإدارة أو سجلات عملاء آخرين.

اختبر الأدوات

1. استخدم إصدارًا حديثًا من Chrome مع تفعيل WebMCP، عبر التجربة الأولية (origin trial) أو إعداد الاختبار.
2. استدعِ كل أداة بمدخلات صحيحة وأخرى خاطئة.
3. تأكّد من أن الزوار العاديين لا يلاحظون أي تغيير.
4. شغّل فاحص WebMCP المجاني على الصفحة نفسها التي توجد فيها أدواتك.

تريد أن ننفّذه لك؟

نضيف WebMCP إلى تطبيقات Laravel وPHP. اطّلع على خدمات دمج WebMCP، أو افحص إصدار PHP الحالي لديك عبر فاحص إصدار PHP المجاني.