وثائق MCP الرسمية باللغة العربية
  1. المفاهيم
وثائق MCP الرسمية باللغة العربية
  • البدء
    • مقدمة
    • خوادم المثال
    • أمثلة على العملاء
    • البدء السريع
      • لمطوري الخوادم
      • للمطورين العملاء
      • لمستخدمي سطح مكتب كلود
  • دروس تعليمية
    • LLMs بناء MCP مع
    • تصحيح الأخطاء
    • مفتش
  • المفاهيم
    • الهندسة المعمارية الأساسية
    • موارد
    • المطالبات
    • أدوات
    • أخذ العينات
    • الجذور
    • وسائل النقل
  • تطوير
    • ما الجديد
    • خريطة الطريق
    • المساهمة
  1. المفاهيم

أخذ العينات

دع خوادمك تطلب إكمالًا من نماذج اللغة الكبيرة (LLMs)
تعد المعاينة (Sampling) ميزة قوية في Model Context Protocol (MCP) تسمح للخوادم بطلب إكمالات من نماذج اللغة الكبيرة (LLMs) من خلال العميل، مما يتيح سلوكيات وكيلية متطورة مع الحفاظ على الأمان والخصوصية.
هذه الميزة في Model Context Protocol (MCP) غير مدعومة بعد في عميل Claude Desktop.

كيف تعمل المعاينة#

يتبع تدفق المعاينة هذه الخطوات:
1.
يرسل الخادم طلب sampling/createMessage إلى العميل
2.
يراجع العميل الطلب ويمكنه تعديله
3.
يقوم العميل بالمعاينة من نموذج لغة كبير (LLM)
4.
يراجع العميل الإكمال
5.
يعيد العميل النتيجة إلى الخادم
يضمن هذا التصميم الذي يضع الإنسان في الحلقة سيطرة المستخدمين على ما يراه نموذج اللغة الكبيرة (LLM) وينشئه.

تنسيق الرسالة#

تستخدم طلبات المعاينة تنسيق رسالة موحد:

معلمات الطلب#

الرسائل#

تحتوي مصفوفة messages على سجل المحادثة المراد إرساله إلى نموذج اللغة الكبيرة (LLM). تحتوي كل رسالة على:
role: إما "user" أو "assistant"
content
: محتوى الرسالة، والذي يمكن أن يكون:
محتوى نصي مع حقل text
محتوى صورة مع حقول data (base64) و mimeType

تفضيلات النموذج#

يسمح كائن modelPreferences للخوادم بتحديد تفضيلات اختيار النموذج الخاص بها:
hints: مصفوفة من اقتراحات اسم النموذج التي يمكن للعملاء استخدامها لتحديد نموذج مناسب:
name: سلسلة يمكن أن تطابق أسماء النماذج الكاملة أو الجزئية (مثل "claude-3"، "sonnet")
قد يقوم العملاء بتعيين تلميحات لنماذج مكافئة من موفري خدمات مختلفين
يتم تقييم التلميحات المتعددة بترتيب الأفضلية
قيم الأولوية (0-1 مُعيرة):
costPriority: أهمية تقليل التكاليف
speedPriority: أهمية الاستجابة بزمن انتقال منخفض
intelligencePriority: أهمية القدرات النموذجية المتقدمة
يتخذ العملاء القرار النهائي بشأن اختيار النموذج بناءً على هذه التفضيلات والنماذج المتاحة لديهم.

موجه النظام#

يسمح حقل systemPrompt الاختياري للخوادم بطلب موجه نظام محدد. قد يقوم العميل بتعديل هذا أو تجاهله.

تضمين السياق#

تحدد المعلمة includeContext سياق Model Context Protocol (MCP) المراد تضمينه:
"none": لا يوجد سياق إضافي
"thisServer": تضمين السياق من الخادم الطالب
"allServers": تضمين السياق من جميع خوادم Model Context Protocol (MCP) المتصلة
يتحكم العميل في السياق الذي يتم تضمينه بالفعل.

معلمات المعاينة#

