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

يتم تقديم واجهة برمجة التطبيقات هذه في إصدار تجريبي، ولا تخضع لأي اتفاقية مستوى خدمة أو سياسة الإيقاف النهائي. قد يتم إجراء تغييرات على واجهة برمجة التطبيقات هذه تؤدي إلى عدم توافقها مع الأنظمة القديمة.

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

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

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

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

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

القيود

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

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

لتقديم تعليمات النظام، أنشئ كائن 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 رمز مميّز).
• الاختبار والتكرار: يمكن أن يختلف سلوك النموذج استنادًا إلى الصياغة. اختبِر النموذج باستخدام مدخلات مختلفة من المستخدِمين لضمان الحفاظ على شخصيته باستمرار.