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

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

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

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


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

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

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

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

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