اضبط معاينة نموذج اللغة الكبيرة (LLM) باستخدام:
temperature: يتحكم في العشوائية (0.0 إلى 1.0)
maxTokens: الحد الأقصى للرموز المميزة التي سيتم إنشاؤها
stopSequences: مصفوفة من التسلسلات التي توقف الإنشاء
metadata: معلمات إضافية خاصة بموفر الخدمة

تنسيق الاستجابة#

يعيد العميل نتيجة الإكمال:

مثال على الطلب#

إليك مثال على طلب المعاينة من عميل:
{
  "method": "sampling/createMessage",
  "params": {
    "messages": [
      {
        "role": "user",
        "content": {
          "type": "text",
          "text": "What files are in the current directory?"
        }
      }
    ],
    "systemPrompt": "You are a helpful file system assistant.",
    "includeContext": "thisServer",
    "maxTokens": 100
  }
}

أفضل الممارسات#

عند تنفيذ المعاينة:
1.
قدم دائمًا مطالبات واضحة ومنظمة جيدًا
2.
تعامل مع كل من محتوى النص والصورة بشكل مناسب
3.
ضع حدودًا معقولة للرموز المميزة
4.
قم بتضمين السياق ذي الصلة من خلال includeContext
5.
تحقق من صحة الردود قبل استخدامها
6.
تعامل مع الأخطاء بأمان
7.
ضع في اعتبارك تقييد معدل طلبات المعاينة
8.
وثق سلوك المعاينة المتوقع
9.
اختبر مع معلمات نموذجية مختلفة
10.
راقب تكاليف المعاينة

عناصر التحكم البشرية في الحلقة#

تم تصميم المعاينة مع وضع الإشراف البشري في الاعتبار:

للمطالبات#

يجب على العملاء عرض المطالبة المقترحة للمستخدمين
يجب أن يكون المستخدمون قادرين على تعديل المطالبات أو رفضها
يمكن تصفية أو تعديل مطالبات النظام
يتم التحكم في تضمين السياق بواسطة العميل

لعمليات الإكمال#

يجب على العملاء عرض الإكمال للمستخدمين
يجب أن يكون المستخدمون قادرين على تعديل عمليات الإكمال أو رفضها
يمكن للعملاء تصفية عمليات الإكمال أو تعديلها
يتحكم المستخدمون في النموذج المستخدم

اعتبارات الأمان#

عند تنفيذ المعاينة:
تحقق من صحة جميع محتويات الرسالة
قم بتطهير المعلومات الحساسة
قم بتنفيذ حدود المعدل المناسبة
راقب استخدام المعاينة
قم بتشفير البيانات أثناء النقل
تعامل مع خصوصية بيانات المستخدم
تدقيق طلبات المعاينة
السيطرة على التعرض للتكاليف
تنفيذ المهلات
تعامل مع أخطاء النموذج بأمان

الأنماط الشائعة#

تدفقات العمل الوكيلية#

تمكن المعاينة الأنماط الوكيلية مثل:
قراءة وتحليل الموارد
اتخاذ القرارات بناءً على السياق
إنشاء بيانات منظمة
التعامل مع المهام متعددة الخطوات
تقديم المساعدة التفاعلية

إدارة السياق#

أفضل الممارسات للسياق:
طلب الحد الأدنى من السياق الضروري
هيكلة السياق بوضوح
التعامل مع حدود حجم السياق
تحديث السياق حسب الحاجة
تنظيف السياق القديم

معالجة الأخطاء#

يجب أن تعالج معالجة الأخطاء القوية ما يلي:
اكتشاف حالات فشل المعاينة
التعامل مع أخطاء المهلة
إدارة حدود المعدل
التحقق من صحة الردود
توفير سلوكيات احتياطية
تسجيل الأخطاء بشكل مناسب

القيود#

كن على علم بهذه القيود:
تعتمد المعاينة على قدرات العميل
يتحكم المستخدمون في سلوك المعاينة
حجم السياق له حدود
قد يتم تطبيق حدود المعدل
يجب النظر في التكاليف
يختلف توافر النموذج
تختلف أوقات الاستجابة
لا يتم دعم جميع أنواع المحتوى
Modified at 2025-03-12 10:41:28
Previous
أدوات
Next
الجذور
Built with