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

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

تتوفّر تعليمات النظام في جميع نماذج Gemini.

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


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

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

  • تحديد شخصية أو دور (لروبوت دردشة مثلاً)
  • تحديد تنسيق الناتج (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: وصف موجز للوصفة، مكتوب بشكل إيجابي كما لو كان لبيعها
  • طلب المستخدم:

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

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

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