ضبط تعليمات النظام

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

تشمل حالات الاستخدام الشائعة ما يلي:

• تحديد شخصية: على سبيل المثال، "أنت مدرّس رياضيات متعاون".
• فرض تنسيق الردّ: على سبيل المثال، "أريد دائمًا الردّ باستخدام نقاط تعداد".
• وضع قيود: على سبيل المثال، "لا تجِب عن أسئلة حول السياسة".

المتطلبات الأساسية

تعمل تعليمات النظام على الأجهزة التي تستخدم الإصدار 3 من Gemini Nano والإصدارات الأحدث. للحصول على قائمة بالأجهزة المتوافقة، يُرجى الاطّلاع على الأجهزة المتوافقة مع ميزة "الوصول المباشر إلى النماذج".

القيود

لا ننصح باستخدام تعليمات النظام مع التخزين المؤقت للبادئة. بشكل عام، استخدِم تعليمات النظام للتعليمات القصيرة التي تحدّد طريقة تصرّف النموذج، واستخدِم ميزة التخزين المؤقت للبادئة إذا كنت بحاجة إلى تكرار جزء كبير من طلبك في طلبات البحث وكنت بحاجة إلى تحسين الأداء.

كيفية استخدام تعليمات النظام

لتقديم تعليمات النظام، أنشئ كائن SystemInstruction ومرِّره إلى أداة إنشاء GenerateContentRequest:

import com.google.mlkit.genai.prompt.SystemInstruction
import com.google.mlkit.genai.prompt.TextPart
import com.google.mlkit.genai.prompt.generateContentRequest

// 1. Define the system instruction
val systemInstruction =
    SystemInstruction("You are a concise assistant. Answer in 2 sentences or less.")

// 2. Create the request
val request = generateContentRequest(TextPart("How does photosynthesis work?")) {
    this.systemInstruction = systemInstruction
}

// 3. Run inference
try {
    val response = generativeModel.generateContent(request)
    println(response.candidates.firstOrNull()?.text)
} catch (e: GenAiException) {
    // Handle SDK-specific exceptions
}

يمكنك تبسيط الرمز أكثر من خلال تمرير تعليمات النظام مباشرةً إلى أداة إنشاء طلبات generateContentRequest:

val request = generateContentRequest(
    SystemInstruction("You are a pirate. Speak like one."),
    TextPart("What is the weather like today?")
) {
    // Optional configurations like temperature
    temperature = 0.7f
}

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

في ما يلي بعض أفضل الممارسات عند استخدام تعليمات النظام:

• الوضوح والمباشرة: يتّبع النموذج التعليمات الواضحة والمباشرة بشكل أفضل من التعليمات الغامضة. في ما يلي بعض الأمثلة:
  • غير واضح (يجب تجنُّبه): "لا تكتب كثيرًا. حاوِل أن تكون مفيدًا وودودًا، وأن تنسّق الناتج بشكل جيد".
  • واضح (مفضّل): "أنت مساعد ودود في فريق دعم العملاء. يجب ألا تتجاوز ردودك 3 جمل كحد أقصى. نسِّق أي قوائم باستخدام نقاط تعداد".
• الإيجاز: على الرغم من فعالية تعليمات النظام، فإنّ التعليمات الطويلة جدًا يمكن أن تستهلك نافذة السياق المحدودة للنموذج.
• احتساب عدد الرموز المميّزة: تأكَّد من أنّ منطق احتساب الرموز المميّزة يتضمّن تعليمات النظام لتجنُّب التقليل من حجم الطلب. ننصحك بإبقاء تعليمات النظام أقل من 150 كلمة (من 100 إلى 200 رمز مميّز).
• الاختبار والتكرار: يمكن أن يختلف سلوك النموذج حسب الصياغة. اختبِر النموذج باستخدام مدخلات مختلفة من المستخدمين للتأكّد من أنّه يحافظ على شخصيته باستمرار.