استخدام تعليمات النظام لتوجيه سلوك نموذج

تعليمات النظام هي بمثابة "مقدمة" تضيفها قبل أن يتلقّى النموذج أي تعليمات أخرى من المستخدم النهائي. ويتيح لك توجيه سلوك النموذج استنادًا إلى احتياجاتك وحالات الاستخدام المحدّدة.

تتوافق جميع نماذج Gemini مع تعليمات النظام. ولا تتوافق مع نماذج Imagen.

الانتقال إلى عيّنات التعليمات البرمجية


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

يمكنك استخدام تعليمات النظام بعدة طرق، منها:

  • تحديد شخصية أو دور (لروبوت محادثة مثلاً)
  • تحديد تنسيق الإخراج (Markdown وYAML وما إلى ذلك)
  • تحديد أسلوب الناتج ونبرته (مثلاً، مستوى التفصيل، ومدى الرسمية، والمستوى القرائي المستهدف)
  • تحديد أهداف أو قواعد للمهمة (على سبيل المثال، عرض مقتطف من الرمز البرمجي بدون تقديم المزيد من التوضيحات)
  • تقديم سياق إضافي للطلب (مثل تاريخ انتهاء المعلومات)

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

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

انقر على موفّر Gemini API لعرض المحتوى والرمز الخاصين بموفّر الخدمة على هذه الصفحة.

ضبط تعليمات النظام لحالات الاستخدام العامة

Swift

يمكنك تحديد systemInstruction عند إنشاء مثيل GenerativeModel.


import FirebaseAILogic

// Specify the system instructions as part of creating the `GenerativeModel` instance
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
  modelName: "GEMINI_MODEL_NAME",
  systemInstruction: ModelContent(role: "system", parts: "You are a cat. Your name is Neko.")
)

Kotlin

يمكنك تحديد systemInstruction عند إنشاء مثيل GenerativeModel.


// Specify the system instructions as part of creating the `GenerativeModel` instance
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
  modelName = "GEMINI_MODEL_NAME",
  systemInstruction = content { text("You are a cat. Your name is Neko.") }
)

Java

يمكنك تحديد systemInstruction عند إنشاء مثيل GenerativeModel.


// Specify the system instructions as part of creating the `GenerativeModel` instance
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
    .generativeModel(
      /* modelName */ "GEMINI_MODEL_NAME",
      /* generationConfig (optional) */ null,
      /* safetySettings (optional) */ null,
      /* requestOptions (optional) */ new RequestOptions(),
      /* tools (optional) */ null,
      /* toolsConfig (optional) */ null,
      /* systemInstruction (optional) */ new Content.Builder().addText("You are a cat. Your name is Neko.").build()
    );

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web

يمكنك تحديد systemInstruction عند إنشاء مثيل GenerativeModel.


// ...

const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Specify the system instructions as part of creating the `GenerativeModel` instance
const model = getGenerativeModel(ai, {
  model: "GEMINI_MODEL_NAME",
  systemInstruction: "You are a cat. Your name is Neko."
});

Dart

يمكنك تحديد systemInstruction عند إنشاء مثيل GenerativeModel.


// ...

// Specify the system instructions as part of creating the `GenerativeModel` instance
final model = FirebaseAI.googleAI().generativeModel(
  model: 'GEMINI_MODEL_NAME',
  systemInstruction: Content.system('You are a cat. Your name is Neko.'),
);

// ...

Unity

يمكنك تحديد systemInstruction عند إنشاء مثيل GenerativeModel.


// ...

var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Specify the system instructions as part of creating the `GenerativeModel` instance
var model = ai.GetGenerativeModel(
  modelName: "GEMINI_MODEL_NAME",
  systemInstruction: ModelContent.Text("You are a cat. Your name is Neko.")
);

ضبط تعليمات النظام لـ "Gemini Live API"

Swift

يمكنك تحديد systemInstruction عند إنشاء مثيل LiveModel.


// ...

// Specify the system instructions as part of creating the `liveModel` instance
let liveModel = FirebaseAI.firebaseAI(backend: .googleAI()).liveModel(
  modelName: "GEMINI_LIVE_MODEL_NAME",
  systemInstruction: ModelContent(role: "system", parts: "You are a cat. Your name is Neko."),
  // ...
)

// ...

Kotlin

يمكنك تحديد systemInstruction عند إنشاء مثيل LiveModel.


// ...

// Specify the system instructions as part of creating the `LiveModel` instance
val liveModel = Firebase.ai(backend = GenerativeBackend.googleAI()).liveModel(
    modelName = "GEMINI_LIVE_MODEL_NAME",
    systemInstruction = content { text("You are a cat. Your name is Neko.") },
    // ...
)

// ...

Java

يمكنك تحديد systemInstruction عند إنشاء مثيل LiveModel.


// ...

// Specify the system instructions as part of creating the `LiveModel` instance
LiveGenerativeModel lm = FirebaseAI.getInstance(GenerativeBackend.googleAI()).liveModel(
          /* modelName */ "GEMINI_LIVE_MODEL_NAME",
          /* systemInstruction (optional) */ new Content.Builder().addText("You are a cat. Your name is Neko.").build()
          // ...
);

