ضبط MCP (بروتوكول سياق النموذج)

يمكنك اختيارياً ربط نقطة نهاية MCP حتى يتمكن الرفيق الذكي من جلب سياق إضافي (مثل بيانات المستخدم، معلومات الحساب) عند إنشاء اقتراحات الردود. توفّر عنوان URL، وسراً للمصادقة، ومخطط JSON يصف الهيكل الذي يتوقعه endpoint الخاص بك.

ما هو MCP؟

MCP (Model Context Protocol) يتيح لك كشف نقطة نهاية HTTPS تُرجع بياناتاً للذكاء الاصطناعي. عند معالجة رسالة عميل، يمكن لـ SupportRetriever استدعاء endpoint الخاص بك بهيكل JSON (بحسب مخططك) واستخدام الاستجابة لإثراء الاقتراحات. استخدامات نموذجية:

• البحث عن بيانات العميل أو الحساب بالبريد أو المعرّف
• جلب معلومات الاشتراك أو الاستخدام
• سحب بيانات من backend أو CRM خاص بك

مفتاح السرّ يُخزَّن مشفّراً ولا يُعاد أبداً. يُخزَّن فقط عنوان URL والمخطط (body) وتخطيط الحقول بشكل واضح.

متى تستخدم MCP

استخدم MCP عندما:

• تريد أن يكون للذكاء الاصطناعي وصول لبيانات ليست في قاعدة المعرفة (مثل بيانات لكل مستخدم أو لكل حساب).
• تلك البيانات خلف API تتحكم به ويمكنك كشفه عبر HTTPS بمفتاح سرّ مشترك.

يمكنك استخدام عنوان URL لقاعدة المعرفة و MCP معاً: قاعدة المعرفة توفّر التوثيق العام، و MCP يوفّر السياق الخاص بكل طلب.

إعداد MCP

1. اذهب إلى إعدادات الرفيق الذكي وافتح قسم MCP (انقر تعديل بجانب MCP إن كان مطوياً).
2. أدخل عنوان URL (يجب أن يكون HTTPS)، مثلاً https://api.example.com/mcp.
3. أدخل مفتاح السرّ (يُستخدم لمصادقة الطلبات إلى endpoint). يُشفَّر قبل التخزين. اترك الحقل فارغاً عند التعديل إن لم ترد تغيير السرّ الحالي.
4. أدخل Body كمخطط JSON يصف الـ payload الذي يتوقعه endpoint (مثلاً JSON Schema بكائن properties في المستوى الأعلى).
5. إن كان للمخطط properties، تظهر جدول تخطيط الحقول. لكل خاصية، اختر مصدر القيمة:
   • اسم العميل — من حقل الاسم في الإرسال
   • بريد العميل — من حقل البريد في الإرسال
   • مفتاح البيانات الوصفية — من بيانات وصفية لإرسال النموذج (مثلاً معاملات URL مثل ?userId=123); أدخل اسم مفتاح البيانات الوصفية (مثلاً userId).
6. انقر حفظ لتخزين الإعداد، أو إزالة MCP لمسحه.

عنوان URL والسرّ

• عنوان URL: يجب أن يكون عنوان HTTPS صالحاً. سيرسل SupportRetriever طلباً إلى هذا العنوان عند الحاجة للسياق (تنفيذ الاستدعاء الفعلي ت handled بواسطة المنتج؛ هذا المقال يصف الإعداد فقط).
• مفتاح السرّ: يُخزَّن مشفّراً. استخدمه على خادمك للتحقق من أن الطلبات من SupportRetriever (مثلاً عبر header أو توقيع). لا تشاركه؛ دوّره إن تعرّض للاختراق.

Body (مخطط JSON)

يجب أن يكون Body مخطط JSON يحدد هيكل جسم الطلب المرسل إلى endpoint. مثلاً:

{
  "type": "object",
  "properties": {
    "uid": { "type": "string", "description": "Firebase UID" },
    "emails": {
      "type": "array",
      "items": { "type": "string", "format": "email" },
      "maxItems": 10,
      "description": "Look up by email(s)"
    }
  }
}

بمجرد لصق مخطط صالح بكائن properties في المستوى الأعلى، تعرض الواجهة جدول تخطيط الحقول لربط كل خاصية بمصدر بيانات (اسم العميل، بريد العميل، أو مفتاح بيانات وصفية).

تخطيط الحقول

يربط التخطيط كل خاصية في المخطط بمصدر القيمة وقت الطلب:

• اسم العميل — القيمة من حقل الاسم في إرسال النموذج.
• بريد العميل — القيمة من حقل البريد في إرسال النموذج.
• مفتاح البيانات الوصفية — القيمة من بيانات وصفية الإرسال (مثلاً من معاملات URL عند فتح النموذج). أدخل اسم المفتاح بالضبط (مثلاً userId، campaign).

للخصائص من نوع مصفوفة أو كائن، المصدر المعيّن يبقى واحداً (مثلاً مفتاح بيانات وصفية واحد أو البريد)；كيفية بناء body النهائي يحددها المنتج عند استدعاء endpoint.

إزالة MCP

في قسم MCP، انقر إزالة MCP. هذا يمسح عنوان URL والسرّ والـ body والتخطيطات. إعدادات الرفيق الذكي وقاعدة المعرفة تبقى دون تغيير.

مواضيع ذات صلة

• إدارة إعدادات الرفيق الذكي — تعديل كل خيارات الرفيق الذكي
• ضبط قاعدة المعرفة — إضافة عنوان URL لقاعدة المعرفة
• أمان وخصوصية الرفيق الذكي — كيف نخزّن ونستخدم الأسرار