LiveModelFutures liveModel = LiveModelFutures.from(lm);

// ...

Web

يمكنك تحديد systemInstruction عند إنشاء مثيل LiveGenerativeModel.


// ...

const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Specify the system instructions as part of creating the `LiveGenerativeModel` instance
const liveModel = getLiveGenerativeModel(ai, {
  model: "GEMINI_LIVE_MODEL_NAME",
  systemInstruction: "You are a cat. Your name is Neko.",
  // ...
});

// ...

Dart

يمكنك تحديد systemInstruction عند إنشاء مثيل LiveGenerativeModel.


// ...

// Specify the system instructions as part of creating the `liveGenerativeModel` instance
final liveModel = FirebaseAI.googleAI().liveGenerativeModel(
  model: 'GEMINI_LIVE_MODEL_NAME',
  systemInstruction: Content.system('You are a cat. Your name is Neko.'),
  // ...
);

// ...

Unity

يمكنك تحديد systemInstruction عند إنشاء مثيل LiveModel.


// ...

// Specify the system instructions as part of creating the `LiveModel` instance
var liveModel = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetLiveModel(
  modelName: "GEMINI_LIVE_MODEL_NAME",
  systemInstruction: ModelContent.Text("You are a cat. Your name is Neko."),
  // ...
);

// ...

أمثلة على تعليمات النظام

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

إنشاء الرموز البرمجية

  • تعليمات النظام:
    أنت خبير في البرمجة ومتخصّص في عرض الرموز لواجهات المستخدم الأمامية. عندما أصف أحد عناصر الموقع الإلكتروني الذي أريد إنشاءه، أرجو منك عرض رمزَي HTML وCSS اللازمَين لذلك، بدون تقديم شرح لهذا الرمز. قدِّم أيضًا بعض الاقتراحات بشأن تصميم واجهة المستخدم.

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

روبوت دردشة موسيقي

  • تعليمات النظام:
    يجب أن تكون إجاباتك بأسلوب مؤرخ موسيقي، وأن تُظهر معرفة شاملة بمختلف الأنواع الموسيقية، وأن تقدّم أمثلة ذات صلة. يجب أن تكون نبرتك إيجابية وحماسية، وأن تنشر الفرح من خلال الموسيقى. إذا كان السؤال غير مرتبط بالموسيقى، يجب أن يكون الردّ "لا أعرف إجابة هذا السؤال".

  • طلب المستخدم:
    إذا وُلد شخص في الستينيات، ما هو نوع الموسيقى الأكثر رواجًا في تلك الفترة؟ أدرِج خمس أغانٍ كنقاط تعداد.

إنشاء البيانات المنسَّقة

  • تعليمات النظام:
    أنت مساعد للطهاة المنزليين. ستتلقّى قائمة بالمكوّنات الغذائية، وستردّ بقائمة بالوصفات التي تستخدم هذه المكوّنات. يجب دائمًا إدراج الوصفات التي لا تتطلّب مكونات إضافية قبل الوصفات التي تتطلّب ذلك.

    يجب أن يكون ردّك عبارة عن عنصر JSON يحتوي على 3 وصفات. يتضمّن عنصر وصفة الطعام المخطط التالي:

    • name: اسم الوصفة
    • usedIngredients: المكوّنات في الوصفة التي تم توفيرها في القائمة
    • otherIngredients: مكوّنات الوصفة التي لم يتم توفيرها في القائمة (يتم حذفها إذا لم تكن هناك مكوّنات أخرى)
    • description: وصف موجز للوصفة، مكتوب بأسلوب إيجابي وكأنّه يهدف إلى الترويج لها
  • طلب المستخدم:

    • حقيبة واحدة من البروكلي المجمّد بوزن 1 رطل
    • 1 باينت من الكريمة الثقيلة
    • عبوة بوزن 1 رطل من أطراف وقطع الجبن

خيارات أخرى للتحكّم في إنشاء المحتوى

  • مزيد من المعلومات حول تصميم الطلبات لتتمكّن من التأثير في النموذج لإنشاء نتائج تتوافق مع احتياجاتك
  • اضبط مَعلمات النموذج للتحكّم في طريقة إنشاء النموذج للرد. بالنسبة إلى نماذج Gemini، تتضمّن هذه المَعلمات الحد الأقصى لعدد الرموز المميزة في الناتج، ودرجة العشوائية، وأعلى K كلمات محتملة، وأعلى احتمال تراكمي. بالنسبة إلى نماذج Imagen، تشمل هذه القيود نسبة العرض إلى الارتفاع، وإنشاء صور أشخاص، والعلامات المائية، وما إلى ذلك.
  • استخدِم إعدادات الأمان لتعديل احتمالية تلقّي ردود قد تُعتبر ضارة، بما في ذلك خطاب الكراهية والمحتوى الجنسي الفاضح.
  • مرِّر مخطط الردود مع الطلب لتحديد مخطط ناتج معيّن. تُستخدَم هذه الميزة بشكل شائع عند إنشاء مخرجات بتنسيق JSON، ولكن يمكن استخدامها أيضًا في مهام التصنيف (مثل عندما تريد أن يستخدم النموذج تصنيفات أو علامات معيّنة).